Documentazione

Kilo Code

Il provider personalizzato di Kilo Code richiede quattro campi. Inseriscili e l'estensione potrà usare Claude e GPT con un'unica chiave, senza sapere quale fornitore si trovi dietro l'endpoint.

Providers → Custom provider → OpenAI Compatible, URL di base con /v1 e ID del modello Claude inserito — Kilo Code non saprà mai quale fornitore vi sia dietro.

Settings → Providers → Custom provider

Provider ID    kunavo
Display name   Kunavo
Provider API   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API key        sk-kn-...
Models         claude-sonnet-5
               claude-opus-5
               claude-haiku-4-5

L'URL di base mantiene qui il suffisso /v1: Kilo Code aggiunge solo il percorso e il suo esempio documentato termina con /v1. È il contrario dei client in stile Anthropic, che richiedono l'origine senza suffisso.

Provider API è un selettore di protocollo, non di fornitore. Scegliere OpenAI Compatible e poi inserire un ID modello Claude è la combinazione prevista: l'ID viene risolto all'endpoint, non nell'estensione.

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 Kilo Code.

Passo dopo passo

Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
Apri le impostazioni di Kilo Code (l'icona a forma di ingranaggio), vai alla scheda Providers, scorri fino in fondo e fai clic su Custom provider.
Compila Provider ID, Display name, Provider API = OpenAI Compatible, Base URL e API key come indicato sopra.
In Models, aggiungi gli ID manualmente oppure scegli quelli dall'elenco recuperato automaticamente: Kunavo risponde a GET /v1/models, quindi l'elenco si popola da solo.
Seleziona il provider nel selettore della modalità chat e invia un messaggio. Assegna un modello economico alle modalità usate continuamente e uno costoso a quelle che pianificano.

Verificato rispetto a Pagina del provider OpenAI Compatible di Kilo Code 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 introduttiva a Kilo Code + 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 Kilo Code.

# 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 Kilo Code
`claude-sonnet-5`	$1.40 / $7.00	Modalità Code e Architect: il modello di lavoro predefinito
`claude-opus-5`	$3.50 / $17.50	Modalità Architect per le grandi rifattorizzazioni, in cui un piano errato costa caro
`claude-haiku-4-5`	$0.70 / $3.50	Modalità Ask e rapida analisi dei file, dove conta soprattutto il volume
`gpt-5-6-sol`	$2.00 / $12.00	un secondo parere da una famiglia diversa, con la stessa chiave

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 aggiungo un provider personalizzato a Kilo Code?

Apri le impostazioni di Kilo Code con l'icona a forma di ingranaggio, vai alla scheda Providers, scorri fino in fondo all'elenco e fai clic su "Custom provider". Inserisci un Provider ID e un Display name, imposta Provider API su "OpenAI Compatible", incolla l'URL di base e la chiave API dell'endpoint, quindi aggiungi gli ID dei modelli manualmente o dall'elenco recuperato automaticamente. Il provider apparirà nel selettore delle modalità come uno qualsiasi di quelli integrati.

Kilo Code può usare modelli Claude senza un account Anthropic?

Sì. Il campo Provider API "OpenAI Compatible" di Kilo Code indica il protocollo di comunicazione, non il fornitore, e inoltra l'ID del modello direttamente all'URL di base configurato. Un ID Claude viene quindi risolto a quell'endpoint, non nell'estensione: le credenziali da usare sono quelle dell'endpoint, non quelle Anthropic.

L'URL di base di Kilo Code deve terminare con /v1?

Sì, per un endpoint compatibile con OpenAI. Kilo Code aggiunge solo il percorso — /chat/completions, /models — quindi l'URL di base deve essere la radice /v1, ad esempio https://api.kunavo.com/v1. Anche l'esempio documentato da Kilo Code riporta lo stesso suffisso. Se manca /v1, si ottiene un 404 anziché un errore di autenticazione.

Perché Kilo Code non mostra modelli dopo che aggiungo un provider?

L'elenco dei modelli viene recuperato dal percorso /v1/models dell'endpoint usando la chiave inserita, quindi un elenco vuoto di solito indica che la chiave o l'URL di base non sono corretti, non che il provider non abbia modelli. Prova la stessa coppia con un semplice curl verso /v1/models: se ricevi JSON, il problema è nella configurazione dell'estensione; un 401 indica un problema con la chiave, un 404 con l'URL. Puoi sempre inserire i modelli manualmente.