Aider com Claude e GPT por uma API compatível com OpenAI

O Aider é uma ferramenta open source de programação em par com IA que roda no terminal. Você o inicia dentro de um repositório git, adiciona arquivos ao chat e descreve a mudança desejada; o Aider edita os arquivos e faz o commit do resultado no git. O Aider se comunica com os modelos pela biblioteca LiteLLM, então funciona com qualquer API compatível com OpenAI, incluindo a APIVAI. Você paga por token a partir de um saldo pré-pago, sem assinatura.

O Aider escolhe o formato da API pelo prefixo do nome do modelo:

Escolha a rota compatível com OpenAI se quiser uma configuração única para todos os modelos e alternar livremente entre Claude e GPT. Escolha a rota Anthropic se você trabalha principalmente com Claude e quer a opção --cache-prompts do Aider, que usa o cache de prompts do Claude para que o contexto repetido (o mapa do repositório e os arquivos do chat) seja cobrado pelo preço mais barato de leitura de cache. As duas rotas usam a mesma chave da APIVAI.

Atenção ao /v1: a base URL da OpenAI termina em /v1, a da Anthropic não, porque o LiteLLM acrescenta /v1/messages sozinho. ANTHROPIC_API_BASE é uma variável de ambiente do LiteLLM e não aparece na referência de opções do próprio Aider, mas o Aider a respeita porque todas as chamadas aos modelos passam pelo LiteLLM. Os detalhes dos dois formatos estão na página API compatível com OpenAI e na documentação.

1. Cadastre-se em apivai.com
2. Recarregue o saldo a partir de $10 com cartão, cripto, Alipay ou WeChat Pay
3. Crie uma chave no Dashboard (você pode dar a ela um limite de orçamento próprio) e copie

A documentação do Aider recomenda este instalador:

No macOS ou Linux:

No Windows:

Depois do setx, abra uma nova janela de terminal: a janela onde você rodou o comando não enxerga os novos valores.

Digite o ID do modelo exatamente depois do prefixo openai/. Para usar GPT, inicie com --model openai/gpt-5.5 ou troque dentro da sessão com /model openai/gpt-6-sol.

Por que --edit-format diff: o Aider escolhe um formato de edição pelo nome do modelo. Para nomes que não reconhece, ele volta para whole, em que o modelo reescreve cada arquivo editado por inteiro, o que gasta muito mais tokens de saída. diff envia só os blocos alterados e funciona bem com os modelos atuais de Claude e GPT.

O Aider lê um arquivo .env do seu diretório pessoal, da raiz do repositório git e do diretório atual. Com esse arquivo, basta rodar aider:

O modelo fraco (weak model) escreve as mensagens de commit e resume o histórico do chat, então um modelo barato ali economiza sem prejudicar a qualidade do código. Mantenha a chave fora do git: deixe o arquivo no diretório pessoal ou adicione .env ao .gitignore.

No Windows, use setx como no passo 3. Sempre passe --model: sem ele, o Aider escolhe o próprio modelo padrão, que pode não ser o que você quer.

Preços por 1M de tokens de entrada / saída em 2026-10-07. A lista de modelos muda com o tempo, então pegue os IDs em GET https://api.apivai.com/v1/models ou na página de preços em vez de copiar nomes antigos.

Um bom padrão é Claude Sonnet 4.6 como modelo principal e Claude Haiku 4.5 como weak model. Para uma tarefa difícil, o modo architect do Aider deixa um modelo forte planejar e um mais barato escrever as edições, por exemplo aider --architect --model openai/claude-opus-5-5 --editor-model openai/claude-sonnet-4-6.

Cada requisição do Aider envia o mapa do repositório, os arquivos adicionados ao chat e a conversa até ali. Considere uma requisição típica de cerca de 15.000 tokens de entrada e 1.500 de saída (tokens de raciocínio contam como saída) com o Claude Sonnet 4.6:

• Uma requisição: $0.0234 ($0.0675 no preço oficial).
• Um dia de trabalho com 60 requisições: $1.41 ($4.05 no preço oficial).
• Um mês com 22 dias assim (1.320 requisições): $30.93 ($89.10 no preço oficial).

O mesmo mês com o Claude Haiku 4.5 sairia por $10.38, e com o GPT-6 Luna por $0.437. Para gastar menos, tire com /drop os arquivos que não precisa mais, limpe históricos longos com /clear e use --cache-prompts na rota Anthropic. O Dashboard lista cada requisição com tokens e custo; a comparação de preços da API do Claude mostra todos os modelos ao lado dos preços oficiais.

• 401 / AuthenticationError: a chave está errada, foi apagada ou ficou sem orçamento, ou a variável não está definida neste terminal. Depois do setx no Windows, abra uma nova janela.
• 404 / NotFoundError: a base URL está errada. OPENAI_API_BASE deve terminar em /v1 exatamente uma vez (nem /v1/v1, nem sem ele). ANTHROPIC_API_BASE não deve conter /v1.
• "LLM Provider NOT provided": o nome do modelo está sem prefixo. Escreva openai/claude-sonnet-4-6, não claude-sonnet-4-6.
• Model not found: o ID depois do prefixo deve ser idêntico a um ID de GET /v1/models, não um nome de exibição.
• Respostas vazias ou cortadas: o raciocínio (thinking) vem ativado por padrão e seus tokens consomem o limite de saída. Aumente o limite para todos os modelos em .aider.model.settings.yml (diretório pessoal ou raiz do repositório):

• 429: o limite padrão é de 60 requisições por minuto por chave. Aguarde um pouco ou peça ao suporte um limite maior.
• "Unknown context window size and costs, using sane defaults": aviso inofensivo para modelos que o Aider não conhece. Oculte-o com --no-show-model-warnings. Por causa disso, o Aider pode mostrar custo de $0.00; os números reais estão no Dashboard.

Sim. Na rota compatível com OpenAI, uma chave e uma base URL cobrem os dois; troque com /model openai/gpt-5.5 ou /model openai/claude-sonnet-4-6.

Não. Você só precisa de uma chave da APIVAI e de saldo pré-pago. Não há assinatura e você paga apenas pelos tokens que usar.

Ela permite usar --cache-prompts, que barateia o mapa do repositório e os arquivos reenviados. Se você também quer modelos GPT, a rota compatível com OpenAI é mais simples.

Não. O conteúdo das requisições e respostas não é registrado; só dados de uso como modelo, tokens e custo são guardados para cobrança.

Em qualquer ferramenta que aceite um endpoint compatível com OpenAI ou com Anthropic, por exemplo o Continue no VS Code e no JetBrains, ou o Claude Code (veja o guia de configuração do Claude Code).

Crie uma conta, recarregue a partir de $10 e cole sua chave no Aider.