Configurações principais
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
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.Configuração
1
Remova variáveis de ambiente conflitantes
2
Abra as configurações do Roo Code
Abra o painel Settings do Roo Code.
3
Configure o provedor de API
Preencha:
- API Provider →
OpenAI Compatible - Base URL →
https://www.bettertoken.ai/v1 - API Key → sua BetterToken API Key
- Model → um ID de modelo de um provedor compatível copiado da model plaza
4
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.5
Salve e comece a usar
Clique em Save e Done. Depois, selecione o modelo configurado.
6
Reinicie o Roo Code
Depois de salvar, reinicie o VS Code ou recarregue a extensão Roo Code antes de selecionar o modelo.
O provedor OpenAI Compatible do Roo Code ainda depende de chamadas de ferramentas no estilo OpenAI. Se precisar de cabeçalhos extras, siga a documentação atual do Roo Code ou os requisitos do gateway upstream. Não presuma que
User-Agent seja obrigatório para a BetterToken.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.Alterne entre modelos
Abra o seletor ou altere o campoModel na configuração. Use o ID exato da model plaza e reinicie a sessão atual.
Erros comuns
- 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
Configuração avançada
Provedores compatíveis
Os status se aplicam ao método de configuração do BetterToken descrito nesta página.
O que significa cada método de configuração
O que significa cada método de configuração
- Configuração manual: informe a API Key, a Base URL e o Model.
- Sem suporte: ainda não há um método verificado de conexão direta.
Detalhes técnicos
Protocolo, endpoint e campos internos do provedor
Protocolo, endpoint e campos internos do provedor
Esta configuração usa
https://www.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.