Voltar ao blog

Ferramentas e integraçõesGuia

Arquivo de configuração do Aider para sua própria chave de API: .aider.conf.yml e setx no Windows

Mantenha sua própria chave de API e URL base no .aider.conf.yml, acerte a ordem de carregamento e evite a armadilha do setx no Windows, com uma estimativa de custo por sessão.

Por CheapTokens TeamPublicado em 4 min de leitura

Terminal com os comandos que conectam o Aider a uma API compatível com OpenAI
Nesta página
  1. Windows: setx e um novo terminal
  2. Qual modelo para quais edições
  3. Faça uma primeira edição
  4. Pare de redigitar: .aider.conf.yml
  5. Quanto custa uma sessão
  6. Se não funcionar

Duas variáveis, OPENAI_API_BASE e OPENAI_API_KEY, e um argumento de modelo como openai/<model id> são suficientes para apontar o Aider para a CheapTokens. O básico passo a passo (instalação, primeira requisição, 401/404/400/402) está em Como conectar o Aider à CheapTokens; esta página cobre o que aquele guia deixa de fora: Windows setx, o arquivo de configuração e sua ordem de carregamento, e uma estimativa de custo por sessão.

Fonte: a documentação do Aider para APIs compatíveis com OpenAI (página verificada em 26 de outubro de 2026; a documentação não mostra data nem versão, e o aider-chat mais recente no PyPI naquele dia era 0.86.2).

Windows: setx e um novo terminal#

No Mac e no Linux você export as duas variáveis. No Windows (PowerShell ou cmd) use setx:

bat
setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

No Windows há uma pegadinha. setx grava as variáveis para sessões futuras, não para a que você está usando, então feche o terminal e abra um novo antes de iniciar o Aider. Se você definir as variáveis e o Aider ainda pedir uma chave, este é o motivo mais comum.

Qual modelo para quais edições#

O argumento de modelo é openai/ mais o id completo, então para a CheapTokens ele tem duas barras:

bash
cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

O MiniMax-M2.7 tem contexto de 180K e responde até 8.192 tokens, adequado para edições pequenas e médias em que as respostas ficam curtas. Se suas edições voltarem como diffs longos, o outro modelo que vale a pena testar é o DeepSeek-V4-Flash: até 32.768 tokens por resposta, contexto de 380K e um único preço a qualquer hora do dia.

bash
aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

Copie o id completo da documentação da CheapTokens ou da lista de modelos em preços.

Faça uma primeira edição#

O Aider funciona dentro de um repositório git, então comece em um. Adicione um arquivo e peça algo pequeno:

text
> /add app.py
> Add a --verbose flag that prints each file before it is processed

Quando o Aider responde com uma edição no arquivo, a chave, a URL base e o id do modelo estão todos corretos.

O id de modelo errado ao lado do id completo que funciona, depois a primeira edição
Id errado versus id completo, e a primeira requisição

Pare de redigitar: .aider.conf.yml#

O Aider lê .aider.conf.yml do seu diretório home, depois da raiz do repositório git, depois do diretório atual, e os arquivos posteriores vencem. Assim, um arquivo global pode conter a chave e a base, e um arquivo do repositório pode escolher o modelo. Se você quiser um arquivo específico e nada mais, aider --config <file> carrega apenas esse.

Um arquivo no diretório home (exemplo, coloque sua própria chave):

yaml
openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

Agora aider sozinho inicia com o endpoint e o modelo corretos. Se você fizer commit do arquivo em um repositório, deixe a chave de fora e mantenha-a na variável de ambiente ou em um arquivo .env; as linhas da chave são para o seu próprio diretório home.

Para um modelo que o Aider não conhece, a documentação descreve um model-settings-file (.aider.model.settings.yml) onde você pode especificar suas configurações.

Quanto custa uma sessão#

O Aider reenvia os arquivos que você adicionou e o histórico do chat a cada mensagem, então os tokens de entrada crescem mais rápido que os de saída. Digamos que uma sessão de trabalho de cerca de 20 mensagens envie 400.000 tokens de entrada e receba 40.000 tokens de saída (uma suposição para o exemplo; use seus próprios números). No MiniMax-M2.7 isso dá $0.026, e é mais barato que a OpenRouter no total, com entrada e saída contadas juntas. A tabela abaixo executa a mesma sessão nos nossos modelos:

Modelo Custo OpenRouter
GLM-5.3-Flash $0.0096 $0.0196
DeepSeek-V4-Flash $0.01 $0.0253
MiniMax-M2.7 $0.026 $0.168

400.000 tokens de entrada e 40.000 tokens de saída no total. Os preços por 1M de tokens são atuais e mudam junto com nossas tarifas; a coluna OpenRouter mostra preços de referência para a mesma carga de trabalho.

Como manter o lado da entrada pequeno (arquivos somente leitura, /drop, tamanho do mapa do repositório) está em Quanto custa o Aider. Os preços atuais estão sempre na página de preços.

Se não funcionar#

  • O Aider pede uma chave de API ou fala com o serviço errado. As variáveis não estão visíveis para o processo. No Windows, reinicie o terminal após setx; no Mac e no Linux, execute echo $OPENAI_API_BASE no mesmo shell.
  • Sua configuração parece ignorada. Lembre-se da ordem: home, raiz do repositório, diretório atual. Um arquivo mais próximo de você sobrescreve o global.
  • Modelo não encontrado, 404 ou erro de autenticação. Esses casos estão em Como conectar o Aider à CheapTokens.

O mesmo endereço compatível com OpenAI funciona em outras ferramentas; se você também usa um agente de editor, veja conectar o OpenCode ou a visão geral de onde plugar sua própria chave de API.

Tags: