---
title: "Roo Code após o encerramento: configuração OpenAI Compatible"
description: "O Roo Code foi encerrado em maio de 2026. Configurações para instalações e forks existentes, e para onde migrar (Cline ou o fork Zoo Code) com a BroadNet Inference."
url: https://broadrouter.com/pt/guides/roo-code-openai-compatible/
lang: pt-BR
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/guides/roo-code-openai-compatible/) (atualizado em 2026-11-16).

# Usar o Roo Code com a BroadNet Inference (OpenAI Compatible)

Atualizado em 2026-11-16

O Roo Code foi encerrado em 15 de maio de 2026, então novas configurações devem usar o Cline ou o fork da comunidade Zoo Code. Em instalações existentes, defina API Provider como OpenAI Compatible, Base URL como https://inference.broadnet.ai/v1, API Key como a sua chave da BroadNet e Model como broadnet/glm-5.3. O Roo Code exige tool calling nativo, então escolha um modelo com ferramentas.

> **O Roo Code foi encerrado em 15 de maio de 2026.** O [repositório](https://github.com/RooCodeInc/Roo-Code) está arquivado e só para leitura. Para um agente mantido, use o [Cline com a BroadNet Inference](https://broadrouter.com/pt/guides/cline-openai-compatible/) ou o fork da comunidade [Zoo Code](https://github.com/Zoo-Code-Org/Zoo-Code), que dá continuidade ao código do Roo Code. Os passos abaixo continuam valendo para instalações existentes do Roo Code. Veja também [Cline vs Roo Code vs Aider](https://broadrouter.com/pt/blog/cline-vs-roo-code-vs-aider/).

O Roo Code é um agente de programação para o VS Code. O provedor **OpenAI Compatible** dele funciona com qualquer endpoint que fale o formato de chat completions da OpenAI, incluindo a BroadNet Inference em `https://inference.broadnet.ai/v1`. Uma regra define a configuração: segundo a [documentação do Roo Code](https://roocodeinc.github.io/Roo-Code/providers/openai-compatible), ele usa **apenas tool calling nativo**, sem fallback em XML. O modelo escolhido precisa suportar chamadas de ferramentas no estilo da OpenAI.

## Configuração

1.  **Consiga uma chave da BroadNet.** Uma chave de pagamento por uso funciona com todos os modelos de chat. Veja [chaves de API e listas de IPs permitidos](https://broadrouter.com/pt/guides/api-keys-ip-allow-lists/).
    
2.  **Abra as configurações do Roo Code** pelo ícone de configurações no painel do Roo Code.
    
3.  **Defina API Provider** como **OpenAI Compatible**.
    
4.  **Preencha a conexão.**
    
    | Campo | Valor |
    | --- | --- |
    | Base URL | `https://inference.broadnet.ai/v1` |
    | API Key | a sua chave da BroadNet |
    | Model | `broadnet/glm-5.3` |
    
5.  **Ajuste Model Configuration.** Defina **Context Window** com o contexto do modelo na tabela abaixo. Defina **Max Output Tokens** com espaço para o raciocínio; comece com alguns milhares. Ative **Image Support** só para o Qwen3.8 27B ou o DeepSeek V4.1 Flash. Preencha **Input Price** e **Output Price** com os valores da [página de preços](https://broadrouter.com/pt/pricing/) se quiser que a estimativa de custo do Roo bata com a sua fatura.
    
6.  **Rode uma tarefa de teste**, por exemplo “list the files in this folder and summarize the README”. O Roo Code vai chamar as ferramentas de arquivos dele. Se essas chamadas funcionarem, o tool calling funciona.
    

## Qual modelo escolher

| Modelo | ID | Contexto | Ferramentas listadas pela BroadNet |
| --- | --- | --- | --- |
| GLM 5.3 | `broadnet/glm-5.3` | 1.048.576 | Sim |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | 262.144 | Sim, mais entrada de imagem |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | 1.048.576 | Não listadas; aceita imagens |

Comece pelo [GLM 5.3](https://broadrouter.com/pt/models/glm-5.3/). Ele tem contexto de 1M de tokens, e a BroadNet lista ferramentas e saída estruturada para ele. Use o [Qwen3.8 27B](https://broadrouter.com/pt/models/qwen3.8-27b/) quando quiser colar screenshots ou trabalhar em árabe.

O DeepSeek V4.1 Flash é o modelo dos planos ilimitados. Como o Roo Code precisa de tool calling nativo e a documentação da BroadNet não lista ferramentas para ele, teste antes de depender dele. Uma hora de Meteor custa $1 e basta para uma tarefa real. O BroadNet Gemma 4 VL 26B também não é listado com ferramentas, então não é uma boa escolha para o Roo Code.

## Solução de problemas

-   **401.** A chave está faltando, é inválida ou expirou, ou a cota de pagamento por uso acabou. Insira a chave de novo e confira o saldo.
-   **A primeira requisição falha com erro de modelo.** O valor de **Model** precisa ser exatamente um ID da BroadNet, com o prefixo `broadnet/`. GLM 5.3, Qwen3.8 27B e DeepSeek V4.1 Flash exigem uma recarga; o crédito inicial de $5 cobre o Gemma 4 VL 26B e os dois modelos Transcribe.
-   **Erros de tool calling.** Troque para um modelo listado com ferramentas. A documentação do Roo observa que suporte parcial a ferramentas do lado do provedor causa esses erros.
-   **Respostas vazias.** O raciocínio conta no limite de saída. Aumente **Max Output Tokens**. [Por que as respostas vêm vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **429.** Chaves de pagamento por uso permitem 30 requisições por minuto e 4 ao mesmo tempo. As subtarefas do Roo e uma segunda janela do VS Code dividem esse limite. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).
-   **Tarefas em paralelo num plano.** Uma [sessão do plano](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/) roda uma requisição por vez. Se você roda um orquestrador e subtarefas em paralelo, cada um precisa da própria sessão, ou eles entram em fila.

## Termos neste guia

[Tool calling (chamada de ferramentas)](https://broadrouter.com/pt/glossary/tool-calling/)

Tool calling, também chamado de function calling ou chamada de ferramentas, é um recurso de APIs de LLM em que o modelo devolve um pedido estruturado para executar uma função definida pelo desenvolvedor, com argumentos JSON. A aplicação executa a função e devolve o resultado; o modelo nunca executa código sozinho.

[Token](https://broadrouter.com/pt/glossary/token/)

Um token é a unidade de texto que um modelo de linguagem lê e escreve: uma palavra, parte de uma palavra, um sinal de pontuação ou uma sequência de bytes gerada pelo tokenizador do modelo. As APIs de LLM contam, limitam e normalmente cobram o uso em tokens.

[Pagamento por uso (pay-as-you-go)](https://broadrouter.com/pt/glossary/pay-as-you-go/)

Pagamento por uso é um modelo de preço em que você paga só pelo que usa, medido por unidade, como tokens, requisições ou minutos de áudio, sem assinatura nem compromisso mínimo. A maioria das APIs de LLM cobra assim, a partir de um saldo pré-pago ou de uma fatura periódica.

[Base URL (URL base)](https://broadrouter.com/pt/glossary/base-url/)

A base URL é o endereço raiz fixo de uma API, como https://api.example.com/v1, que um cliente coloca antes de cada caminho de endpoint, como /chat/completions. Nos SDKs compatíveis com a OpenAI, trocar a base URL, junto com a chave de API e o ID do modelo, aponta o mesmo código para outro provedor.

[Concorrência (concurrency)](https://broadrouter.com/pt/glossary/concurrency/)

Concorrência é o número de requisições que um cliente tem em andamento ao mesmo tempo. APIs de LLM muitas vezes a limitam por chave ou por plano, separadamente das requisições por minuto, porque cada requisição aberta ocupa capacidade de GPU até a resposta terminar.

[Janela de contexto (context window)](https://broadrouter.com/pt/glossary/context-window/)

A janela de contexto é o número máximo de tokens com que um modelo de linguagem consegue trabalhar em uma única requisição. Ela abrange o prompt, o histórico da conversa, as definições de ferramentas, as imagens e a saída gerada, incluindo os tokens de raciocínio. O que não couber precisa ser cortado, resumido ou dividido em várias requisições.

[Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/)

Um rate limit é um teto que uma API impõe a quanto um cliente pode usá-la em um intervalo de tempo, como requisições por minuto ou tokens por minuto. As requisições acima do limite são recusadas, normalmente com HTTP 429 Too Many Requests, até que o uso volte a ficar abaixo dele.

[Tokens de entrada e de saída](https://broadrouter.com/pt/glossary/input-and-output-tokens/)

Tokens de entrada são os tokens que um modelo de linguagem lê em uma requisição, incluindo o system prompt, o histórico da conversa, as definições de ferramentas e as imagens. Tokens de saída são os que ele gera na resposta, incluindo o raciocínio. As APIs de LLM costumam cobrá-los separadamente, e a saída costuma custar mais.

## Perguntas frequentes

### O Roo Code ainda é mantido?

Não. O repositório no GitHub foi arquivado em 15 de maio de 2026 e o README diz que a extensão foi encerrada. Ele indica o Zoo Code (escrito ZooCode no aviso), um fork da comunidade, e o Cline. Instalações existentes continuam funcionando com as configurações abaixo, mas não recebem correções.

### Por que o Roo Code mostra erros de tool calling?

O Roo Code usa só tool calling nativo, sem fallback em XML. Use um modelo que a BroadNet lista com ferramentas, como broadnet/glm-5.3 ou broadnet/qwen3.8-27b.

### Por que o Roo Code recebe uma resposta vazia?

O modelo gastou o orçamento de saída raciocinando. GLM 5.3, Qwen3.8 27B e DeepSeek V4.1 Flash raciocinam primeiro, e o raciocínio conta no max\_tokens. Aumente Max Output Tokens em Model Configuration.

### Posso usar o plano ilimitado do DeepSeek com o Roo Code?

Os planos ilimitados cobrem o DeepSeek V4.1 Flash. A documentação da BroadNet não lista tool calling para ele, e o Roo Code exige tool calling, então teste numa hora de Meteor antes de comprar um mês.

## Guias relacionados

-   [Use o Cline com a BroadNet Inference (provedor OpenAI Compatible)](https://broadrouter.com/pt/guides/cline-openai-compatible/)
-   [Por que um modelo de raciocínio devolve uma resposta vazia](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/)
-   [Como funcionam os planos de API de LLM ilimitada para agentes](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/)
-   [Códigos de erro da BroadNet Inference e quando tentar de novo](https://broadrouter.com/pt/guides/errors-and-retries/)
-   [Todas as ferramentas que funcionam com a BroadNet Inference (em inglês)](https://broadrouter.com/integrations/): SDKs, agentes de programação, interfaces de chat e ferramentas de automação, com as configurações exatas de cada uma

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

[Começar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-roo-code-openai-compatible&utm_content=page-cta) ·

**Fontes**

-   [Repositório do Roo Code no GitHub (arquivado em 15 de maio de 2026, aviso de encerramento; conferido em 2026-11-14)](https://github.com/RooCodeInc/Roo-Code)
-   [Repositório do Zoo Code no GitHub, fork da comunidade que continua o Roo Code (conferido em 2026-11-16)](https://github.com/Zoo-Code-Org/Zoo-Code)
-   [Documentação do Roo Code, provedores OpenAI Compatible (conferido em 2026-11-14)](https://roocodeinc.github.io/Roo-Code/providers/openai-compatible)
-   [Referência da API da BroadNet Inference (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-roo-code-openai-compatible&utm_content=sources)
