Custos do Aider: CLI gratuito, cobrança da API e a rota mais barata

Aider, o assistente de programação de IA de código aberto para o terminal, custa 0 €. O software está sob Apache-2.0, e o aider.chat não oferece tarifas, planos, assentos nem um serviço hospedado — na prática, o “custo do Aider” é a conta da API do modelo que você acessa por meio dele. Você deve orçar os tokens por sessão multiplicados pela tarifa do seu provedor. E a configuração que mais facilmente aumenta esse valor é o comportamento padrão do Aider diante de um ID de modelo que ele não conhece — corrigido com duas linhas, como descrito abaixo.

Antes, uma distinção importante, porque os resultados de busca misturam as duas coisas: outra empresa que vende software para o fechamento mensal de escritórios de contabilidade também opera como Aider e publica um valor mínimo mensal. Esses preços pertencem àquele produto. Esta página trata apenas da CLI do aider.chat, distribuída como o pacote aider-chat do repositório Aider-AI/aider.

O que o Aider cobra — e o que realmente é cobrado de você

O FAQ do Aider afirma claramente que a ferramenta é publicada como código aberto sob Apache 2.0; na página inicial, no FAQ, na página de instalação e nas páginas de LLM não há preço, tarifa nem assinatura (verificado em 1º de outubro de 2026). A cobrança surge inteiramente do outro lado do endpoint.

Verifique o ritmo de lançamentos antes de comprometer uma equipe com ele. O repositório não está arquivado e tem 49.309 estrelas, mas o último commit em main foi em 22 de maio de 2026 (API do GitHub, 1º de outubro de 2026). As duas declarações oficiais sobre a “versão mais recente” também divergem: o PyPI fornece 0.86.2, de 12 de fevereiro de 2026, enquanto os lançamentos do GitHub terminam em v0.86.0, de 9 de agosto de 2025. pip install instala a versão do PyPI. Para Python, vale a exigência dos metadados do pacote 0.86.2, >=3.10,<3.13 — é isso que o pip realmente impõe, não a indicação mais ampla da página de instalação.

A configuração que mais influencia seus custos de API

Essa é a parte que as tabelas de preços não mostram. O Aider escolhe o formato de edição, o mapa do repositório (Repo Map) e o comportamento do cache comparando o ID do modelo com uma tabela integrada — e a comparação usa a string completa depois de --model, incluindo o prefixo. Se nada corresponder, segundo a página de configurações avançadas de modelos, aplicam-se edit_format: whole, use_repo_map: false, cache_control: false e weak_model_name: null.

No código da versão 0.86.2, a comparação ocorre em duas etapas: primeiro, uma correspondência exata contra 313 nomes completos (como gemini/gemini-3-pro-preview ou openai/gpt-5.2); somente se nada corresponder, são usadas regras de substring que incluem, entre outras, sonnet-4-5, haiku-4-5 e gpt-4.1. Para um gateway compatível com OpenAI, o ID deve ser passado como openai/<id> — e as 40 entradas com o prefixo openai/ na tabela são, sem exceção, nomes de modelos próprios da OpenAI. Portanto, openai/claude-sonnet-4-6 não corresponde a nada, e o Aider trabalha com reescrita de arquivos inteiros, sem mapa do repositório: em cada rodada, o modelo emite novamente cada arquivo editado por completo. Os tokens de saída são o lado caro da conta.

Duas linhas resolvem isso. O Aider lê esse arquivo do diretório inicial, da raiz do Git ou do diretório atual; a chave é o nome completo de --model:

# name muss exakt dem String entsprechen, den Sie an --model übergeben (inkl. Präfix)
- name: openai/claude-sonnet-4-6
  edit_format: diff
  use_repo_map: true

Para uma execução única, --edit-format diff basta. Inversamente, openai/claude-haiku-4-5 corresponde por substring a haiku-4-5 e recebe automaticamente o formato diff e o mapa do repositório — um acaso da nomenclatura que pode mudar a cada versão do Aider. Verifique, em vez de confiar nisso.

Há ainda um segundo efeito, mais discreto: o Aider chama a API em três funções — o modelo principal, um modelo de edição para o modo --architect e um modelo Weak para mensagens de commit e resumos do histórico (consulte a referência de opções). Quando o ID é desconhecido, o código define Weak e Editor como o modelo principal; as três funções passam a usar a tarifa mais cara. Com --weak-model, você nomeia um ID barato (com o mesmo prefixo openai/).

Por fim, com um ID desconhecido, a exibição de custos também desaparece: sem input_cost_per_token, o Aider mostra apenas tokens, sem linha de custos, e a página de avisos confirma que ele então “presume que o modelo seja gratuito”. Um arquivo de metadados a restaura:

{
  "openai/claude-sonnet-4-6": {
    "input_cost_per_token": 0.0000021000,
    "output_cost_per_token": 0.0000105000,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

Mesmo com metadados, o valor do Aider é um cálculo próprio baseado nos tokens informados, com fatores de cache fixos de um único provedor. Use-o como uma estimativa contínua e compare-o com o registro de consumo do seu provedor.

Um cálculo de exemplo por sessão

O que segue é aritmética de tokens, não custos de tarefas medidos nem um limite superior da cobrança. Presume-se uma sessão com 200.000 tokens de entrada não armazenados em cache e 12.000 tokens de saída no formato diff. Para a coluna “arquivo inteiro”, presume-se que o mesmo trabalho gere 40.000 tokens de saída, porque os arquivos editados retornam completos — uma proporção ilustrativa, não uma medição. As tarifas são os preços atuais do catálogo da Kunavo por milhão de tokens.

Com essas premissas, somente o formato de edição move Claude Sonnet 4.6 o custo do mesmo trabalho de $0,546 para $0,840: corrija primeiro a configuração e só depois compare os provedores. O tráfego de mensagens de commit e resumos (presumidos em 30.000 tokens de entrada e 2.000 de saída) custa $0,084 em Claude Sonnet 4.6, contra $0,028 quando você nomeia Claude Haiku 4.5 como modelo Weak.

Multiplique pelo número de sessões diárias antes de transformar isso em um orçamento. O valor do catálogo da Kunavo é um piso da cobrança, não um teto: se o upstream informar seus custos, será calculado o maior valor entre o custo do catálogo e o custo do upstream multiplicado pelo acréscimo aplicável. Cache e ferramentas externas não estão incluídos neste exemplo.

“API mais barata” são duas perguntas diferentes

O Aider publica o único indicador verificável de custo de tarefas para esta ferramenta: o benchmark Polyglot faz cada modelo resolver as mesmas 225 tarefas do Exercism em seis linguagens e registra o custo em dólares. Nós o citamos aqui como evidência de custo, não como recomendação de modelo — ainda falta uma medição comparativa própria dos modelos no Aider.

Lido do arquivo de dados do ranking. Duas ressalvas são mais importantes do que a ordem: a linha mais recente é de 3 de outubro de 2025, portanto tudo lançado depois nunca foi medido ali; e a coluna de custos não informa tabela de preços nem data — mostra quanto aquela execução custou naquele dia, não um preço disponível hoje. Os modelos aparecem aqui como evidência do benchmark; o DeepSeek não está no catálogo da Kunavo, e o equivalente barato na tabela acima é Claude Haiku 4.5.

A regra útil é: o3-pro custou cinco vezes mais que gpt-5 (high), com resultado pior — uma tarifa alta não compra conclusão. E uma tarifa baixa também não garante a menor soma: um modelo barato que precisa de três tentativas pode custar mais do que um caro que acerta na primeira. Escolha o modelo mais barato que conclua seu trabalho com um esforço de verificação aceitável e confirme usando o valor que sua conta registrou para exatamente essa tarefa. O /tokens do Aider mede, segundo a referência de comandos, o contexto do chat atual, não a soma já cobrada.

Qual rota usar em cada situação

Duas limitações da rota de gateway. Um gateway sem módulo próprio é conectado pelo caminho compatível documentado; consulte a página sobre APIs compatíveis com OpenAI: OPENAI_API_BASE, OPENAI_API_KEY e o prefixo obrigatório openai/. A substituição da URL base no formato Anthropic não é documentada, e a string ANTHROPIC_API_BASE não aparece no código da versão 0.86.2. Nesse caminho, também não conte com descontos de cache: a página de cache limita o cache a determinadas famílias de provedores, exige o sinalizador --cache-prompts e informa que as estatísticas e os custos de cache não estão disponíveis durante o streaming. Esta página não testou se o cache sobrevive ao caminho compatível.

Usar o Aider com a Kunavo — e pagar a partir da Alemanha

A Kunavo publica um guia de configuração para este cliente. Ele é uma referência de configuração, não um teste de compatibilidade: o Aider não foi executado contra o endpoint da Kunavo, e tudo acima vem do código publicado e da documentação do Aider. Mantenha uma rota funcional, inicie uma tarefa delimitada e depois leia o valor registrado pela sua conta.

O pagamento é feito por uma recarga pré-paga, sem assinatura. A recarga mínima é de $10 — um valor mínimo para o saldo, não um preço por tarefa nem um plano. O checkout é processado pela Stripe: cartões (Visa, Mastercard, American Express), Apple Pay, Google Pay e Link; o débito direto SEPA não é oferecido atualmente, mas um cartão de débito vinculado à conta corrente funciona normalmente. O saldo não expira. Detalhes em Faturamento; quando estiver pronto, crie uma conta. A versão detalhada em inglês deste guia está em Preços do Aider.

Perguntas frequentes

Repositório, pacote, documentação e dados do ranking do Aider verificados em 1º de outubro de 2026; o comportamento descrito foi lido no código da versão publicada v0.86.2. As tarifas da Kunavo vêm ao vivo do catálogo, e cada exemplo em dólares é uma aritmética ilustrativa de tokens, não um custo de tarefa medido.