Kilo Code con l'API di Claude — URL di base, modelli e costi (anche Cline e Roo Code)

Kilo Code, Cline e Roo Code sono gli agenti di coding open source più usati all’interno di VS Code — e tutti e tre accettano un endpoint personalizzato compatibile con OpenAI. In altre parole: puoi eseguire Claude nel tuo editor con una sola chiave sk-kn-, a circa 30% sotto il listino ufficiale di Anthropic per i modelli principali. Questa guida illustra la configurazione in tre campi per ogni strumento, quale modello Claude scegliere per tipo di attività, il costo reale di una sessione di coding agentic e come pagare dal Brasile con Pix, senza una carta internazionale.

Perché questi strumenti richiedono una chiave API

Kilo Code, Cline e Roo Code non incorporano alcun modello: ogni azione (leggere un file, proporre una modifica, eseguire un comando, controllare il risultato) è una chiamata API addebitata per token. Un abbonamento chat come Claude Pro non copre questo accesso — serve accesso diretto all’API. È esattamente questo il ruolo di Kunavo: pay-as-you-go a partire da una ricarica di $10, una chiave per Claude e GPT, saldo che non scade mai e pagamenti dal Brasile con Pix o carta (il contesto completo su latenza, LGPD e fattura è nella guida all’API di Claude in Brasile). Poiché il ciclo agentic reinvia il contesto a ogni passaggio, la tariffa per token è la prima leva sul costo di una sessione.

I tre campi (vale per tutti e tre 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-...          # criada em kunavo.com/app/keys
Model ID       claude-sonnet-5        # ou claude-opus-5 / claude-haiku-4-5

Crea la chiave nella dashboard dopo esserti registrato e aver ricaricato $10 — viene mostrata una sola volta, quindi salvala subito.

Configurare Kilo Code

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

Kilo Code consente un modello diverso per modalità (Architect / Code / Debug): è utile per affidare la pianificazione a un modello più potente e l'esecuzione a uno più economico.

Configurare Cline

1. Installa Cline e apri il relativo pannello.
2. Fai clic sull'ingranaggio delle impostazioni e, in 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 massimo dell'output), usa i numeri della pagina del modello.

Configurare Roo Code

È identico agli altri due: Settings → Providers → API Provider → OpenAI Compatible, poi 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 opzione per una base URL personalizzata. Puntando a https://api.kunavo.com, passi attraverso l'API nativa Messages (/v1/messages): è interessante perché cache_control passa direttamente e l'input memorizzato nella cache viene addebitato al 10% della tariffa di input (consulta la documentazione sul prompt caching). Entrambe le route funzionano; quella compatibile con OpenAI è la più semplice per iniziare.

Ma il prompt caching in sé non dipende dalla route nativa. Con un prompt lungo, Kunavo imposta 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 impostato dall'estensione su quella route viene mantenuto. Sulla route nativa 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.

Pagare dal Brasile — Pix, senza carta internazionale

Il problema che blocca la maggior parte degli sviluppatori brasiliani non è la configurazione, ma il pagamento: addebitare direttamente l'API Anthropic richiede una carta di credito internazionale abilitata agli acquisti all'estero. In Kunavo il pagamento viene elaborato da Stripe e Pix compare come metodo di pagamento per chi paga dal Brasile: importo mostrato in real, accredito immediato, senza dipendere da una carta internazionale. Funzionano normalmente anche le carte internazionali (Visa, Mastercard, American Express), Apple Pay, Google Pay e Link.

Le tariffe per token sono definite in USD: con Pix (e con la carta, quando il checkout viene mostrato in real) Stripe mostra la conversione in real prima della conferma; questo tasso include un costo di cambio del 2–4% a carico dell'acquirente. Se scegli di pagare con la carta in dollari, questo costo scompare e la conversione segue il tasso dell'emittente (controlla IOF e la commissione per le transazioni internazionali nell'app della tua banca) — la ricarica tramite Pix, passo dopo passo, è descritta nella guida su come pagare l'API con Pix. È un portafoglio prepagato: ricarica minima di $10, senza canone mensile, e il saldo non scade mai; quindi un mese senza programmare non costa nulla, a differenza di un abbonamento.

Quale modello Claude scegliere?

Il campo del modello è solo uno slug sullo stesso endpoint: cambiare modello significa cambiare una parola, senza una nuova chiave né un nuovo provider. Le tariffe complete sono nella guida ai prezzi dell'API Claude e nella pagina dei prezzi.

Il costo reale di una sessione

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

In altre parole: una ricarica di $10 tramite Pix copre circa 11 attività agentic di 20 passaggi su Sonnet 5. Per fare il calcolo autonomamente:

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

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

# Um passo do agente: a ferramenta reenvia o contexto + os arquivos lidos.
print(custo_passo("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# Uma tarefa realista de 20 passos (editar, rodar, corrigir, repetir):
print(20 * custo_passo("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

Il portoghese consuma circa il 10–20% di token in più rispetto all'inglese per lo stesso contenuto: vale la pena tenerne conto quando il prompt e i commenti del codice sono in portoghese.

Come 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 costa in modo quadratico. Nuova attività = contesto breve.
2. Instrada per modalità. Kilo Code e Roo Code accettano un modello per modalità: Architect su claude-opus-5, 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 addebitato al 10% della tariffa; in un ciclo che reinvia un prefisso stabile a ogni passaggio, è il maggiore risparmio disponibile (come funziona).
4. Monitora la spesa per chiave. Assegna all'editor una chiave propria con un limite di spesa nel dashboard e verifica nel pannello di utilizzo quanto costa davvero una settimana di programmazione agentic.

Domande frequenti