Sezioni dell'archivio conoscenza ▾

Navigazione

▸ Inizia qui Per ruolo

Categorie

Strumenti 54
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 le Extensions (Ctrl+Shift+X), cerca «Kilo Code» e clicca su Install. Dopo l'installazione, apparirà l'icona Kilo Code nella barra laterale. L'estensione è disponibile anche in Open VSX per le build senza Marketplace.

Chiave API di JoinGonka: se non hai ancora un account, registrati su gate.joingonka.ai/register, ricevi 3M token gratuiti e crea una chiave con il prefisso jg- in 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 con l'installer in un solo comando. Scrive il provider JoinGonka nel config globale di Kilo (di solito ~/.config/kilo/kilo.jsonc): l'indirizzo del gateway, la chiave e i modelli della rete con le loro finestre di contesto e i limiti di risposta. Il file riceverà i permessi 600, e DeepSeek V4 Flash diventerà il modello predefinito se non ne hai già scelto uno tuo:

npx @joingonka/setup --tool kilo

L'installer è universale (senza flag ti proporrà di scegliere uno strumento dall'elenco), chiederà la chiave jg-… e dopo la configurazione esegue un live-check con una richiesta al gateway. Non tocca le altre impostazioni. Di seguito il metodo manuale, se preferisci configurare da solo.

Configurare manualmente (piano B)

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

Modo A — OpenAI Compatible (consigliato). Nella versione moderna dell'estensione apri Settings (ingranaggio) → scheda Providers → in basso il pulsante Custom provider e compila la finestra:

  • Provider ID: un identificatore qualsiasi, ad esempio joingonka.
  • Display name: ad esempio JoinGonka Gonka.
  • Base URL: https://gate.joingonka.ai/v1
  • API key: jg-your-key
  • Models: aggiungi deepseek-ai/DeepSeek-V4-Flash-0731. Kilo recupera automaticamente l'elenco dei modelli dall'endpoint /v1/models — puoi selezionare il modello dall'elenco invece di inserirlo a mano.

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

Modo B — formato Anthropic. Il nostro gateway risponde anche all'API Anthropic. Scegli API Provider → Anthropic, incolla la chiave jg-your-key, spunta «Use custom base URL» e indica https://gate.joingonka.ai (senza /v1 — Kilo aggiungerà /v1/messages da sé).

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

ModelloContestoOutput max
MiniMaxAI/MiniMax-M2.7180K8192
deepseek-ai/DeepSeek-V4-Flash-0731 (la imposta l'installer)380K32768
zai-org/GLM-5.3-Flash390K8192

Nella finestra del provider personalizzato puoi impostare per ogni modello Max Output Tokens e Context Window — inserisci i valori dalla tabella per il modello scelto.

Verifica: nella chat di Kilo Code in modalità Code scrivi «Crea un file hello.py con una funzione hello world». L'agente deve proporre una diff da approvare e creare il file. Per impostazione predefinita Kilo Code chiede conferma prima di ogni azione — puoi allentare questo comportamento consentendo l'esecuzione automatica per le operazioni fidate.

Confronto dei costi delle sessioni agente

Kilo Code è uno strumento basato su agenti: non risponde solo alle domande, ma esegue intere attività — legge file, scrive codice, avvia test, corregge bug. Ogni passaggio è una chiamata API e i token vengono consumati rapidamente. Confrontiamo i costi delle sessioni tipiche tramite Anthropic Claude e tramite il nostro gateway per la rete Gonka:

AttivitàTokenAnthropic ClaudeJoinGonka Gonka
Bug-fix semplice~5M$15 — $75$0.048
Nuova feature (2–3 file)~20M$60 — $300$0.19
Refactoring di un modulo~50M$150 — $750$0.48
Sessione di sviluppo completa (4h)~100M$300 — $1,500$0.96

Tramite JoinGonka Gateway, l'input costa ~$0.0062 per 1M di token, l'output costa circa il triplo — questo è centinaia e migliaia di volte più economico rispetto ad Anthropic e OpenAI. Kilo Code diventa uno strumento quotidiano: può essere eseguito 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: MiniMax M2.7 ha una finestra di contesto di 180K token e una lunghezza massima di risposta di 8192 token (DeepSeek V4 Flash ha 380K e fino a 32768, GLM-5.3 Flash ha 390K e fino a 8192). Kilo Code potrebbe richiedere di più, ma il gateway limiterà l'output al limite massimo del modello. Per generazioni lunghe, l'agente suddivide il lavoro in più 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 è possibile passare tramite menu a tendina, il comando /agents o la scorciatoia da tastiera Ctrl+.:

  • Plan / Architect — discutere e progettare una soluzione senza toccare i file. Comodo da gestire tramite GLM-5.3 Flash — il modello di reasoning riflette prima di rispondere, e la pianificazione consuma molto contesto, ma sul nostro gateway è estremamente economico.
  • Code — modalità predefinita: scrive e corregge codice, applica diff ed esegue comandi.
  • Debug — cerca specificamente la causa di un bug analizzando log e stack trace.
  • Ask — risponde a domande sulla codebase senza apportare modifiche.

La modalità separata Orchestrator nelle versioni recenti è considerata obsoleta: gli agenti con pieno accesso agli strumenti ora sono in grado di avviare autonomamente sottoattività (subagents), senza un orchestratore dedicato. Sono supportate anche modalità personalizzate per i tuoi scenari.

Tool calling: il nostro gateway inoltra il tool calling nativo di OpenAI e Anthropic tool_use, e i modelli scelti (MiniMax M2.7, DeepSeek V4 Flash, GLM-5.3 Flash) supportano la chiamata agli strumenti. Ciò significa che il loop degli agenti di Kilo Code — lettura del file, modifica, esecuzione di comandi, indicizzazione della codebase — funziona in modo affidabile con i nostri modelli, senza l'analisi fragile delle risposte testuali.

Kilo Code + Gonka = AI-agent aperto per VS Code con modalità Plan/Code/Debug a pochi centesimi. Una sessione di sviluppo costa circa $0.10 invece di $300–1500 di Anthropic, e i token iniziali ti permettono di provare senza carta di credito.

Vuoi saperne di più?

Esplora altre sezioni o inizia a guadagnare GNK subito.

Ricevi token gratuiti →