Roo Code + Gonka AI — Agente de IA autônomo no VS Code

Importante: a extensão Roo Code foi encerrada em 15 de maio de 2026. O repositório foi arquivado e não haverá mais atualizações. O desenvolvimento continua com o Zoo Code — um fork iniciado pela comunidade do Roo Code: o provedor nele é configurado da mesma forma, e para a migração há um guia de migração e nosso guia sobre o Zoo Code. Outros agentes de código aberto para VS Code são o Kilo Code e o Cline, do qual o Roo Code se derivou. A extensão já instalada continua funcionando, e as instruções abaixo são relevantes para ela.

O Roo Code é um agente de IA autônomo para VS Code: ele lê e edita arquivos, executa comandos no terminal, trabalha com o navegador e conclui tarefas de desenvolvimento de várias etapas. É um fork do Cline que foi além: modos de trabalho configuráveis (Architect, Code, Ask, Debug e próprios), instruções personalizadas por projeto e um painel flexível de configuração de modelos. Essencialmente, é uma equipe inteira de especialistas em IA dentro do editor.

O principal problema desses agentes é o consumo de tokens. Para uma única tarefa, o Roo Code processa o contexto de arquivos, saídas de comandos, resultados de ferramentas — são dezenas de milhões de tokens. Com os preços da Anthropic ($3-15 por 1M), uma sessão completa pode custar de $30 a $1500. Para o trabalho diário, isso não é viável.

JoinGonka Gateway reduz o custo milhares de vezes: a mesma sessão custará entre $0.01 e $1.00. O Gateway revende a inferência da rede descentralizada Gonka e suporta tanto o formato OpenAI (provedor «OpenAI Compatible») quanto o formato Anthropic (endpoint /v1/messages) — o Roo Code se conecta através de qualquer um dos dois. Isso transforma o Roo Code de uma demonstração cara em uma ferramenta de trabalho para o dia a dia.

Passo 1: Instalar Roo Code e obter chave

Instalação do Roo Code: no VS Code, abra Extensions (Ctrl/Cmd+Shift+X), procure por «Roo Code» e clique em Install. Após a instalação, um ícone de canguru do Roo Code aparecerá na barra lateral. A extensão ainda está no Marketplace, mas sua última versão — 3.54.0 de 15 de maio de 2026 — continuará sendo a última.

Chave API do JoinGonka: se ainda não possui uma chave, cadastre-se em gate.joingonka.ai/register, receba 3M de tokens gratuitos e crie uma chave com o prefixo jg- no Dashboard.

Passo 2: Configurar Roo Code (OpenAI Compatible)

O mais fácil é configurar com o instalador em um único comando. Para ferramentas de CLI/arquivos, ele mesmo registra o provedor JoinGonka (baseUrl, modelos); para ferramentas com UI, mostra os valores prontos para colar:

npx @joingonka/setup --tool roo

O comando primeiro lembra de fechar o Roo Code e indica aonde ir (--tool zoo, --tool cline, --tool kilo), e depois imprime os valores para quem ainda tem a extensão instalada — junto com a janela de contexto real e o teto de resposta do modelo. O instalador pede a chave jg-… e termina com uma verificação ao vivo via requisição ao gateway. Abaixo está o método manual, caso prefira configurar por conta própria.

Configurar manualmente (plano B)

Abra o painel do Roo Code e acesse as configurações (ícone de engrenagem). Na seção do provedor, defina:

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

Abaixo, no bloco Model Configuration, dá para ajustar os parâmetros do modelo manualmente:

Context Window — 180000 (180K tokens; no DeepSeek V4 Flash — 380000).
Max Output Tokens — 8192 para MiniMax M2.7 e GLM-5.3 Flash, 32768 para DeepSeek V4 Flash.
Input Price / Output Price — dá para colocar as tarifas reais (≈$0.0062 por 1M de entrada, saída ×3) para o Roo Code calcular corretamente o custo das tarefas direto na interface.

Importante sobre tool calling: o Roo Code usa somente tool calling nativo — aqui não existe fallback em XML, como nos agentes antigos. Por isso o modelo precisa saber fazer function calling. Os modelos da rede através do nosso Gateway suportam tool calling nativo — o Roo Code funciona com eles de imediato.

Verificação: no chat do Roo Code, escreva «Crie um arquivo hello.py com uma função que imprima Hello World». O agente vai propor criar o arquivo e mostrar um diff para aprovação.

Comparação de custos de sessões de agente

O Roo Code é uma ferramenta de agentes: ele não responde com uma única mensagem, mas executa uma tarefa — lê arquivos, escreve código, executa testes, corrige bugs. Cada ação é uma chamada de inferência. Vamos comparar o custo de sessões típicas:

Tarefa	Tokens	Anthropic Claude	OpenAI GPT	JoinGonka Gonka
Correção de bug simples	~5M	$15 — $75	$12 — $50	$0.048
Nova funcionalidade (2-3 arquivos)	~20M	$60 — $300	$50 — $200	$0.19
Refatoração de módulo	~50M	$150 — $750	$125 — $500	$0.48
Sessão de desenvolvimento completa (4h)	~100M	$300 — $1,500	$250 — $1,000	$0.96

Com o JoinGonka Gateway, o Roo Code torna-se uma ferramenta cotidiana — pode ser executado para cada ticket, cada bug, cada funcionalidade, sem se preocupar com a fatura. 3M de tokens gratuitos no início permitem testar o conjunto sem necessidade de cartão.

Parâmetros dos modelos: MiniMax M2.7 — janela de 180K e até 8192 tokens de resposta, DeepSeek V4 Flash — 380K e até 32768, GLM-5.3 Flash — 390K e até 8192. Se max_tokens para uma solicitação non-stream não for especificado, o Gateway retornará por padrão até 1500 tokens (para o GLM-5.3 Flash — até 3000). O Roo Code divide automaticamente as gerações longas em passos.

O que Roo Code tem de diferente do Cline: modos e formato Anthropic

O Roo Code é um fork do Cline, mas com diferenças marcantes que mudam o fluxo de trabalho:

Modos (Modes): alterne o papel do agente conforme a tarefa — Architect para planejar, Code para escrever código, Ask para tirar dúvidas sobre o projeto, Debug para caçar erros. Você pode criar modos próprios com instruções específicas e um conjunto de ferramentas permitidas.
Somente tool calling nativo: ao contrário dos agentes com parsing de texto/XML, o Roo Code envia as ferramentas pelo esquema nativo da OpenAI tools e recebe as chamadas como eventos separados — menos latência e resultado mais confiável. O outro lado: o modelo precisa suportar function calling (os modelos da rede através do nosso Gateway suportam).
Instruções e perfis personalizados: regras por projeto (por exemplo, via arquivo de regras no repositório) e várias configurações de provedor salvas, entre as quais é fácil alternar.

Conexão pelo formato Anthropic. Se você quiser usar nosso endpoint /v1/messages em vez do formato OpenAI: nas configurações, selecione API Provider → Anthropic, marque «Use custom base URL» e informe https://gate.joingonka.ai; no campo Anthropic API Key, cole a mesma chave jg-your-key e depois defina o nome do modelo (por exemplo, MiniMaxAI/MiniMax-M2.7). A chave e o saldo são compartilhados entre os dois formatos, e o tool_use nativo no modo Anthropic também passa pelo Gateway.

Roo Code + Gonka = agente de IA autônomo no VS Code com modos e tool calling nativo por centavos. Uma sessão de desenvolvimento custa $0.10 em vez de $300-$1,500 na Anthropic, e os tokens iniciais permitem testar sem cartão. A extensão original foi encerrada em 15 de maio de 2026: para novas instalações, use o Zoo Code — um fork da comunidade — ou o Kilo Code ou o Cline.

← LibreChat + Gonka AI — ChatGPT de código aberto LlamaIndex + Gonka AI — Aplicações RAG por alguns centavos →

Quer saber mais?

Explore outras seções ou comece a ganhar GNK agora mesmo.

Obter tokens gratuitos →