Configuração de Coding Agents

Configurar Kilo Code: API Key, Base URL e modelos

Instale o Kilo Code, configure a Base URL e a API Key da BetterToken, escolha um modelo compatível e corrija erros comuns. Com exemplos e solução de erros.

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

Você conclui a configuração em três passos: adicione um Custom provider em Providers, selecione OpenAI Compatible e informe a BetterToken API Key, a Base URL e o Model ID. Depois, envie uma primeira solicitação curta para confirmar a conexão.

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

Se o Kilo Code já estiver instalado, vá direto para a configuração manual e informe sua BetterToken API Key, Base URL e Model ID.

Se ainda precisar instalar a extensão ou quiser o contexto de instalação e uso regional, consulte o guia em inglês de instalação e API personalizada do Kilo Code e depois volte para usar os campos de configuração atuais.

Configuração manual

Faça a configuração na interface do Kilo 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 Kilo Code

Abra Settings (ícone de engrenagem), selecione Providers e clique em Custom provider na parte inferior da lista.

Configure o provedor de API

Preencha:

Provider ID → bettertoken
Display name → BetterToken
Provider API → OpenAI Compatible
Base URL → https://bettertoken.ai/v1
API Key → sua BetterToken API Key
Models → adicione manualmente um Model ID copiado da model plaza e use o mesmo ID como nome de exibição

Clique em Submit para salvar o provedor. Estes são os campos da extensão VS Code no guia oficial de Custom Models.

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.

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.

Teste a conexão

Abra uma nova conversa no Kilo Code e envie uma solicitação curta, como Reply with one word: OK. Se a ferramenta responder sem erro de autenticação ou de Model ID, a primeira solicitação funcionou. Reinicie o VS Code ou a extensão após alterar a configuração. Se houver falha, vá para Erros comuns.

Kilo CLI

Instale o Kilo CLI oficial separadamente da extensão. Nos testes em macOS com um modelo GPT, o Kilo CLI 7.8.17 concluiu solicitações de texto e chamadas de ferramentas para leitura de arquivos por /v1/chat/completions.

Defina sua BetterToken API Key no terminal:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Crie kilo.json no projeto. Substitua todas as ocorrências de YOUR_MODEL_ID pelo ID exato da model plaza:

{
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://bettertoken.ai/v1",
        "apiKey": "{env:BETTERTOKEN_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": { "name": "YOUR_MODEL_ID" }
      }
    }
  },
  "model": "bettertoken/YOUR_MODEL_ID",
  "permission": { "read": "allow", "edit": "deny", "bash": "deny" },
  "agent": { "build": { "steps": 4 } }
}

Aponte KILO_CONFIG para esse arquivo e execute uma verificação de texto não interativa:

export KILO_CONFIG="$PWD/kilo.json"
kilo run --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

Confira se a resposta final é OK. Essa configuração permite ler arquivos e nega edições e comandos de shell. Informar o arquivo por KILO_CONFIG faz dele uma fonte de configuração confiável, na qual as referências {env:...} podem ser expandidas. Uma configuração de projeto carregada apenas do repositório não expande referências a variáveis de ambiente; mantenha a seleção explícita de KILO_CONFIG acima.

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.

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.