Zoo Code + JoinGonka Gateway: migração do Roo Code para modelos Gonka

Passo 1: instale a extensão. No VS Code, abra o painel de extensões (Ctrl+Shift+X, no macOS Cmd+Shift+X), procure «Zoo Code» e instale a extensão do publisher Zoo Code Organization. O mesmo com um único comando:

code --install-extension ZooCodeOrganization.zoo-code

É necessário o VS Code 1.100 ou superior — é o que diz o manifesto da extensão; para VSCodium, Windsurf e outros editores sem Marketplace, a extensão está publicada no Open VSX. Além do canal estável (3.82.2, de 18 de setembro de 2026), existe o preliminar 3.83.x — builds noturnos da branch principal; para trabalhar, use o estável. Depois da instalação, o ícone do Zoo Code aparece na barra de atividades.

Passo 2: obtenha uma chave. Cadastre-se em gate.joingonka.ai/register, confirme o endereço e crie uma chave com o prefixo jg- na seção «Chaves de API». Vale a pena criar uma chave separada para o Zoo Code: o consumo dela aparecerá nas estatísticas em uma linha própria.

Passo 3: execute o instalador.

npx @joingonka/setup --tool zoo --model deepseek

O instalador vai pedir a chave — ela não é passada nos argumentos da linha de comando para não ficar no histórico do shell. Ele não tem nada para gravar: o Zoo Code guarda os perfis de provedor junto com as chaves no armazenamento seguro de segredos do VS Code, e não em um arquivo. Por isso o instalador imprime os valores prontos para o formulário e os limites reais do modelo escolhido:

Zoo Code is configured in the VS Code extension UI (no file is written).
Open the Zoo Code settings (gear icon) → API Provider, then enter:

  API Provider: OpenAI Compatible
  Base URL:     https://gate.joingonka.ai/v1
  API Key:      jg-your-key
  Model:        deepseek-ai/DeepSeek-V4-Flash-0731

Then set the real limits of this model under Model Configuration
(the defaults do not fit any Gonka model):

  Context Window Size: 380000
  Max Output Tokens:   32768
  Image Support:       off

Zoo Code relies on native tool calling only — all our Gonka models support it.

Em seguida vem o resultado de uma requisição ao vivo ao gateway — em caso de sucesso, a linha ✓ Verified: the gateway accepted the key, base URL and model. A chave, o endereço e o modelo são verificados na hora, e não na primeira tarefa. A chave aparece por inteiro no bloco impresso para facilitar a cópia — não publique essa saída.

Sem a flag --model, o instalador vai usar o MiniMax M2.7: onde o modelo é escolhido manualmente, ele sugere o modelo com maior capacidade na rede. Para o Zoo Code, recomendamos começar com o DeepSeek V4 Flash: no nosso teste, ele concluiu o turno após o resultado da ferramenta com uma única requisição — os detalhes estão na seção sobre o teste; a flag também aceita as abreviações glm (GLM-5.3 Flash) e minimax. Sem a flag --tool, o instalador mostra um menu de 25 ferramentas.

Um detalhe do formulário: no Zoo Code 3.82.2 não existe um bloco separado com o título Model Configuration. Os campos de limites ficam no mesmo formulário, mais abaixo, sob a explicação «Configure the capabilities and pricing for your custom OpenAI-compatible model», e Max Output Tokens vem antes de Context Window Size.

Ao iniciar pela primeira vez, o Zoo Code exibe uma saudação com o botão Choose your provider: ele leva a um formulário onde o OpenRouter está pré-selecionado — altere o provedor para OpenAI Compatible e, ao final, clique em Finish. Posteriormente, o mesmo formulário pode ser aberto através do ícone de engrenagem no cabeçalho do painel do Zoo Code, na seção Providers; as alterações são salvas com o botão Save.

Limites dos modelos da rede:

O restante pode ser ignorado: deixe Enable streaming e Include max output tokens ativados, e Enable R1 model parameters e Use Azure desativados (são marcações para a família de modelos R1 e para Azure OpenAI), mantenha os campos Custom Headers e Extra Body vazios.

Os limites são armazenados no perfil, e não no modelo: se você alterar o Model no mesmo perfil, a janela e o limite de resposta permanecerão os mesmos. Por isso, é mais prático criar um perfil separado para cada modelo — sobre isso trata a próxima seção.

O Zoo Code surgiu da base de código do Roo Code, portanto a migração leva apenas alguns minutos e não é necessário tocar nos arquivos do projeto. O guia de migração oficial descreve como exportar e importar configurações; o restante é transferido com um botão separado ou lido a partir dos caminhos antigos:

Um perfil do Roo Code que já apontava para o JoinGonka Gateway será transferido com seu endereço, chave, modelo e limites — verifique apenas se o modelo está disponível na rede agora: a lista é fornecida por GET https://gate.joingonka.ai/v1/models.

Modos e perfis. Existem cinco modos integrados: Code, Debug, Architect (edita apenas arquivos Markdown), Ask (responde sem editar) e Orchestrator (distribui subtarefas para outros modos). Eles são alternados pela lista ao lado do campo de entrada, por um comando com o nome do modo no início da mensagem, por exemplo /architect, ou pela combinação Ctrl+. (Cmd+. no macOS). Cada modo lembra o perfil com o qual você trabalhou nele pela última vez e, ao alternar o modo, o Zoo Code muda o perfil automaticamente.

Daqui surge um esquema conveniente: um perfil por modelo, fixado aos modos. Em Settings → Providers, clique em «+» ao lado do campo Configuration Profile, nomeie o perfil, por exemplo Gonka DeepSeek, e preencha o formulário; repita para GLM-5.3 Flash e MiniMax M2.7 — o endereço e a chave são os mesmos para todos. Em seguida, em cada modo, selecione o perfil na lista de perfis ao lado do campo de entrada, e o modo o memorizará. O ícone de cadeado nesta lista, por outro lado, fixa um perfil para todos os modos da pasta de trabalho.

Nível de raciocínio. A marcação Enable Reasoning Effort no formulário abre a lista Low, Medium, High, Extra High e Max; enquanto estiver desativada, o nível não entra na solicitação. No GLM-5.3 Flash, o interruptor é essencialmente binário: Low desliga o raciocínio, qualquer outro nível o deixa completo — é conveniente manter um perfil GLM separado com Low para perguntas rápidas. Mais detalhes no análise do GLM-5.3 Flash. No DeepSeek V4 Flash e MiniMax M2.7, o gateway não sobrescreve a escala: como o nível funciona depende do próprio modelo.

Abra uma pasta com um arquivo pequeno que contenha um erro óbvio, por exemplo calc.py com uma função de soma que subtrai, e no modo Code escreva: «Leia calc.py e diga em uma frase se há um erro nele». O Zoo Code solicitará permissão para ler o arquivo — «Zoo wants to read this file», com os botões Approve e Deny, se a leitura não tiver sido autorizada previamente no Auto-Approve. Em seguida, o modelo chamará a ferramenta de finalização e a tarefa terminará com o bloco Task Completed com a resposta substantiva; o raciocínio, se houver, é exibido em um bloco separado chamado Thinking. A porcentagem de preenchimento do contexto no cabeçalho colapsado da tarefa é calculada com base no Context Window Size — mais uma razão para defini-lo corretamente.

Reproduzimos esse processo com uma solicitação seguindo o modelo do Zoo Code: fluxo, ferramentas em um esquema estrito, e no histórico o resultado de read_file. O DeepSeek V4 Flash respondeu com uma chamada nativa para attempt_completion com a conclusão correta: a função subtrai em vez de somar. A segunda metade da verificação é o painel do gateway: na seção «Uso», a solicitação aparecerá detalhada por modelos, e a chave terá a hora do seu último acesso atualizada.

Sem o Auto-Approve, o erro chega como um bloco API Request Failed com botões de Retry e Start New Task, acompanhado pelo cabeçalho Provider Error com o código e uma contagem regressiva para o reenvio. O texto da resposta do gateway é visível na mensagem ou em seus detalhes:

Um agente gasta tokens de forma diferente de um chat. Em cada solicitação, o Zoo Code coloca um system prompt com as regras do modo, descrições de ferramentas e informações sobre a pasta de trabalho — isso são milhares de tokens antes mesmo da sua pergunta — e uma tarefa geralmente leva vários passos. Portanto, o preço por token é fundamental aqui.

Através do JoinGonka Gateway, os tokens custam $0.0069 por milhão na entrada e $0.021 por milhão na saída — o preço é igual para todos os modelos da rede e é atualizado nesta página a partir de uma fonte em tempo real. A ordem de grandeza dos preços em setembro de 2026 é:

Para comparação — como você pode pagar por modelos no Zoo Code:

Com o Input Price e Output Price preenchidos, o custo da tarefa fica visível em seu cabeçalho, mas com precisão de centavo — tarefas curtas em modelos da rede mostrarão $0.00. O consumo exato e o saldo restante estão no painel, nas seções «Uso» e «Faturamento».

Confirmações e autonomia. Por padrão, o Auto-Approve está desativado e o Zoo Code solicita permissão para ler, escrever e executar comandos; para tarefas longas, ative as categorias necessárias no menu Auto-approve próximo ao campo de entrada. Para comandos, existe o Destructive Command Guard (Settings → Auto-Approve): a extensão baixa seu executável, e a partir daí os comandos por ele aprovados são executados automaticamente, enquanto os bloqueados aguardam confirmação. Com o Auto-Approve, o Zoo Code também repete solicitações com falha: a pausa começa em 5 segundos e dobra a cada tentativa, até um máximo de 10 minutos.

Resposta por streaming. Não desative o Enable streaming: no stream, o gateway entrega o texto conforme é gerado e limita a resposta apenas ao teto do modelo, enquanto uma solicitação sem streaming e sem um limite explícito é cortada em 1500 tokens de resposta (no GLM-5.3 Flash, em 3000).

Indexação de código. A busca semântica no projeto (Codebase Indexing) é configurada separadamente do modelo, através de um provedor de embeddings; existe uma opção local para isso: Semble - Local.

Imagens. Os modelos da rede são textuais. Para capturas de tela e maquetes, crie um perfil separado com um modelo que trabalhe com imagens e alterne para ele durante essa tarefa.

Privacidade. O Zoo Code envia aos desenvolvedores dados sobre erros e uso vinculados ao identificador de instalação, sem incluir código ou prompts; isso é desativado com o interruptor Allow error and usage reporting em Settings → About Zoo Code. Por sua vez, o gateway não armazena o conteúdo dos prompts ou das respostas: no painel, apenas os contadores de solicitações e tokens são visíveis.