Configuração de Coding Agents

Configurar Aider: API Key, Base URL e modelos

Instale o Aider, configure a Base URL e a API Key da BetterToken, escolha um modelo disponível e corrija erros comuns. Com configuração e exemplos.

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

Configurações principais

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	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

Instale Python

Instalação

Instalar o Aider

Execute os comandos a seguir em um terminal:

python -m pip install aider-install
aider-install

Após a instalação, confirme que o Aider está disponível:

aider --help

Configuração manual

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

Configure a BetterToken no terminal atual

macOS / Linux

export OPENAI_API_BASE="https://bettertoken.ai/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

cd /path/to/your/project
aider --model openai/YOUR_MODEL_ID

Windows PowerShell

setx OPENAI_API_BASE "https://bettertoken.ai/v1"
setx OPENAI_API_KEY "YOUR_API_KEY"

Após setx, feche e reabra o PowerShell. Depois entre no diretório do projeto e execute:

aider --model openai/YOUR_MODEL_ID

Substitua YOUR_API_KEY pela sua BetterToken API Key. YOUR_MODEL_ID é apenas um exemplo. Substitua-o por um ID de modelo disponível atual da model plaza e mantenha o prefixo openai/.

Salve a configuração com .env

Para não definir variáveis sempre que abrir um terminal, crie um arquivo .env na raiz Git do projeto:

OPENAI_API_BASE=https://bettertoken.ai/v1
OPENAI_API_KEY=YOUR_API_KEY
AIDER_MODEL=openai/YOUR_MODEL_ID

Adicione .env ao .gitignore para que a API Key não seja enviada ao repositório. Depois entre no diretório do projeto e execute:

aider

Para usar outro arquivo em um projeto, informe-o explicitamente:

aider --env-file ./aider-bettertoken.env

Opcional: use .aider.conf.yml

Para persistir somente configurações não confidenciais, crie .aider.conf.yml no diretório pessoal ou do projeto:

model: openai/YOUR_MODEL_ID
openai-api-base: "https://bettertoken.ai/v1"

Mantenha a API Key na variável de ambiente OPENAI_API_KEY, e não em um arquivo YAML compartilhado.

Alterar o Model ID

Substitua o modelo no comando de inicialização por um ID de modelo disponível atual:

aider --model openai/YOUR_MODEL_ID

Não remova o prefixo openai/. O ID de modelo deve ser compatível com o endpoint configurado.

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

Trocar de modelo

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

Sintoma	O que fazer
`401`, `Unauthorized` ou `Invalid API key`	Verifique `OPENAI_API_KEY`, confirme que é uma BetterToken API Key e remova espaços extras.
`model not found` ou modelo indisponível	Copie um ID de modelo disponível atual da model plaza e passe-o ao Aider como `openai/model-id`.
URL de solicitação errada ou `404`	Confirme que `OPENAI_API_BASE` é `https://bettertoken.ai/v1`. Não acrescente `/chat/completions`.
Windows não lê as novas variáveis	`setx` afeta somente terminais abertos depois do comando. Feche a janela atual do PowerShell e abra outra.
Aider informa um modelo desconhecido	Primeiro verifique o ID de modelo e o provedor de API. O Aider pode mostrar um aviso para um modelo novo, mas você ainda precisa usar um ID atual da model plaza.

FAQ de configuração

Qual Base URL o Aider deve usar?

Use https://bettertoken.ai/v1. Esta é a Base URL da BetterToken compatível com OpenAI.

Por que o nome do modelo precisa do prefixo openai/?

O Aider usa esse prefixo para identificar um modelo compatível com OpenAI. Omiti-lo pode fazer o Aider selecionar o provedor errado.

Posso colocar a API Key em .aider.conf.yml?

Não recomendamos. Use variáveis de ambiente ou um arquivo .env ignorado pelo Git para reduzir o risco de expor uma API Key nos arquivos do projeto.

Configuração avançada

Guias relacionados

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.