Custo do Aider: cliente gratuito e a verdadeira fatura da API

O Aider, assistente de IA de código aberto para programar no terminal, custa 0 por si só. Ele usa a licença Apache-2.0, e o aider.chat não oferece planos, níveis, assentos ou serviços gerenciados. Portanto, “custo do Aider” na prática significa a cobrança da API do modelo que você chama por meio dele. O que deve ser estimado é a quantidade de tokens por sessão multiplicada pelo preço unitário do fornecedor; o que mais facilmente aumenta esse valor é a configuração padrão usada quando o Aider encontra um ID de modelo que não reconhece — duas linhas resolvem isso, como veremos abaixo.

Primeiro, esclareça uma coisa, pois os resultados de busca se misturam: outra empresa, que oferece software de fechamento contábil para escritórios de contabilidade, também se chama Aider e publica uma mensalidade mínima. Esses preços pertencem àquele produto e não têm relação com esta CLI. Esta página trata apenas da CLI do aider.chat, isto é, a ferramenta distribuída pelo repositório Aider-AI/aider, cujo nome do pacote é aider-chat.

Quem recebe o pagamento e pelo quê

O FAQ do Aider afirma claramente que a ferramenta é distribuída como código aberto sob a licença Apache 2.0; a página inicial, o FAQ, a página de instalação e a página de conexão com LLM não contêm preços, planos ou assinaturas (verificado em 1º de outubro de 2026). Toda a cobrança ocorre na outra ponta do endpoint.

Antes de padronizar o uso pela equipe, verifique o estado das atualizações. 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 “versões mais recentes” oficiais também não coincidem: o PyPI lista 0.86.2, enviada em 12 de fevereiro de 2026, enquanto os GitHub Releases estão parados na v0.86.0 de 9 de agosto de 2025. pip install instala a versão do PyPI; use essa como referência. A versão do Python também deve seguir >=3.10,<3.13 nos metadados do pacote 0.86.2, pois essa é a condição efetivamente verificada pelo pip.

A configuração que mais afeta o custo da API

Esta é a parte que a tabela de preços não mostra. O Aider compara o ID do modelo com uma tabela interna para decidir o formato de edição, o mapa do repositório (repo map) e o comportamento do cache; a comparação usa toda a string escrita depois de --model, incluindo o prefixo. A página de configuração avançada do modelo informa que, quando não há correspondência, os padrões são edit_format: whole, use_repo_map: false, cache_control: false e weak_model_name: null.

No código-fonte oficial da versão 0.86.2, a comparação ocorre em duas etapas. Primeiro, ele procura uma correspondência exata entre 313 nomes completos, como gemini/gemini-3-pro-preview e openai/gpt-5.2; só depois, se não encontrar, usa regras de substring como sonnet-4-5, haiku-4-5 e gpt-4.1. Ao conectar um gateway compatível com OpenAI, o ID do modelo deve ser escrito como openai/<id>, enquanto os 40 itens iniciados por openai/ na tabela são nomes de modelos da própria OpenAI. Portanto, openai/claude-sonnet-4-6 não corresponde em nenhuma das duas etapas e opera com reescrita do arquivo inteiro (whole), com o mapa do repositório desativado — o modelo precisa reenviar o arquivo alterado completo a cada rodada, e os tokens de saída são justamente o lado mais caro da cobrança.

A correção exige apenas duas linhas. O Aider lê este arquivo do diretório pessoal, da raiz do git ou do diretório atual; a chave é o nome completo passado a --model:

# name 必須和傳給 --model 的字串完全一致（連 openai/ 前綴一起）
- name: openai/claude-sonnet-4-6
  edit_format: diff
  use_repo_map: true

Se for executar apenas uma vez, você também pode adicionar --edit-format diff ao iniciar. Já openai/claude-haiku-4-5 será reconhecido pela substring haiku-4-5 e receberá automaticamente diff e mapa do repositório — isso é apenas uma coincidência de nome, pode mudar a cada versão do Aider; confirme por conta própria e não dependa disso.

Há outro efeito fácil de ignorar. O Aider chama a API usando três papéis: o modelo principal, o modelo editor usado pelo modo --architect e o modelo weak, que escreve mensagens de commit e resumos do histórico da conversa (veja a explicação das opções). Quando o ID não é reconhecido, o código define weak e editor como o próprio modelo principal, fazendo com que os três papéis sejam cobrados pelo preço mais alto. Use --weak-model para especificar um ID mais barato e evitar isso (ele também precisa do prefixo openai/).

Por fim, um ID não reconhecido também faz o custo desaparecer da exibição: sem input_cost_per_token, o Aider imprime apenas a quantidade de tokens e não mostra a linha de custo; a página de avisos também diz que ele “presume que o modelo é gratuito”. O arquivo de metadados abaixo restaura a exibição:

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

Mesmo com os metadados preenchidos, o valor do Aider continua sendo apenas um cálculo próprio baseado nos tokens informados; o multiplicador de cache ainda fica fixado no valor de um fornecedor específico. Use-o como referência, mas sempre compare com os registros de uso do fornecedor.

Estimativa do custo de uma sessão

A seguir está uma aritmética de tokens, não o custo de uma tarefa medida nem um limite de cobrança. Suponha que uma sessão envie 200.000 tokens de entrada sem cache e receba 12.000 tokens de saída com edição diff; na coluna whole, suponha que o mesmo trabalho gere 40.000 tokens de saída por reescrever o arquivo inteiro (essa proporção é apenas ilustrativa, não uma medição). Os preços vêm dos valores atuais por milhão de tokens na tabela de preços do Kunavo.

Nessa hipótese, apenas o formato de edição faz com que o mesmo trabalho de Claude Sonnet 4.6 passe de $0.546 para $0.840; portanto, corrija primeiro a configuração e só depois compare os preços dos fornecedores. Se o tráfego de mensagens de commit e resumos (supondo entrada de 30.000 e saída de 2.000 tokens) permanecer no modelo principal, Claude Sonnet 4.6 custa $0.084; especificar Claude Haiku 4.5 como modelo weak custa $0.028.

Para transformar isso em orçamento, multiplique pelo número de sessões de trabalho por dia. Os valores da tabela de preços do Kunavo são um piso de cobrança, não um teto: quando o upstream informa um custo, a cobrança usa o maior entre o “valor da tabela” e “custo do upstream × margem aplicável”. Custos de cache e ferramentas externas não estão incluídos neste exemplo.

“A API mais barata” é, na verdade, duas perguntas

O Aider tem uma única referência de custo de tarefa que pode ser verificada novamente: seu benchmark polyglot usa 6 linguagens e 225 exercícios do Exercism, faz os modelos responderem em condições iguais e registra os custos.

Os números foram lidos do arquivo de dados do ranking. Há dois avisos mais importantes que a classificação: o registro mais recente é de 3 de outubro de 2025, portanto os modelos lançados depois disso não foram testados; a coluna de custo não informa tabela de preços nem data, e representa o custo daquela execução, não uma cotação disponível hoje. Esses modelos aparecem apenas como evidência de benchmark; o DeepSeek não está na tabela de preços do Kunavo, e o modelo barato usado na planilha acima é Claude Haiku 4.5.

A conclusão útil é: o o3-pro gastou cinco vezes mais que o gpt-5(high), mas obteve uma pontuação menor; preço alto não garante conclusão. Preço baixo também não garante menor custo total — um modelo barato que precise de três tentativas pode custar mais que um modelo caro que conclua de primeira. Primeiro escolha o modelo mais barato que consiga concluir o trabalho com uma carga de revisão aceitável; depois valide usando o custo real da tarefa registrado na conta. O /tokens do Aider, segundo a descrição do comando, é a “quantidade de tokens do contexto atual da conversa”, não o total já cobrado.

Para quem cada caminho é adequado

Há dois limites ao usar um gateway. Para gateways sem um módulo específico do Aider, a página da API compatível com OpenAI exige OPENAI_API_BASE, OPENAI_API_KEY e o prefixo obrigatório openai/ no ID do modelo; a documentação não descreve uma configuração para substituir a URL base do formato Anthropic, e o código-fonte da 0.86.2 também não contém a string ANTHROPIC_API_BASE. Além disso, não espere descontos de cache nesse caminho: a página de cache lista apenas fornecedores específicos, exige adicionar explicitamente --cache-prompts e, durante o streaming, não recebe estatísticas nem custos do cache. Esta página não testou se o cache funciona no caminho compatível.

Usar o Aider com o Kunavo e pagar em Taiwan

O Kunavo tem um guia de configuração para este cliente, mas ele é uma referência pública de configuração, não um teste de compatibilidade: não executamos o Aider de fato contra o endpoint do Kunavo, e todo o conteúdo desta página foi lido no código-fonte oficial da versão estável do Aider e em sua documentação oficial. Mantenha o caminho que já funciona, execute primeiro uma tarefa bem delimitada e depois examine o custo real registrado na conta.

O pagamento é um pré-pago com recarga, sem mensalidade. A recarga mínima é $10; esse é o valor mínimo para ativar o saldo, não uma tarifa por tarefa nem uma assinatura. O checkout usa o Stripe; em Taiwan, é possível usar cartões de crédito (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay e Link. Métodos locais de Taiwan, como JKOPay e LINE Pay, atualmente não estão na lista de opções disponíveis. Consulte as informações de cobrança e, quando estiver pronto, crie uma conta. Para ver a versão original mais completa em inglês, consulte Aider pricing.

Perguntas frequentes

O repositório, o pacote, a documentação e os dados do ranking do Aider foram verificados em 1º de outubro de 2026; as descrições de comportamento baseiam-se no código-fonte da versão oficial marcada como v0.86.2. Os preços unitários do Kunavo vêm da tabela atual; todos os exemplos de valores nesta página são aritmética de tokens para fins ilustrativos, não custos de tarefas medidos.