Preços do Aider: a CLI gratuita, a cobrança da API e a rota mais barata

O Aider, assistente de programação de terminal de código aberto, custa $0. Ele é um software Apache-2.0, e o aider.chat não anuncia planos, níveis, assentos nem um serviço hospedado; portanto, na prática, "preços do Aider" significa a cobrança da API do modelo que você utiliza por meio dele. O número que vale a pena incluir no orçamento é a quantidade de tokens por sessão à tarifa do seu provedor — e a configuração com maior probabilidade de aumentá-la é o padrão próprio do Aider para um ID de modelo que ele não reconhece, uma correção de duas linhas explicada abaixo.

Primeiro, uma desambiguação, porque os resultados de busca misturam os dois. Uma empresa diferente, do setor de software contábil, também atua como Aider e publica um mínimo mensal para automação do fechamento de períodos. Esses preços pertencem àquele produto. Esta página trata apenas da CLI em aider.chat, distribuída como o pacote aider-chat do repositório Aider-AI/aider.

O que o Aider cobra e o que efetivamente gera cobrança

A FAQ do Aider afirma claramente que a empresa por trás dele publica a ferramenta como código aberto sob Apache 2.0, e nenhum texto sobre preço, plano ou assinatura aparece na página inicial, na FAQ, na página de instalação ou nas páginas de conexão com LLM (todas verificadas em 18 de setembro de 2026). A cobrança fica inteiramente do outro lado do endpoint.

Verifique a cadência de lançamentos antes de padronizá-lo para uma equipe. O repositório não está arquivado e tem 49.040 estrelas — o selo da própria página inicial do aider.chat ainda mostra 44K; portanto, consulte a API, não a página. O último commit em main é datado de 22 de maio de 2026, e há 1.378 issues abertas e 500 pull requests abertas (API do GitHub, 18 de setembro de 2026). As duas visualizações oficiais de "versão mais recente" também divergem: o PyPI disponibiliza a 0.86.2, enviada em 12 de fevereiro de 2026, enquanto as versões do GitHub param em v0.86.0, de 9 de agosto de 2025. Confie no PyPI para o que pip install fornece e confirme no seu próprio ambiente. O trabalho mesclado desde então está em main como 0.86.3.dev (aider/__init__.py) e não está em nenhuma versão instalável.

Mais uma inconsistência para resolver no seu próprio ambiente antes de instalar: a página de instalação do Aider anuncia Python 3.8–3.13 para o instalador de inicialização e 3.9–3.12 para pip e pipx, enquanto os metadados do pacote 0.86.2 no PyPI declaram >=3.10,<3.13. Os metadados do pacote são o que o pip realmente impõe; portanto, verifique seu interpretador em relação a eles, não à prosa.

A configuração que mais altera o custo da API do Aider

A própria página inicial do Aider ainda diz que ele funciona melhor com Claude 3.7 Sonnet, DeepSeek R1 e V3, e OpenAI o1, o3-mini e GPT-4o, e sua página de LLM cita um conjunto semelhante de meados de 2025. Essa recomendação está desatualizada, e segui-la literalmente em 2026 não é a recomendação aqui — mas as datas importam por um motivo que vai além da escolha do modelo.

Esta é a parte que as tabelas de preços não mostram. O Aider escolhe seu formato de edição, mapa do repositório e comportamento de cache fazendo a correspondência do ID do modelo com uma tabela integrada, e o ID que chega a essa tabela é a string com prefixo que você digita depois de --model. Os padrões publicados para qualquer coisa que não corresponda são edit_format: whole, use_repo_map: false, cache_control: false e weak_model_name: null, segundo a página de configurações avançadas de modelos.

No código-fonte publicado do 0.86.2, essa consulta ocorre em duas etapas, e a distinção determina se tudo isso se aplica a você. Primeiro, o Aider compara o ID que você passou com uma tabela distribuída de 313 entradas indexadas pelo nome totalmente qualificado — a string inteira, incluindo o prefixo; portanto, gemini/gemini-3-pro-preview e openai/gpt-5.2 estão ambos nela e correspondem exatamente. Somente quando nada corresponde ele recorre às regras de substring, que, entre outras, capturam sonnet-4-5, opus-4-6, haiku-4-5, 3-7-sonnet, 3-5-sonnet, gpt-4, gpt-4.1, um segmento final exato gpt-5, os IDs o1 e o3-mini, DeepSeek V3 e R1, Llama-3 70B e alguns IDs do Qwen.

O detalhe importante para um endpoint personalizado é o prefixo. Para acessar um deles, é preciso passar o ID como openai/<id>, e as 40 linhas com prefixo openai/ nessa tabela são todas nomes de modelos da própria OpenAI. Portanto, openai/claude-sonnet-4-6 não corresponde a nenhuma linha da tabela nem a nenhuma regra de substring, e o comando que a própria página de configuração do Kunavo imprime — aider --model openai/claude-sonnet-4-6 — executa edições do arquivo inteiro com o mapa do repositório desativado. Arquivo inteiro significa que o modelo reemite cada arquivo editado completo a cada turno, e os tokens de saída são o lado caro da cobrança. Verifique seu próprio ID nas duas etapas em vez de presumir qualquer resultado: por exemplo, um ID do Gemini 3 tem entradas exatas sob os prefixos gemini/ e openrouter/ do Aider e nenhuma sob openai/.

Duas linhas corrigem isso. O Aider lê este arquivo do seu diretório pessoal, da raiz do git ou do diretório atual, indexado pelo mesmo nome totalmente qualificado que você passa para --model.

# The name must match the string you pass to --model, prefix included.
- name: openai/claude-sonnet-4-6
  edit_format: diff
  use_repo_map: true

Uma execução pontual pode usar --edit-format diff em vez disso. Há também uma particularidade que vale conhecer: como essa correspondência da segunda etapa é uma substring, openai/claude-haiku-4-5 corresponde a haiku-4-5 e obtém automaticamente o formato diff e o mapa do repositório, enquanto o ID do Sonnet 4.6 não obtém. Isso é um acidente de nomenclatura, não uma propriedade do provedor, e pode mudar em qualquer versão do Aider — verifique novamente em vez de depender disso.

Há um segundo efeito, mais discreto. O Aider cobra por três funções de modelo: o modelo principal, um modelo de edição usado pelo modo --architect, e um modelo fraco usado para mensagens de commit e para resumir o histórico do chat (consulte a referência de opções). Quando o ID não é reconhecido, o código-fonte publicado define tanto o modelo fraco quanto o modelo de edição como o próprio modelo principal. As três funções passam então a ser cobradas pela sua tarifa mais cara. A própria documentação de modos do Aider já avisa que o modo de arquiteto "usa duas solicitações de LLM, o que pode levar mais tempo e aumentar os custos"; com um ID não reconhecido, ambas as solicitações são a mais cara. O Aider documenta --weak-model, e o código-fonte publicado cria esse modelo pelo mesmo construtor que o principal; portanto, o mesmo prefixo openai/ se aplica, e um ID barato pode ser nomeado explicitamente ali.

Por fim, um ID não reconhecido também silencia a exibição de custos. No código-fonte publicado, se o modelo não tiver uma entrada input_cost_per_token, o Aider imprime as contagens de tokens e retorna antes da linha de custo — não mostra nada, não $0.00 — e a página de avisos confirma que ele "presumirá que o modelo é gratuito". Restaure isso com um arquivo de metadados:

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

Adicione max_input_tokens também se quiser que o aviso de contexto seja preciso; a página de limites de tokens do Aider afirma que ele nunca impõe limites de tokens e apenas informa os erros de limite de tokens do provedor. Mesmo com os metadados fornecidos, o valor em dólares do Aider é um cálculo próprio sobre os tokens informados — o código publicado fixa multiplicadores de cache de um fornecedor — portanto, trate-o como uma estimativa contínua e concilie-o com o livro contábil do seu provedor.

Uma estimativa prática do custo da API do Aider

Estes são cálculos de tokens, não custos de tarefas medidos nem um teto de cobrança. Suponha uma sessão que envie 200.000 tokens de entrada sem cache e receba 12.000 tokens de saída sob diff. Para a coluna de arquivo inteiro, suponha que a mesma sessão emita 40.000 tokens de saída porque os arquivos editados são reenviados integralmente — essa proporção é uma suposição ilustrativa, não uma medição. As tarifas são preços atuais do catálogo do Kunavo por milhão de tokens.

Duas leituras. Primeiro, sob essas suposições, apenas o formato de edição move Claude Sonnet 4.6 de $0.546 para $0.840 pelo mesmo trabalho, motivo pelo qual a seção de configuração vem antes desta: comparar tarifas de provedores antes de corrigir o formato de edição é comparar a coisa errada. Segundo, o tráfego de mensagens de commit e de resumo que se concentra no modelo principal também não é gratuito: uma suposição de 30.000 tokens de entrada e 2.000 de saída custa $0.084 em Claude Sonnet 4.6 contra $0.028 se você nomear Claude Haiku 4.5 como modelo fraco.

Escale esses valores pelas suas próprias sessões diárias antes de tratá-los como orçamento. O valor do catálogo do Kunavo é um piso de cobrança, não um teto: quando o upstream informa sua cobrança, a fatura é o maior entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável. Cobranças de cache e ferramentas externas ficam fora deste exemplo. A recarga mínima do Kunavo é $10 em crédito pré-pago, que é um mínimo de financiamento, não uma taxa por tarefa nem uma assinatura — consulte detalhes de cobrança.

API mais barata para o Aider: duas perguntas diferentes

O Aider publica o único ponto de referência de custo de tarefa que pode ser rechecado nesta ferramenta: seu benchmark poliglota executa os mesmos 225 exercícios do Exercism em seis linguagens e registra um custo em dólares por modelo. Essas execuções separam "tarifa mais barata" de "mais barato para concluir" melhor do que qualquer tabela de preços.

Lido do arquivo de dados da tabela de classificação em 18 de setembro de 2026. Duas ressalvas importam mais do que a classificação. A linha mais recente nesse arquivo é datada de 3 de outubro de 2025; portanto, nada lançado desde então foi submetido a benchmark aqui, e o carimbo posterior de "última atualização" no rodapé da página reflete o horário de edição do arquivo, não uma execução mais recente. Além disso, a tabela de classificação não informa nenhuma lista de preços nem data para sua coluna Cost; portanto, cada valor é o que aquela execução custou na data em que ocorreu, não uma cotação que você possa comprar hoje. Esses modelos são citados como evidência do benchmark; o DeepSeek, em particular, não está no catálogo do Kunavo, e o equivalente da faixa barata na tabela acima é Claude Haiku 4.5.

A regra útil: o o3-pro custou cinco vezes o gpt-5 (alto) e teve uma pontuação menor; portanto, uma tarifa alta não compra conclusão, e uma tarifa baixa também não garante o menor total — um modelo barato que precise de três tentativas pode custar mais do que um que precise de uma. Faça uma lista dos modelos menos caros que concluam seu trabalho com o esforço de revisão que você aceita e verifique-a contra o uso que sua conta do provedor realmente registrou para essa tarefa. O /tokens do Aider não é esse número: sua referência de comandos o define como um relatório dos tokens usados pelo contexto de chat atual; portanto, ele dimensiona a próxima solicitação, em vez de totalizar as solicitações e tentativas já cobradas. Para uma análise mais detalhada desse método, consulte otimização de custos de IA.

Melhor API para o Aider: qual rota vence em cada situação

Há dois limites práticos para a rota de gateway. Para um gateway para o qual o Aider não tem módulo de provedor, o caminho documentado é o compatível com OpenAI: OPENAI_API_BASE, OPENAI_API_KEY e um prefixo openai/ obrigatório no ID do modelo, segundo a página de APIs compatíveis com OpenAI. Essa não é a única rota de terceiros documentada pelo Aider — o OpenRouter tem sua própria página, sua própria OPENROUTER_API_KEY e um prefixo openrouter/, motivo pelo qual seus IDs se comportam de forma diferente do caminho compatível genérico. OPENAI_API_BASE também é a única substituição de URL base documentada pelo Aider: não existe uma opção --anthropic-api-base, e a string ANTHROPIC_API_BASE não aparece em nenhum lugar da árvore 0.86.2. Portanto, a forma documentada de acessar um gateway é por chat completions. O Aider oferece uma opção geral --set-env ENV_VAR=value para controlar as configurações da API; portanto, interprete isso como a ausência de uma rota documentada para o protocolo Messages, e não como um bloqueio demonstrado. E não faça orçamento contando com economias de cache de prompts nessa rota: a página de cache de prompts do Aider cita as famílias específicas de fornecedores para as quais ele faz cache, exige a opção --cache-prompts ativada explicitamente e afirma que estatísticas e custos de cache ficam indisponíveis durante o streaming. Esta página não testou se os blocos de cache sobrevivem ao caminho compatível até algum gateway. Cache de prompts explica como ficam as tarifas quando uma rota oferece esse suporte.

O OpenRouter é o gateway estabelecido aqui, e o Aider o documenta nativamente em sua página do OpenRouter, incluindo controles de roteamento de provedores; compare-o pela tarifa e pelas condições de financiamento, não pela profundidade da integração. Consulte alternativas ao OpenRouter e API compatível com OpenAI para essa comparação, e API Claude mais barata se Claude for a família que você escolheu.

Configure e verifique a primeira cobrança

O Kunavo publica um guia de configuração para este cliente. Essa é uma referência de configuração publicada, não um teste de compatibilidade: o Aider não foi testado em tempo de execução aqui contra o endpoint do Kunavo, e tudo acima foi extraído do código-fonte publicado do Aider e de sua própria documentação. Mantenha uma rota funcional disponível enquanto testa, execute uma tarefa limitada e depois leia a cobrança registrada pela sua conta. Não faça a conciliação com /tokens — ele informa o tamanho do contexto de chat atual, não quanto a sessão gastou — e observe que, com um ID que o Aider não reconhece, ele também não imprime uma linha de custo, que é a segunda razão pela qual vale a pena escrever o arquivo de configurações acima. Comece pelo guia de integração do Aider e crie uma conta no Kunavo quando estiver pronto para financiar uma chave.

Comparando clientes em vez de provedores? Preços do Cline e Preços do OpenCode abordam dois agentes com a mesma separação entre um cliente gratuito e uma cobrança de API medida.

Perguntas frequentes

Repositório, pacote, documentação e dados da tabela de classificação do Aider verificados em 18 de setembro de 2026; as afirmações sobre comportamento foram lidas na tag publicada v0.86.2. As tarifas de tokens do Kunavo vêm do catálogo atual, e todos os exemplos em dólares nesta página são cálculos ilustrativos de tokens, não custos de tarefas medidos.