Configuração do Kodacode: API Key, Base URL e erros 429

Para conectar o Kodacode à BetterToken, prepare uma API Key, informe a Base URL abaixo e escolha um ID de modelo atual na model plaza. Se o erro ocorrer no MonkeyCode, consulte o guia separado do MonkeyCode.

Configurações principais

Campo	Valor
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Modelo	Um ID de modelo 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

• O VS Code está instalado
• A extensão Kodacode / Koda está instalada
• Copie o Model ID exato da model plaza.

Instalação

Instale ou abra o Kodacode e continue com a configuração manual abaixo.

Configuração manual

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

Configuração

Abra o painel Koda e adicione um modelo

Abra o painel KODA na barra lateral do VS Code, clique no seletor de modelos abaixo da caixa de entrada e escolha Add model: Agent.

Preencha as configurações do modelo compatível com OpenAI

Na caixa de diálogo para adicionar modelo, use estes valores:

Campo	Valor recomendado
Provider	Any OpenAI-compatible API
API Base	https://bettertoken.ai/v1/
Model ID	Um ID de modelo disponível da model plaza, por exemplo YOUR_MODEL_ID
API Key	Sua BetterToken API Key

Após preencher os campos, clique em Connect.

Confirme que o modelo está ativo

Depois que a conexão for bem-sucedida, selecione o novo modelo, como YOUR_MODEL_ID, no seletor abaixo da caixa de entrada do Koda. Envie uma mensagem curta para confirmar que ele retorna uma resposta.

Verifique config.yaml

O Kodacode grava a configuração em ~/.koda/config.yaml. Abra esse arquivo para confirmar que o modelo foi adicionado.

Exemplo de config.yaml

Use esta estrutura completa como referência. Substitua YOUR_API_KEY pela sua BetterToken API Key e não envie uma API Key real ao repositório.

name: Koda
version: 0.0.1
schema: v1
models:
  - name: Koda Models
    provider: koda-chat-models
    model: AUTODETECT
    roles:
      - agent
      - chat
      - edit
  - name: YOUR_MODEL_ID
    provider: openai
    model: YOUR_MODEL_ID
    apiKey: YOUR_API_KEY
    apiBase: https://bettertoken.ai/v1/
    roles:
      - agent
      - chat
      - edit
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase

Se você usar um modelo diferente de YOUR_MODEL_ID, atualize name e model para que correspondam ao ID de modelo disponível da model plaza.

Verifique a conexão

Envie um prompt de teste curto. Se a ferramenta retornar uma resposta sem erro de autenticação ou de ID de modelo, a conexão funciona. Reinicie completamente a ferramenta depois de alterar a configuração.

Alterne entre modelos

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

Erros comuns

Erro	O que verificar
401 ou Unauthorized	Verifique a BetterToken API Key e remova espaços no início ou no fim.
404	Verifique a Base URL e não acrescente um caminho de endpoint específico.
model not found	Copie um ID de modelo atual da model plaza.
As alterações não são aplicadas	Salve a configuração e reinicie completamente a ferramenta.

• Se a conexão falhar, confirme que API Base é https://bettertoken.ai/v1/ e mantenha a / final.
• Copie o Model ID exato da model plaza.
• Se a autenticação falhar, copie a API Key novamente e evite espaços extras ou quebras de linha.
• Se as alterações em config.yaml não forem aplicadas, reinicie o VS Code ou execute Developer: Reload Window.
• A BetterToken geralmente não exige User-Agent adicional nem cabeçalhos personalizados.

Advanced setup

Guias relacionados

• Visão geral do plugin Kodacode

• Guia de instalação do plugin Kodacode

• 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 acrescenta o caminho de endpoint compatível com OpenAI. Não adicione /chat/completions ou /responses, exceto quando um campo específico exigir isso.