Skip to main content
Para conectar o Kodacode à BetterToken, prepare uma API Key, informe a Base URL abaixo e escolha um ID de modelo atual na model plaza.

Configurações principais

Pré-requisitos

Requisitos adicionais

  • O VS Code está instalado
  • A extensão Kodacode / Koda está instalada
  • O ID de modelo selecionado vem de um provedor compatível

Instalação

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

Configuração manual

Configuração

1

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.
Escolha Add model: Agent no seletor de modelos do painel Koda.
2

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

Na caixa de diálogo para adicionar modelo, use estes valores:Após preencher os campos, clique em Connect.
Selecione Any OpenAI-compatible API na caixa de diálogo de adição de modelo do Kodacode e preencha API Base, Model ID e API Key.
3

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.
4

Verifique config.yaml

O Kodacode grava a configuração em ~/.koda/config.yaml. Abra esse arquivo para confirmar que o modelo foi adicionado.
config.yaml do Kodacode com a configuração do modelo compatível com OpenAI adicionada.

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.
Se você usar um modelo diferente de YOUR_MODEL_ID, atualize name e model para que correspondam ao ID de modelo de um provedor compatí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

  • Se a conexão falhar, confirme que API Base é https://www.bettertoken.ai/v1/ e mantenha a / final.
  • Se o modelo não estiver disponível, confirme que Model ID vem do provedor compatível.
  • 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

Provedores compatíveis

Os status se aplicam ao método de configuração do BetterToken descrito nesta página.
  • 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.

Guias relacionados

Detalhes técnicos

Esta configuração usa https://www.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.