Kilo Code con l'API Claude — configurazione del base URL compatibile con OpenAI e routing per modalità

Kilo Code è uno degli agenti di programmazione AI open source più utilizzati per VS Code e, come i suoi fratelli della famiglia Cline, consente di usare il proprio endpoint API compatibile con OpenAI. Ciò significa che puoi eseguire Claude nel tuo editor con una sola chiave sk-kn-, a circa il 30% in meno rispetto al listino Anthropic sui modelli principali. Questa guida illustra la configurazione dei tre campi, quale modello Claude scegliere per ogni attività e quanto costa realmente una sessione di programmazione agentica.

Perché Kilo Code richiede una chiave API

Kilo Code non include 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; l’estensione richiede l’accesso API diretto. È esattamente il modello offerto da Kunavo: pay-as-you-go a partire da una ricarica di $10, una chiave per Claude e GPT e saldo senza scadenza. Poiché i cicli agentici reinviano il contesto crescente dell’attività a ogni passaggio, la tariffa per token è il principale fattore che determina il costo di una sessione — ed è per questo che lo sconto di circa il 30% su claude-sonnet-5 si accumula rapidamente.

I tre campi

Kilo Code espone il provider come tre campi nelle impostazioni:

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

Ottieni la chiave dalla dashboard dopo esserti registrato e aver ricaricato $10 — viene mostrata una sola volta, quindi conservala subito. La gestione completa delle chiavi è descritta nella documentazione sulla chiave API Claude.

Configurazione di Kilo Code

1. Installa Kilo Code dal marketplace di VS Code e aprilo dalla barra laterale.
2. Apri le impostazioni dell’estensione (icona a forma di ingranaggio) e vai alla sezione Providers.
3. Imposta API Provider su OpenAI Compatible.
4. Base URL: https://api.kunavo.com/v1 · API key: la tua chiave sk-kn-… · Model: claude-sonnet-5.
5. Salva, quindi chiedigli qualcosa di semplice (“spiega questo file”) per confermare il collegamento prima di consentirgli di modificare il codice.

Kilo Code supporta override del modello per modalità (Architect / Code / Debug) — un buon punto per indirizzare la pianificazione a un modello più potente (claude-opus-5) e l’esecuzione a uno più economico (claude-sonnet-5).

Cline e Roo Code

Kilo Code e Roo Code sono entrambi fork della famiglia Cline, quindi i tre campi precedenti sono identici in tutti e tre gli strumenti — provider OpenAI Compatible, base URL https://api.kunavo.com/v1, chiave, ID modello. Ciò che cambia è la funzione che ciascuno offre per instradare i modelli, ed è lì che si trovano i risparmi; per questo ciascuno ha la propria guida: Cline con l’API Claude tratta la separazione Plan/Act, mentre Roo Code con l’API Claude tratta i profili di configurazione denominati e l’associazione del modello per modalità.

Tutti e tre gli strumenti includono inoltre un provider nativo Anthropic con un’opzione di base URL personalizzata. Indirizzandolo a https://api.kunavo.com viene utilizzata invece la Messages API nativa (/v1/messages) — utile perché cache_control viene trasmesso senza traduzione e l’input memorizzato nella cache viene fatturato al 10% della tariffa di input (consulta la documentazione sul prompt caching). Entrambi i percorsi funzionano; quello compatibile con OpenAI è il più semplice per iniziare.

Il prompt caching 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 dall’estensione su quel percorso viene mantenuto. Sul percorso nativo la richiesta viene inoltrata così come l’estensione l’ha inviata e non viene aggiunto alcun punto di interruzione, quindi ciò che finisce nella cache dipende dai punti di interruzione impostati dall’estensione.

Quale modello Claude scegliere

claude-opus-5 è la scelta per il ragionamento avanzato: è l’Opus più recente di Anthropic e viene fatturato alla stessa tariffa $3,50 / $17,50 del claude-opus-4-7 della generazione precedente ($3,50 / $17,50), che rimane disponibile se lo hai fissato. Poiché il campo del modello è solo uno slug sullo stesso endpoint, il passaggio richiede una modifica di una sola parola — nessuna nuova chiave e nessuna nuova configurazione del provider. Le tariffe complete per ogni modello sono nella guida ai prezzi dell’API Claude e nella pagina dei prezzi.

Quanto costa realmente una sessione

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),
}

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 agentic step: the tool resends the task context + file reads.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

Ridurre la fattura

1. Avvia nuove attività invece di estenderne una all’infinito. Lo strumento reinvia l’intera conversazione a ogni passaggio, quindi un’attività di lunga durata ha un costo quadratico. Attività nuova = contesto nuovo e ridotto.
2. Instrada per modalità. Kilo Code supporta un modello per modalità — Architect su claude-opus-5, Code su claude-sonnet-5, domande rapide su claude-haiku-4-5. La pianificazione rappresenta una piccola parte dei token, quindi il modello più potente usato lì costa poco.
3. Usa il percorso Anthropic nativo per la cache. L’input memorizzato nella cache viene fatturato al 10% della tariffa di input — in un ciclo che reinvia un prefisso stabile a ogni passaggio, questo è il maggiore risparmio disponibile (come funziona).
4. Controlla la spesa per chiave. Assegna all’editor una chiave propria con un limite di spesa nella dashboard e controlla l’utilizzo per sapere quanto ti costa realmente una settimana di programmazione agentica.

Domande frequenti