Vai al contenuto principale
Kilo Code è un agente di coding IA open source disponibile in VS Code, JetBrains, CLI, Slack e Cloud. Si connette a OrcaRouter tramite il suo Custom provider (provider personalizzato) (un endpoint compatibile con OpenAI). Questa guida copre sia l’estensione VS Code (il modo più comune per usare Kilo Code) sia la CLI (@kilocode/cli, per l’uso headless).
Protocollo: compatibile con OpenAI
  • Base URL: https://api.orcarouter.ai/v1 (include /v1)
  • Gli ID dei modelli usano il formato vendor/model — il più semplice è orcarouter/auto

​
Estensione VS Code

  1. Installa Kilo Code dal VS Code Marketplace (apri il pannello Extensions e cerca “Kilo Code”), quindi aprilo dall’icona Kilo Code nella Activity Bar (la barra di icone a sinistra). Nel pannello, fai clic sull’ingranaggio ⚙ in alto a destra per aprire le impostazioni.
Il pannello di Kilo Code con l'ingranaggio delle impostazioni evidenziato
  1. Vai su Providers (provider). In Popular providers (provider più diffusi), trova Custom provider (provider personalizzato) (“Add an OpenAI-compatible provider by base URL”) e fai clic su + Connect.
La voce Custom provider nelle impostazioni Providers di Kilo Code
  1. Compila i campi del provider:
    • Provider ID: orcarouter (solo lettere minuscole, numeri, trattini o trattini bassi — niente barre; qui orcarouter/auto viene rifiutato).
    • Display name: OrcaRouter (quello che preferisci).
    • Base URL: https://api.orcarouter.ai/v1
    • API key: la tua chiave OrcaRouter (sk-orca-...).
Provider ID, base URL e API key di OrcaRouter in Kilo Code
  1. Scegli i tuoi modelli. Una volta che la chiave e il base URL sono validi, Kilo Code recupera l’elenco aggiornato dei modelli da OrcaRouter — spunta quelli che vuoi (oppure Select all), poi fai clic su Submit. Per usare l’instradamento automatico, aggiungi anche un modello con + Add model indicando come ID del modello orcarouter/auto (è un alias di instradamento, quindi non comparirà nell’elenco recuperato).
Il selettore di modelli di Kilo Code che mostra i modelli recuperati da OrcaRouter
  1. Il provider ora compare in Connected providers (provider connessi) come OrcaRouter (CUSTOM).
OrcaRouter elencato in Connected providers in Kilo Code
  1. Seleziona il modello OrcaRouter nel selettore di modelli del pannello di chat e invia un messaggio di prova — una risposta conferma la connessione.
Kilo Code che risponde tramite OrcaRouter
Su un repository di grandi dimensioni, Kilo Code potrebbe chiederti prima se attendere l’inizializzazione del suo sistema di snapshot — scegli Disable for this project (disattiva per questo progetto) per saltarlo (git continua comunque a tracciare tutto), così la richiesta va a buon fine.
Il plugin JetBrains usa lo stesso Custom provider (provider personalizzato) con gli stessi identici valori di base URL / chiave / modello.

​
CLI

Per l’uso headless / da script, installa la CLI.

​
Installazione

npm install -g @kilocode/cli
Il comando è kilo.

​
Configurazione

File di configurazione: ~/.config/kilo/kilo.jsonc (accetta anche kilo.json; un ./kilo.jsonc a livello di progetto ha la precedenza). 
{
  "$schema": "https://app.kilo.ai/config.json",
  "provider": {
    "orcarouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OrcaRouter",
      "options": { "baseURL": "https://api.orcarouter.ai/v1", "apiKey": "sk-orca-..." },
      "models": { "orcarouter/auto": { "name": "OrcaRouter Auto" } }
    }
  },
  "model": "orcarouter/orcarouter/auto"
}
Sostituisci con un modello specifico se preferisci, ad es. anthropic/claude-opus-4.8 o google/gemini-2.5-flash. Gli ID dei modelli usano il formato vendor/model.

​
Esecuzione

echo "Reply with exactly: OK" | kilo run --auto --format json
Atteso: un evento JSON con "type":"text" e "text":"OK".

​
Note

  • Il base_url include /v1.
  • I riferimenti ai modelli usano provider/model. Poiché il provider è chiamato orcarouter e l’ID del modello porta anch’esso un prefisso vendor, il riferimento è composto da tre segmenti: orcarouter/orcarouter/auto (oppure orcarouter/anthropic/claude-opus-4.8).
  • La modalità headless è kilo run "<prompt>" --auto (oppure invia il prompt tramite stdin). --format json fornisce uno stream di eventi leggibile dalla macchina.
  • Reasoning/thinking: usa il flag --variant <name> per l’effort di reasoning specifico del provider (ad es. high, max, minimal), e --thinking per visualizzare i blocchi di thinking.
Problema noto: --auto ha segnalato casi di blocco dopo il completamento / quando la chiave è mancante (issue di kilocode). Avvolgilo con un timeout in CI e assicurati che la chiave sia caricata.