Documentazione

Cline

Il provider OpenAI Compatible di Cline richiede un URL di base, una chiave e un ID modello. I campi dei prezzi sottostanti servono a calcolare il costo corrente di ogni attività, quindi vale la pena compilarli correttamente.

Il provider OpenAI Compatible di Cline accetta un URL di base, una chiave e un ID modello, oltre ai prezzi per modello usati per mostrare il costo corrente della sessione.

Impostazioni di Cline ⚙︎

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model ID       claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        (from the table below)
  Output Price       (from the table below)

Cline mostra il costo corrente durante l’esecuzione di un’attività e lo calcola usando Input Price e Output Price nel blocco di configurazione del modello: non legge le tariffe dall’endpoint. Se lasci i valori predefiniti, la stima sarà errata, in un senso o nell’altro a seconda dei valori impostati.

Mantieni /v1 nell’URL di base. Cline aggiunge solo il percorso, quindi https://api.kunavo.com restituisce 404 mentre https://api.kunavo.com/v1 funziona. Un errore 401 indica invece che l’URL è corretto, ma la chiave no.

Non hai ancora una chiave? Crea un account Kunavo, genera una chiave (inizia con sk-kn-) e aggiungi credito da $10: le chiamate vengono pagate con quel saldo e le chiamate non riuscite non vengono addebitate. La dashboard si apre quindi sulla configurazione Cline.

Passo dopo passo

Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
Apri il pannello delle impostazioni di Cline (l’icona ⚙︎) e seleziona OpenAI Compatible come provider API.
Inserisci l’URL di base, la chiave API e l’ID modello.
Espandi Model Configuration e imposta la finestra di contesto, il numero massimo di token in output, il supporto per le immagini e i prezzi di input e output.
Avvia un’attività. Plan e Act possono usare modelli diversi, quindi abbina un modello di pianificazione a uno più economico per l’esecuzione, invece di pagare la tariffa di pianificazione per ogni modifica.

Verificato rispetto a la pagina del provider OpenAI Compatible di Cline il 6 settembre 2026. Le impostazioni di terze parti cambiano; se il nome di un campo qui non corrisponde più a quello visualizzato, fa fede quella pagina, non questa.

Questa è la versione breve. La guida completa, con scelta del modello, costo di una sessione reale e modalità di errore, è in la guida passo passo a Cline + Claude.

Verifica prima di eseguire il debug del client

Una sola richiesta stabilisce se il problema riguarda l'endpoint, la chiave o il file di configurazione. Se restituisce JSON, lo stesso base URL e la stessa chiave funzionano in Cline.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quale model id inserire nel campo

Ogni modello di testo è raggiungibile come model id: l'elenco aggiornato è GET /v1/models e il catalogo con i prezzi è nella pagina dei modelli. Le tariffe sono in USD per 1M di token, input / output.

ID del modello	Kunavo ingresso / uscita	Dove si inserisce in Cline
`claude-sonnet-5`	$1.40 / $7.00	modalità Act: il modello di lavoro predefinito
`claude-opus-5`	$3.50 / $17.50	modalità Plan, in cui il piano determina il costo del resto dell’attività
`claude-haiku-4-5`	$0.70 / $3.50	letture a basso costo e ispezioni ripetute dei file
`gpt-5-6-terra`	$0.70 / $4.20	una famiglia diversa con la stessa chiave, per avere una seconda opinione

La fatturazione è per token, usando un saldo prepagato senza canone mensile: vedi billing. In presenza di contesto ripetuto, che costituisce la maggior parte di ciò che invia un editor o un client di chat, prompt caching incide sulla spesa più della scelta del modello.

Domande frequenti

Come si usa Cline con un’API personalizzata compatibile con OpenAI?

Nel pannello delle impostazioni di Cline, seleziona "OpenAI Compatible" come provider API, poi inserisci l’URL di base dell’endpoint, la chiave API e l’ID del modello desiderato. L’URL di base deve essere la radice /v1, perché Cline vi aggiunge solo il percorso. Cline comunica quindi con l’endpoint usando il formato OpenAI, indipendentemente dal fornitore che mette effettivamente a disposizione il modello.

Cline può usare modelli Claude senza una chiave API Anthropic?

Sì, quando i modelli sono disponibili tramite un endpoint compatibile con OpenAI. Cline inoltra l’ID modello senza modificarlo, quindi è l’endpoint, non l’estensione, a risolvere un ID Claude. L’unica credenziale conservata da Cline è quella dell’endpoint. È anche così che una sola chiave può coprire gli ID Claude e GPT nella stessa voce del provider.

Perché la stima dei costi di Cline è sbagliata?

Perché Cline lo calcola dai campi Input Price e Output Price nel blocco di configurazione del modello, inseriti manualmente e non recuperati dall’endpoint. Se vengono lasciati ai valori predefiniti o copiati da un altro provider, ogni indicazione dei costi eredita quell’errore. Inserisci le tariffe effettivamente applicate dall’endpoint per l’ID modello selezionato.

L’URL di base di Cline deve terminare con /v1?

Sì, per un endpoint compatibile con OpenAI. Cline aggiunge la route — /chat/completions — all’URL di base fornito, quindi https://api.example.com/v1 viene risolto correttamente, mentre https://api.example.com invia la richiesta a un percorso inesistente. Un 404 indica un problema con l’URL di base; un 401 indica un problema con la chiave.