Cline

Agente di programmazione open source per VS Code che usa l'API compatibile con OpenAI di OneProvider.

Agente di programmazione Cline per VS Code

Cosa funziona

Cline invia a OneProvider richieste di testo e di agente di programmazione compatibili con OpenAI, con l'ID di un modello compatibile scelto dal catalogo.

Limite del client

Le capacità di immagini, uso degli strumenti e contesto dipendono dal modello esatto selezionato; verifica prima con un piccolo compito di testo.

Configurazione

1. Scegli OpenAI Compatible

   Nelle impostazioni API Provider di Cline scegli OpenAI Compatible e incolla la tua chiave OneProvider.

   API Provider: OpenAI Compatible
   API Key: sk-your-key-here

2. Imposta la base URL personalizzata

   Imposta la base URL su https://api.oneprovider.dev/v1 e l'ID esatto del modello su gpt-6.1-terra.

   Base URL: https://api.oneprovider.dev/v1
   Model ID: gpt-6.1-terra

3. Avvia un piccolo compito di testo

   Apri una nuova sessione di Cline e chiedi una piccola spiegazione di sola lettura prima di abilitare le capacità specifiche del modello.

Verifica la connessione

Controlla la richiesta in «Consumo» nella Dashboard

La richiesta dovrebbe mostrare il modello configurato e una riga di consumo compatibile con OpenAI già contabilizzata.

Dati di connessione

Protocollo

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Sicurezza della chiave

Usa una chiave dedicata con limiti su modelli, frequenza, spesa e scadenza; non committare mai la chiave nelle impostazioni dell'area di lavoro.

Quale modello scegliere

Cline usa il provider OpenAI Compatible, quindi inserisci l'ID del modello esattamente come nel catalogo . gpt-6.1-terra è una scelta predefinita bilanciata per i compiti di programmazione, gpt-6.1-sol è adatto a lavori ampi su più file, gpt-5.6-luna è economico per domande rapide. Gli ID Claude funzionano anche con lo stesso provider, per esempio claude-sonnet-5-5. Input di immagini, uso degli strumenti e dimensione del contesto dipendono dal modello esatto, quindi comincia con un piccolo compito di sola lettura. Se Cline chiede una finestra di contesto o un output massimo, copia i valori dalla riga del modello nel catalogo.

Errori comuni e soluzioni

404 o «Invalid URL»

La base URL deve essere https://api.oneprovider.dev/v1: con /v1, senza /chat/completions.

401 Unauthorized

Alla chiave manca un carattere o c'è uno spazio o una virgoletta intorno, oppure il saldo è a zero. Incolla di nuovo la chiave intera e controlla l'area personale.

«Model not found» o un 400 sul modello

L'ID ha un errore di battitura o non è nel catalogo. Copialo dalla pagina dei modelli; la corrispondenza è esatta e distingue maiuscole e minuscole.

429 «Insufficient balance»

Il saldo o il limite di spesa della chiave è esaurito. Riprovare non serve: ricarica o alza il limite.

L'agente si ferma dopo un passaggio

Il modello selezionato potrebbe non supportare bene le chiamate di strumenti. Scegli un modello di punta o bilanciato e mantieni il compito piccolo.

Gli stream si interrompono o si bloccano

Disattiva le VPN o i proxy VLESS: mettono in buffer l'SSE. OneProvider non lo fa.

FAQ

Quale provider scelgo in Cline?

OpenAI Compatible. Incolla la chiave OneProvider e la base URL indicata sopra.

Posso usare i modelli Claude in Cline?

Sì: inserisci un ID Claude nello stesso provider OpenAI Compatible, oppure usa il provider Anthropic di Cline con la base URL personalizzata https://api.oneprovider.dev, se la tua versione la offre.

La mia chiave viene salvata nel repository?

No, Cline la conserva nell'archivio dei segreti di VS Code. Usa comunque una chiave dedicata con un limite di spesa e non committarla mai nelle impostazioni dell'area di lavoro.

Dove vedo il consumo?

Nella pagina «Consumo» della Dashboard: ogni richiesta mostra il modello e l'importo addebitato.

Risposte rapide

Quale base URL devo usare?

Claude Code e gli SDK Anthropic usano https://api.oneprovider.dev. Gli SDK OpenAI e i client compatibili con OpenAI usano https://api.oneprovider.dev/v1. Con una sola chiave funzionano entrambi; l'elenco dei modelli è nella pagina dei modelli , le tariffe nella pagina dei prezzi .

Come mi autentico?

Invia la chiave sk-… così com'è in x-api-key oppure in Authorization: Bearer: uno dei due, mai entrambi. Tieni la chiave in una variabile d'ambiente, non in un file che finisce nel commit. Altro sull'autenticazione .

Dove ottengo una chiave?

Apri la tua area personale nel bot Telegram @oneprovider_robot oppure su app.oneprovider.dev, ricarica il saldo e premi «Emetti una chiave». Ogni chiave può avere un proprio limite di spesa. Area personale e chiavi API .

Cosa significano 401, 404 e 429?

401: la chiave manca, è scritta male o è inviata nell'header sbagliato; incolla la chiave intera, senza virgolette né spazi. 404: di solito la base URL è sbagliata, per esempio manca /v1 o è doppio. 429 con “Insufficient balance”: il saldo dell'area personale o il limite di spesa della chiave è esaurito, quindi ricarica invece di riprovare; qualsiasi altro 429 è un limite di frequenza, quindi attendi il tempo indicato in Retry-After. Dettagli: codici di errore e risoluzione dei problemi .

Perché gli stream si interrompono o si resettano?

VPN e proxy VLESS spesso mettono in buffer gli SSE o rompono la negoziazione HTTP/2. OneProvider non ha restrizioni regionali e non mette in buffer gli stream: disattiva il proxy e riprova.

Dove chiedo se non basta?

Scrivi a @Oneproviderhelpbot su Telegram oppure apri «Assistenza» nell'area personale sul sito, indicando il codice di stato HTTP e il testo esatto dell'errore. Come funziona l'assistenza .