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
Instale ou abra o Kilo Code e prossiga com a configuração manual abaixo.Configuração manual
Faça a configuração na interface do Kilo Code. Não é necessário editar um arquivo.Configuração
1
Remova variáveis de ambiente conflitantes
2
Abra as configurações do Kilo Code
Abra a interface de configurações do Kilo 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 Kilo Code menciona cabeçalhos personalizados opcionais para provedores compatíveis com OpenAI, mas não trata
User-Agent 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
Reinicie o Kilo Code
Depois de alterar a configuração, reinicie o VS Code ou recarregue a extensão Kilo Code para aplicar os novos valores.
Se precisar de cabeçalhos extras, siga a documentação atual do Kilo 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.