Sezioni dell'archivio conoscenza ▾

Navigazione

▸ Inizia qui Per ruolo

Categorie

Strumenti 54
Glossario 12

Strumenti

Roo Code + Gonka AI — agente AI autonomo in VS Code

Importante: l'estensione Roo Code è stata chiusa il 15 maggio 2026. Il repository è stato archiviato e non riceverà più aggiornamenti. Lo sviluppo prosegue con Zoo Code, un fork avviato dalla community di Roo Code: il provider si configura nello stesso modo, e per il trasferimento sono disponibili una guida alla migrazione e la nostra guida su Zoo Code. Altri agenti open source per VS Code includono Kilo Code e Cline, da cui Roo Code era originariamente derivato. L'estensione già installata continua a funzionare e le istruzioni seguenti rimangono valide.

Roo Code è un AI-agent autonomo per VS Code: legge e modifica file, esegue comandi nel terminale, interagisce con il browser e porta a termine compiti di sviluppo multi-step. Si tratta di un fork di Cline che si è spinto oltre: modalità operative personalizzabili (Architect, Code, Ask, Debug e personalizzate), istruzioni custom per progetto e un pannello flessibile per la configurazione del modello. In sostanza, un intero team di esperti AI all'interno dell'editor.

Il problema principale di questi agenti è il consumo di token. Per un singolo task, Roo Code elabora il contesto dei file, l'output dei comandi e i risultati degli strumenti, arrivando a decine di milioni di token. Ai prezzi di Anthropic ($3-15 per 1M), una sessione completa può costare da $30 a $1500. Per il lavoro quotidiano è insostenibile.

JoinGonka Gateway riduce i costi di migliaia di volte: la stessa sessione costerà $0.01-1.00. Il Gateway rivende l'inference della rete decentralizzata Gonka e supporta sia il formato OpenAI (provider "OpenAI Compatible") che il formato Anthropic (endpoint /v1/messages) — Roo Code si connette tramite entrambi. Questo trasforma Roo Code da una costosa demo a uno strumento di lavoro quotidiano.

Passo 1: Installa Roo Code e ottieni la chiave

Installazione di Roo Code: in VS Code apri Extensions (Ctrl/Cmd+Shift+X), cerca "Roo Code" e clicca Install. Dopo l'installazione apparirà l'icona del canguro Roo Code nella barra laterale. L'estensione rimane sul Marketplace, ma la sua ultima versione — la 3.54.0 del 15 maggio 2026 — rimarrà l'ultima.

API-key di JoinGonka: se non hai ancora una chiave — registrati su gate.joingonka.ai/register, ricevi 3M di token gratuiti e crea una chiave con il prefisso jg- nella Dashboard.

Passo 2: Configura Roo Code (compatibile con OpenAI)

Il modo più semplice è configurarlo con l'installer in un unico comando. Per gli strumenti CLI/file scrive da sé il provider JoinGonka (baseUrl, modelli), per gli strumenti UI mostra i valori pronti da incollare:

npx @joingonka/setup --tool roo

Il comando prima ricorda di chiudere Roo Code e indica dove andare (--tool zoo, --tool cline, --tool kilo), poi stampa i valori per chi ha ancora l'estensione installata — insieme alla reale finestra di contesto e al tetto di risposta del modello. L'installer chiede la chiave jg-… e termina con una verifica live tramite una richiesta al gateway. Qui sotto trovi il metodo manuale, se preferisci configurare da solo.

Configurare manualmente (piano B)

Apri il pannello di Roo Code ed entra nelle impostazioni (icona dell'ingranaggio). Nella sezione del provider imposta:

  1. API Provider — seleziona OpenAI Compatible.
  2. Base URL — https://gate.joingonka.ai/v1
  3. API Key — jg-your-key
  4. Model (Model ID) — MiniMaxAI/MiniMax-M2.7

Qui sotto, nel blocco Model Configuration, puoi specificare manualmente i parametri del modello:

  • Context Window — 180000 (180K token; per DeepSeek V4 Flash — 380000).
  • Max Output Tokens — 8192 per MiniMax M2.7 e GLM-5.3 Flash, 32768 per DeepSeek V4 Flash.
  • Input Price / Output Price — puoi inserire le tariffe reali (≈$0.0062 per 1M in input, output ×3), così Roo Code calcola correttamente il costo delle attività direttamente nell'interfaccia.

Importante sul tool calling: Roo Code usa solo il tool calling nativo — qui non c'è il fallback XML dei vecchi agenti. Perciò il modello deve saper fare function calling. I modelli della rete tramite il nostro Gateway supportano il tool calling nativo — Roo Code funziona con loro fin da subito.

Verifica: nella chat di Roo Code scrivi «Crea un file hello.py con una funzione che stampa Hello World». L'agente proporrà di creare il file e mostrerà un diff da approvare.

Confronto dei costi delle sessioni d'agente

Roo Code è uno strumento basato su agenti: non risponde con un singolo messaggio, ma esegue un compito: legge file, scrive codice, esegue test, corregge errori. Ogni azione è una chiamata al modello. Confrontiamo i costi di sessioni tipiche:

TaskTokenAnthropic ClaudeOpenAI GPTJoinGonka Gonka
Semplice bug-fix~5M$15 — $75$12 — $50$0.048
Nuova feature (2-3 file)~20M$60 — $300$50 — $200$0.19
Refactoring di un modulo~50M$150 — $750$125 — $500$0.48
Sessione di sviluppo completa (4h)~100M$300 — $1,500$250 — $1,000$0.96

Con JoinGonka Gateway, Roo Code diventa uno strumento quotidiano: può essere avviato per ogni ticket, ogni bug, ogni feature, senza preoccuparsi del costo. 3M di token gratuiti all'inizio permettono di provare l'integrazione senza carta di credito.

Parametri dei modelli: MiniMax M2.7 — context window 180K e fino a 8192 token di risposta, DeepSeek V4 Flash — 380K e fino a 32768, GLM-5.3 Flash — 390K e fino a 8192. Se max_tokens per una richiesta non-stream non è specificato, il Gateway restituirà di default fino a 1500 token (per GLM-5.3 Flash fino a 3000). Roo Code suddivide automaticamente le generazioni lunghe in più passaggi.

Cosa distingue Roo Code da Cline: modalità e formato Anthropic

Roo Code è un fork di Cline, ma con differenze notevoli che cambiano il flusso di lavoro:

  • Modalità (Modes): cambia il ruolo dell'agente in base all'attività — Architect per la pianificazione, Code per scrivere codice, Ask per fare domande sul progetto, Debug per cercare errori. Puoi anche creare modalità personalizzate con istruzioni dedicate e un set di strumenti consentiti.
  • Solo tool calling nativo: a differenza degli agenti con parsing testuale/XML, Roo Code invia gli strumenti secondo lo schema nativo OpenAI tools e riceve le chiamate come eventi separati — latenza più bassa e risultati più affidabili. Il rovescio della medaglia: il modello deve supportare il function calling (i modelli della rete attraverso il nostro Gateway lo supportano).
  • Istruzioni e profili personalizzati: regole per progetto (ad esempio tramite un file di regole nel repository) e diverse configurazioni del provider salvate, tra cui passare comodamente.

Connessione tramite formato Anthropic. Se vuoi usare il nostro endpoint /v1/messages invece del formato OpenAI: nelle impostazioni scegli API Provider → Anthropic, spunta «Use custom base URL» e indica https://gate.joingonka.ai, nel campo Anthropic API Key incolla la stessa chiave jg-your-key, poi imposta il nome del modello (ad esempio MiniMaxAI/MiniMax-M2.7). Chiave e saldo sono condivisi tra i due formati, e anche il tool_use nativo in modalità Anthropic passa attraverso il Gateway.

Roo Code + Gonka = AI-agente autonomo in VS Code con varie modalità e native tool calling a costi irrisori. Una sessione di sviluppo costa $0.10 anziché $300-1,500 con Anthropic, e i token iniziali ti permettono di testarlo senza carta. L'estensione originale è stata chiusa il 15 maggio 2026: per le nuove installazioni usa Zoo Code (fork della community), oppure Kilo Code o Cline.

Vuoi saperne di più?

Esplora altre sezioni o inizia a guadagnare GNK subito.

Ricevi token gratuiti →