Kilo Code con l'API Claude: configurazione del base URL (anche per Cline e Roo Code)

Kilo Code, Cline e Roo Code sono gli agenti di coding AI open source più utilizzati in VS Code — e tutti e tre accettano un endpoint compatibile con OpenAI personalizzato. Puoi quindi eseguire Claude nel tuo editor con una sola chiave sk-kn-, a circa 30 % in meno rispetto alla tariffa ufficiale Anthropic sui modelli principali. Questa guida fornisce la configurazione in tre campi per ogni strumento, il modello Claude da scegliere in base all'attività e il costo reale di una sessione di coding agentico.

Perché questi strumenti richiedono una chiave API

Kilo Code, Cline e Roo Code non incorporano un modello: ogni azione (leggere un file, proporre una modifica, eseguire un comando, verificare il risultato) è una chiamata API, fatturata per token. Un abbonamento chat come Claude Pro non copre questo utilizzo — serve un accesso API diretto. È esattamente ciò che offre Kunavo: pagamento a consumo a partire da una ricarica di $10, una chiave per Claude e GPT, un saldo che non scade mai e pagamento con carta di credito dalla Francia (i dettagli su IVA e GDPR sono nella guida all'API Claude in Francia). Poiché il ciclo agentico reinvia il contesto a ogni passaggio, la tariffa per token è la prima leva del costo di una sessione.

I tre campi (tutti gli strumenti)

Le tre estensioni condividono lo stesso modello di provider — Kilo Code e Roo Code sono fork della famiglia Cline — quindi la configurazione è identica:

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...          # à créer sur kunavo.com/app/keys
Model ID       claude-sonnet-5        # ou claude-opus-4-7 / claude-haiku-4-5

Crea la chiave nel dashboard dopo la registrazione e una ricarica di $10 — viene mostrata una sola volta, quindi salvala immediatamente.

Configurare Kilo Code

1. Installa Kilo Code dal marketplace di VS Code e aprilo nella barra laterale.
2. Apri le impostazioni dell'estensione (icona a forma di ingranaggio), sezione Providers.
3. Imposta API Provider su OpenAI Compatible.
4. Base URL: https://api.kunavo.com/v1 · chiave API: la tua sk-kn-… · modello: claude-sonnet-5.
5. Salva, quindi prova con una richiesta semplice (« spiega questo file ») prima di lasciarlo modificare il codice.

Kilo Code consente un modello diverso per modalità (Architect / Code / Debug) — utile per instradare la pianificazione verso un modello più potente e l'esecuzione verso uno più economico.

Configurare Cline

1. Installa Cline e apri il relativo pannello.
2. Fai clic sull'ingranaggio delle impostazioni e, sotto API Provider, scegli OpenAI Compatible.
3. Inserisci gli stessi tre valori: base URL https://api.kunavo.com/v1, la tua chiave e il model ID claude-sonnet-5.
4. Se Cline richiede i metadati del modello (finestra di contesto, limite dell'output), riprendi i valori dalla pagina del modello.

Configurare Roo Code

Identica alle altre due: Settings → Providers → API Provider → OpenAI Compatible, quindi base URL https://api.kunavo.com/v1, chiave e model ID. Anche il sistema di modalità di Roo Code (Code / Architect / Ask / Debug) accetta un modello per modalità.

I tre strumenti offrono anche un provider Anthropic nativo con un'opzione per una base URL personalizzata. Puntandolo a https://api.kunavo.com, passi attraverso l'API nativa Messages (/v1/messages) — interessante perché cache_control passa invariato e l'input memorizzato nella cache viene fatturato al 10% della tariffa dell'input (consulta la documentazione sul prompt caching). Entrambe le route funzionano; la route compatibile con OpenAI è la più semplice per iniziare.

Detto questo, il prompt caching in sé non dipende dalla route nativa. Con un prompt lungo, Kunavo colloca da sé i punti di interruzione della cache sulla route 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 che l'estensione colloca lì viene mantenuto. Sulla route nativa la richiesta viene inoltrata così come l'estensione l'ha inviata e non viene aggiunto alcun punto di interruzione: ciò che finisce nella cache dipende dai punti di interruzione che l'estensione colloca.

Quale modello Claude scegliere?

Il campo modello è solo uno slug sullo stesso endpoint: cambiare modello richiede una modifica di una parola — nessuna nuova chiave e nessun nuovo provider. Tutte le tariffe sono nella guida ai prezzi dell'API Claude e sulla pagina dei prezzi.

Il costo reale di una sessione

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

Il calcolo, eseguibile:

# Tarifs Claude sur Kunavo (USD par 1M de tokens) : (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
}

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

# Une étape agentique : l'outil renvoie le contexte + les fichiers lus.
print(cout_etape("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# Une tâche réaliste de 20 étapes (éditer, lancer, corriger, répéter) :
print(20 * cout_etape("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

Mantenere bassa la fattura

1. Apri nuove attività invece di allungare la stessa. Lo strumento reinvia l'intera conversazione a ogni passaggio: un'attività interminabile diventa quadraticamente costosa. Nuova attività = contesto breve.
2. Instrada per modalità. Kilo Code e Roo Code accettano un modello per modalità — Architect su claude-opus-4-7, Code su claude-sonnet-5, domande rapide su claude-haiku-4-5.
3. Usa la route Anthropic nativa per il caching. L'input memorizzato nella cache viene fatturato al 10% della tariffa — in un ciclo che reinvia un prefisso stabile a ogni passaggio, è il risparmio più consistente disponibile (come funziona).
4. Monitora la spesa per chiave. Dai all’editor la propria chiave con un limite di spesa in dashboard e verifica in utilizzo quanto costa davvero una settimana di programmazione agentica.

Domande frequenti