Sezioni dell'archivio conoscenza ▾

Navigazione

▸ Inizia qui Per ruolo

Categorie

Strumenti 32
Glossario 12

Strumenti

Kilo Code + Gonka AI — agente AI in VS Code

Kilo Code è un'estensione agente AI open-source per VS Code che scrive e modifica codice autonomamente, esegue comandi nel terminale, legge e corregge dozzine di file contemporaneamente. Il progetto ha unito i punti di forza di Cline e Roo Code e si sta evolvendo come piattaforma agente unificata: oltre all'estensione IDE esistono varianti per JetBrains e CLI. Una caratteristica chiave sono le modalità (agents): Code (scrive codice), Plan (alias Architect – pianifica l'architettura senza modifiche), Debug (cerca le cause degli errori) e Ask (risponde a domande sul progetto). È anche possibile creare le proprie modalità.

Il problema è lo stesso di qualsiasi agente: il consumo di token. Kilo Code invia al modello il contesto dei file, l'output dei comandi, la cronologia dei passaggi; per un singolo compito può facilmente richiedere 10-100M token. Ai prezzi di Anthropic ($3-15 per 1M) questo si traduce in $30-1500 per sessione, il che non è pratico per il lavoro quotidiano.

JoinGonka Gateway riduce il costo di centinaia e migliaia di volte: la stessa sessione costa $0.01-1.00. Poiché Kilo Code è open e supporta qualsiasi endpoint compatibile con OpenAI (così come il formato Anthropic con un URL di base personalizzato), collegare il nostro gateway è questione di una singola configurazione. Questo trasforma Kilo Code da una costosa dimostrazione a uno strumento quotidiano.

Passo 1: Installa Kilo Code e ottieni la chiave

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.

Passo 2: Configura Kilo Code (OpenAI Compatibile)

Il modo più semplice è configurarlo tramite il programma di installazione con un unico comando. Per gli strumenti CLI/file, configurerà automaticamente il provider JoinGonka (baseUrl, modelli), mentre per gli strumenti UI mostrerà i valori pronti da copiare:

npx @joingonka/setup --tool kilo

L'installatore è universale (se non si specifica un flag, chiederà di scegliere lo strumento da una lista), richiederà la chiave jg-… e dopo la configurazione eseguirà una verifica live tramite una richiesta al gateway. Non tocca le altre impostazioni. Di seguito è descritto il metodo manuale, se preferisci configurare tutto da solo.

Configurazione manuale (Piano B)

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

Metodo A — OpenAI Compatible (raccomandato). Nella versione più recente dell'estensione, apri Settings (ingranaggio) → scheda Providers → in basso il pulsante Custom provider e compila la finestra di dialogo:

  • Provider ID: qualsiasi identificativo, ad esempio joingonka.
  • Display name: ad esempio JoinGonka Gonka.
  • Base URL: https://gate.joingonka.ai/v1
  • API key: jg-la-tua-chiave
  • Models: aggiungi MiniMaxAI/MiniMax-M2.7. Kilo recupera automaticamente l'elenco dei modelli dall'endpoint /v1/models — puoi scegliere il modello dalla lista invece di inserirlo manualmente.

Premi Submit — i modelli appariranno nel selettore. Nell'interfaccia vecchia (VSCode Legacy) il percorso è più breve: API ProviderOpenAI Compatible, quindi i campi Base URL, API Key e Model con gli stessi valori.

Metodo B — Formato Anthropic. Il nostro gateway risponde anche all'Anthropic API. Seleziona API ProviderAnthropic, inserisci 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 relativi limiti di output (entrambi disponibili subito):

ModelloContestoOutput massimo
moonshotai/Kimi-K2.6 (default)200K8192
MiniMaxAI/MiniMax-M2.7200K8192

Nella finestra del provider personalizzato, per ogni modello puoi impostare Max Output Tokens e Context Window — inserisci 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. Di default, Kilo Code richiede una conferma prima di ogni azione — questo può essere allentato consentendo l'esecuzione automatica per operazioni fidate.

Confronto dei costi delle sessioni agente

Kilo Code è uno strumento basato su agenti: non si limita a rispondere, ma esegue le attività per intero, legge file, scrive codice, esegue test e corregge errori. Ogni passaggio è una chiamata API e i token si accumulano rapidamente. Confrontiamo il costo delle sessioni tipiche tramite Anthropic Claude e il nostro gateway verso la rete Gonka:

AttivitàTokenAnthropic ClaudeJoinGonka Gonka
Semplice bug-fix~5M$15 — $75$0.024
Nuova feature (2–3 file)~20M$60 — $300$0.096
Refactoring di un modulo~50M$150 — $750$0.24
Sessione di sviluppo completa (4 ore)~100M$300 — $1,500$0.48

Tramite JoinGonka Gateway il costo in ingresso è di ~$0.003 per 1M di token, l'uscita è circa tre volte più costosa: è centinaia o migliaia di volte più economico di Anthropic e OpenAI. Kilo Code diventa uno strumento quotidiano: si può avviare per ogni ticket, ogni bug e ogni feature senza dover contare i costi. Con i prezzi di Anthropic, invece, bisogna valutare ogni singola esecuzione.

Parametri del modello: i modelli della rete hanno una finestra di contesto di 200K token e una lunghezza massima di risposta di 8192 token. Kilo Code può richiedere di più, ma il gateway limiterà l'output al limite del modello (8192 per tutti i modelli della rete). Per generazioni lunghe, l'agente suddivide il lavoro in passaggi.

Modalità e tool calling

Il punto di forza di Kilo Code sono le modalità (nella vecchia estensione chiamate modes, nella nuova — agents), tra cui passare tramite menu a tendina, comando /agents o tastiera rapida Ctrl+.:

  • Plan / Architect — discutere e progettare una soluzione senza toccare i file. Comodo da eseguire tramite il conveniente Kimi K2.6: la pianificazione consuma molto contesto, ma sul nostro gateway costa pochissimo.
  • Code — modalità predefinita: scrive e corregge codice, applica diff, esegue comandi.
  • Debug — cerca specificamente la causa di un bug tramite log e stack.
  • Ask — risponde a domande sulla base di codice senza apportare modifiche.

La modalità Orchestrator nelle versioni recenti è considerata obsoleta: gli agenti con accesso completo agli strumenti ora possono lanciare sotto-task (subagents) da soli, senza un orchestratore dedicato. Sono supportate anche modalità personalizzate per i tuoi scenari.

Tool calling: il nostro gateway inoltra l'OpenAI function calling nativo e l'Anthropic tool_use, e i modelli selezionati (Kimi K2.6, MiniMax-M2.7) supportano la chiamata di strumenti. Questo significa che il ciclo agente di Kilo Code — lettura file, modifica, esecuzione comando, indicizzazione codebase — funziona sui nostri modelli in modo affidabile, senza un fragile parsing delle risposte testuali.

Kilo Code + Gonka = agente AI open-source per VS Code con modalità Plan/Code/Debug a basso costo. Una sessione di sviluppo costa circa $0.10 invece di $300-1500 con Anthropic, e 10M di token gratuiti bastano per decine di compiti.

Vuoi saperne di più?

Esplora altre sezioni o inizia a guadagnare GNK subito.

Ottieni 10M token gratuiti →