Cline con l'API Claude: configurazione del base URL, instradamento dei modelli Plan/Act e costi reali

Cline è un agente di coding autonomo open source per VS Code e non include un modello — devi collegarlo a uno, di solito con la tua chiave API. Questa guida mostra le impostazioni esatte per eseguire Claude in Cline tramite una chiave sk-kn- a circa il 30% in meno rispetto al prezzo di listino di Anthropic sui modelli principali: entrambi i percorsi del provider, come sfruttare la modalità Plan/Act per ridurre il conto, quanto costa una sessione reale e cosa rinunci a ottenere rispetto a una chiamata diretta ad Anthropic.

Perché Cline richiede una chiave API

Ogni azione eseguita da Cline — leggere un file, proporre una differenza, eseguire un comando nel terminale, leggere l'output e riprovare — è una chiamata al modello. Cline può eseguire queste chiamate con un abbonamento Claude Pro o Max tramite il provider Claude Code, che utilizza la CLI di Claude e i limiti del tuo abbonamento invece della fatturazione API — con i compromessi indicati nella documentazione di Cline a settembre 2026: le risposte potrebbero non essere trasmesse token per token e il caricamento delle immagini e il caching dei prompt sono limitati in quella modalità. Tutti gli altri percorsi, inclusi i provider OpenAI Compatible e Anthropic configurati in questa guida, vengono fatturati per token tramite una chiave API. Su questi percorsi la domanda non è se pagare per token, ma a quale tariffa; poiché un ciclo agentico reinvia il contesto crescente dell'attività a ogni passaggio, la tariffa per token è la leva singola più importante sul costo di una sessione. Questo è l'intero motivo per usare qui un gateway: pagare a consumo a partire da una ricarica di $10, una sola chiave che raggiunge anche GPT e un saldo che non scade mai.

Configurazione — i tre campi

Apri il pannello di Cline, fai clic sull'ingranaggio delle impostazioni e imposta il provider API su OpenAI Compatible. Tre valori:

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...              # create at kunavo.com/app/keys
Model ID       claude-sonnet-5        # or claude-opus-5 / claude-haiku-4-5

Crea la chiave nella dashboard dopo esserti registrato e aver effettuato una ricarica — viene mostrata una sola volta, quindi conservala immediatamente. La gestione delle chiavi, la rotazione e i limiti di spesa sono descritti nella documentazione sulla chiave API Claude. Se Cline richiede metadati del modello, come la finestra di contesto o il limite di output, usa i numeri della pagina del modello invece di indovinare — una finestra di contesto indicata al ribasso fa troncare Cline prima del necessario.

Prima di consentirgli di modificare qualcosa, chiedigli qualcosa di semplice («spiega questo file») per verificare il collegamento. Un 401 a questo punto indica quasi sempre la chiave; un 404 indica quasi sempre l'URL di base o uno slug del modello inesistente — Kunavo corrisponde esattamente agli slug e non crea alias per i nomi con suffisso di data, quindi claude-sonnet-4-5-20250929 restituisce 404 mentre claude-sonnet-4-6 viene risolto.

Modalità Plan e modalità Act — la suddivisione più economica

La caratteristica distintiva di Cline è separare Plan (leggere il codebase, fare domande, proporre un approccio) da Act (apportare modifiche, eseguire comandi), consentendo di configurare un modello diverso per ciascuna. Questo si adatta quasi perfettamente ai costi, perché le due modalità hanno profili di token molto diversi:

• Plan è breve e incentrata sul ragionamento. Una manciata di turni in cui la qualità del modello determina se i venti passaggi successivi saranno produttivi o sprecati. Inserisci qui claude-opus-5 — rappresenta una piccola quota dei token, quindi il modello più forte costa poco in termini assoluti.
• Act è lunga e meccanica. Molti passaggi, ciascuno con il reinvio del contesto. È qui che la tariffa per token si accumula, quindi qui appartiene il Sonnet più economico — claude-sonnet-5 su Kunavo oggi.

I numeri dell'esempio sono nella sezione sui costi qui sotto: pianificare tre passaggi su Opus 5 ed eseguirne diciassette su Sonnet 5 costa circa $1,06 contro $0,87 per un'esecuzione interamente su Sonnet — circa il 23% in più per una pianificazione sostanzialmente migliore e molto meno che eseguire l'intera attività su Opus.

La rotta Anthropic nativa (e perché potresti volerla)

Cline include anche un provider Anthropic nativo con un campo per l'URL di base personalizzato. Indirizzarlo a Kunavo utilizza l'API nativa Messages API (/v1/messages) invece dell'endpoint compatibile con OpenAI:

API Provider   Anthropic
Base URL       https://api.kunavo.com   # origin only — the client appends /v1/messages
API Key        sk-kn-...
Model ID       claude-sonnet-5

Nota che l'URL di base è diverso tra i due percorsi. Il provider compatibile con OpenAI richiede https://api.kunavo.com/v1; il provider Anthropic richiede l'origine nuda https://api.kunavo.com, perché quel client aggiunge autonomamente /v1/messages. Incollare la forma /v1 nel provider Anthropic produce un 404 che sembra indicare un modello mancante.

Il vantaggio del percorso nativo è il caching dei prompt: cache_control viene trasmesso senza traduzione e l'input memorizzato viene fatturato al 10% della tariffa di input (consulta la documentazione sul caching dei prompt). In un ciclo che reinvia un prefisso stabile a ogni passaggio, questo è il risparmio maggiore disponibile — superiore a qualsiasi sostituzione del modello. Entrambi i percorsi funzionano; quello compatibile con OpenAI è più semplice per iniziare e il passaggio successivo richiede solo una modifica nelle impostazioni.

Il caching dei prompt in sé, però, non richiede il percorso nativo. Con un prompt lungo, Kunavo imposta da sé i punti di interruzione della cache sul percorso compatibile con OpenAI: sul prompt di sistema, sulle definizioni degli strumenti e sull'ultimo messaggio non appena la conversazione contiene un turno dell'assistente, cioè, in un ciclo agentico, a ogni passaggio dopo il primo. Un cache_control impostato da Cline su quel percorso viene mantenuto. Sul percorso nativo la richiesta viene inoltrata così come Cline l'ha inviata e non viene aggiunto alcun punto di interruzione, quindi ciò che finisce nella cache dipende dai punti di interruzione impostati da Cline.

Quale modello Claude impostare

Il passaggio richiede una sola parola nel campo del modello — stessa chiave, stessa configurazione del provider, stesso endpoint. Le tariffe complete per modello rispetto al listino ufficiale di Anthropic sono nella lista dei prezzi dell'API Anthropic Claude, mentre il catalogo aggiornato è disponibile nella pagina dei prezzi.

Cline su Kunavo rispetto alle chiamate dirette ad Anthropic

Il confronto onesto, compresi i casi in cui chiamare direttamente è la scelta migliore:

Leggi quella riga sulla capacità esattamente come è scritta. Se il tuo team necessita di una quota garantita, di uno SLA contrattuale o di un rapporto di approvvigionamento con il fornitore del modello, rivolgiti direttamente al fornitore — è per questo che paghi la differenza. Per uno sviluppatore individuale o un piccolo team che esegue Cline, il compromesso di solito è l'opposto.

Quanto costa realmente una sessione Cline

Gli strumenti agentici consumano molti token per progettazione: ogni passaggio reinvia il prompt di sistema, la cronologia dell’attività e il nuovo contesto dei file. Numeri realistici alle tariffe Kunavo:

Il calcolo, eseguibile:

# Kunavo Claude rates (USD per 1M tokens): (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
    "claude-opus-5":     (3.50, 17.50),
}

def step_cost(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# One Act-mode step: Cline resends the task context plus the files it read.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, read the error, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# The same task planned on Opus 5, executed on Sonnet 5:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

Ridurre la fattura

1. Avvia nuove attività invece di estenderne una all'infinito. Cline reinvia l'intera conversazione a ogni passaggio, quindi un'attività di lunga durata cresce quadraticamente in termini di costo. Un'attività nuova ha un contesto nuovo e ridotto — è l'abitudine con il maggiore impatto nell'elenco.
2. Suddividi Plan e Act tra modelli. Come descritto sopra: è un campo delle impostazioni, non un problema di disciplina.
3. Usa la rotta Anthropic nativa per il caching. L'input memorizzato nella cache al 10% della tariffa di input è il maggiore risparmio strutturale in un ciclo che reinvia un prefisso stabile.
4. Assegna all'editor una chiave con limite di spesa dedicato. Crea una chiave separata nella dashboard, imposta un limite mensile di spesa e controlla l'utilizzo — una settimana di coding agentico reale è l'unica stima onesta del costo per te. Il limite viene verificato prima di ogni richiesta e si azzera con il mese di calendario; la chiave può essere revocata autonomamente, quindi fermare l'editor richiede una sola azione invece di ruotare tutto.
5. Stai ancora scegliendo tra i due strumenti? Cline vs Claude Code confronta le modalità di fatturazione invece degli elenchi di funzionalità — ed entrambi usano questo stesso endpoint, quindi la scelta resta reversibile.

Domande frequenti