Configurar Roo Code: API Key, Base URL e modelos

Para conectar o Roo Code à BetterToken, prepare uma API Key, informe a Base URL abaixo e escolha um ID de modelo atual na model plaza.

Configurações principais

Campo	Valor
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Modelo	Um ID atual da model plaza

Pré-requisitos

• A versão atual da ferramenta está instalada
• Uma BetterToken API Key: cadastre-se e crie uma
• Um ID de modelo da model plaza

Cadastre-se e obtenha uma BetterToken API Key→

Já tem uma conta? Entre, recarregue o saldo e crie uma chave no console.

Requisitos adicionais

• VS Code instalado

Instalação

Instalar o Roo Code

Abra o VS Code, pesquise Roo Code no marketplace de extensões e instale-o.

Configuração manual

Faça a configuração na interface do Roo Code. Não é necessário editar um arquivo.

Campo	Valor
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Modelo	Um ID atual da model plaza

Configuração

Remova variáveis de ambiente conflitantes

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Abra as configurações do Roo Code

Abra o painel Settings do Roo Code.

Configure o provedor de API

Preencha:

• API Provider → OpenAI Compatible
• Base URL → https://bettertoken.ai/v1
• API Key → sua BetterToken API Key
• Model → um ID de modelo disponível copiado da model plaza

Configure cabeçalhos extras apenas quando a documentação exigir

O material oficial do Roo Code se concentra em APIs personalizadas ou compatíveis com OpenAI, mas não trata um User-Agent extra como requisito da BetterToken.

Se você também usa um gateway personalizado ou uma camada de roteamento, observabilidade ou cache, adicione cabeçalhos apenas conforme a documentação oficial do serviço upstream.

Salve e comece a usar

Clique em Save e Done. Depois, selecione o modelo configurado.

Reinicie o Roo Code

Depois de salvar, reinicie o VS Code ou recarregue a extensão Roo Code antes de selecionar o modelo.

O Roo Code exige chamadas de ferramentas nativas compatíveis com OpenAI. Ele não tem fallback XML, então escolha um modelo e endpoint com suporte a chamadas de ferramentas nativas. Adicione cabeçalhos extras somente quando o gateway upstream exigir.

Teste a conexão

Envie um prompt curto. Se a ferramenta responder sem erro de autenticação ou de ID de modelo, a conexão funciona. Reinicie completamente a ferramenta após alterar a configuração.

Depois, peça ao Roo Code para ler um arquivo do projeto e resumi-lo. Confirme que ele executa a ferramenta de leitura de arquivos e usa o resultado; uma resposta em texto, por si só, não confirma o uso de ferramentas pelo agente.

Alterne entre modelos

Abra o seletor ou altere o campo Model na configuração. Use o ID exato da model plaza e reinicie a sessão atual.

Erros comuns

Erro	O que verificar
401 ou Unauthorized	Confira a BetterToken API Key e remova espaços nas extremidades.
404	Confira a Base URL e não acrescente um caminho de endpoint específico.
model not found	Copie um ID atual da model plaza.
Alterações não aplicadas	Salve a configuração e reinicie completamente a ferramenta.

• API compatível com OpenAI versus API compatível com Anthropic

• MCP versus API Key e Base URL

• O que são model_provider, base_url e wire_api?

• Como configurar uma API compatível com OpenAI no Cline

• Compare as ferramentas compatíveis

• Erros da API, códigos de status e limites de requisições

Detalhes técnicos

Protocolo, endpoint e campos internos do provedor

Esta configuração usa https://bettertoken.ai/v1. A ferramenta adiciona o caminho do endpoint compatível com OpenAI. Não acrescente /chat/completions nem /responses, a menos que um campo específico exija.