Kilo Code + Gonka AI — agente AI in VS Code

Installazione di Kilo Code: in VS Code apri Estensioni (Ctrl+Shift+X), cerca «Kilo Code» e clicca Installa. Dopo l'installazione, l'icona di Kilo Code apparirà nella barra laterale. L'estensione è disponibile anche su Open VSX per build senza Marketplace.

Chiave API JoinGonka: se non hai ancora un account, registrati su gate.joingonka.ai/register, ottieni 10M token gratuiti e crea una chiave con il prefisso jg- nella Dashboard → API Keys. La stessa chiave funziona sia per il formato OpenAI (/v1) che per il formato Anthropic (/v1/messages) – il saldo è unico.

Apri il pannello Kilo Code e vai alle impostazioni del provider tramite l'icona dell'ingranaggio.

Metodo A — OpenAI Compatibile (consigliato). Nella versione moderna dell'estensione, apri Settings (ingranaggio) → scheda Providers → pulsante in basso Custom provider e compila il dialogo:

• ID provider: qualsiasi identificativo, ad esempio joingonka.
• Nome visualizzato: ad esempio JoinGonka Gonka.
• URL di base: https://gate.joingonka.ai/v1
• Chiave API: jg-la-tua-chiave
• Modelli: aggiungi Qwen/Qwen3-235B-A22B-Instruct-2507-FP8. Kilo recupera automaticamente l'elenco dei modelli dall'endpoint /v1/models – puoi scegliere un modello dall'elenco invece di inserirlo manualmente.

Clicca Submit – i modelli appariranno nel selettore. Nella vecchia interfaccia (VSCode Legacy) il percorso è più breve: API Provider → OpenAI Compatible, quindi i campi Base URL, API Key e Model con gli stessi valori.

Metodo B — Formato Anthropic. Il nostro gateway risponde anche all'API Anthropic. Seleziona API Provider → Anthropic, incolla la chiave jg-la-tua-chiave, spunta «Use custom base URL» e specifica https://gate.joingonka.ai (senza /v1 – Kilo aggiungerà automaticamente /v1/messages).

Modelli e i loro limiti di output (tutti e tre disponibili subito):

Nella finestra di dialogo del provider personalizzato, per ogni modello è possibile impostare Max Output Tokens e Context Window – imposta i valori dalla tabella per il modello selezionato.

Verifica: nella chat di Kilo Code in modalità Code scrivi «Crea un file hello.py con una funzione hello world». L'agente dovrebbe proporre un diff per l'approvazione e creare il file. Per impostazione predefinita, Kilo Code richiede una conferma prima di ogni azione – questo può essere attenuato consentendo l'esecuzione automatica per operazioni fidate.

Kilo Code è uno strumento agente: non si limita a rispondere, ma esegue compiti per intero – legge file, scrive codice, esegue test, corregge errori. Ogni passo è una chiamata API e i token si accumulano rapidamente. Confrontiamo il costo delle sessioni tipiche tramite Anthropic Claude e tramite il nostro gateway alla rete Gonka:

Tramite JoinGonka Gateway l'input costa circa $0.0005 per 1M token, l'output è circa tre volte più costoso – è centinaia e migliaia di volte più economico di Anthropic e OpenAI. Kilo Code diventa uno strumento quotidiano: può essere eseguito per ogni ticket, ogni bug e ogni funzionalità, senza preoccuparsi del conto. Con i prezzi di Anthropic bisogna ponderare ogni esecuzione.

Parametri del modello: il Qwen3-235B predefinito ha una finestra di contesto di 128K token e una lunghezza massima della risposta di 8192 token. Kilo Code può richiedere di più, ma il gateway limiterà l'output al limite superiore del modello (Qwen – 8192, Kimi K2.6 – 3072, MiniMax-M2.7 – 4096). Per generazioni lunghe l'agente divide il lavoro in passaggi.

Il punto di forza di Kilo Code sono le modalità (nella vecchia estensione chiamate modes, nella nuova agents), tra cui si passa con un menu a tendina, il comando /agents o la scorciatoia da tastiera Ctrl+.:

• Plan / Architect — per discutere e progettare una soluzione senza toccare i file. Comodo da eseguire tramite Qwen3-235B a basso costo: la pianificazione consuma molto contesto, e con il nostro gateway costa poco.
• Code — modalità predefinita: scrive e corregge codice, applica diff, esegue comandi.
• Debug — cerca miratamente la causa di un bug nei log e nello stack.
• Ask — risponde a domande sulla base di codice senza modifiche.

La modalità separata Orchestrator nelle versioni più recenti è stata dichiarata obsoleta: gli agenti con pieno accesso agli strumenti ora possono avviare sottotask (subagents) da soli, senza un orchestratore dedicato. Sono supportate anche modalità utente personalizzate per i tuoi scenari.

Tool calling: il nostro gateway inoltra il tool calling nativo di OpenAI function calling e Anthropic tool_use, e i modelli selezionati (Qwen3-235B, Kimi K2.6, MiniMax-M2.7) supportano la chiamata di strumenti. Ciò significa che il ciclo dell'agente di Kilo Code — lettura di file, modifica, esecuzione di comandi, indicizzazione della base di codice — funziona sui nostri modelli in modo affidabile, senza il fragile parsing delle risposte testuali.