Custos do Aider: cliente gratuito e custos reais da API

O Aider, ferramenta de programação em dupla com IA de código aberto usada no terminal, tem custo de 0 para o próprio programa. É um software Apache-2.0, e o aider.chat não oferece planos, níveis, assentos ou serviço de hospedagem. Portanto, “custo do Aider” significa, na prática, as tarifas da API do modelo chamadas por meio do Aider. Ao fazer o orçamento, observe o número de tokens por sessão × a tarifa do provedor; o que mais facilmente aumenta esse número é uma configuração padrão aplicada a um ID de modelo que o Aider não reconhece. Duas linhas resolvem isso, como explicamos a seguir.

Primeiro, uma distinção importante. Os resultados de pesquisa também misturam outro Aider, homônimo, que vende software de fechamento contábil para empresas de contabilidade. As mensalidades publicadas por essa empresa pertencem ao produto dela e não têm relação com este CLI. Esta página trata apenas do CLI do aider.chat, ou seja, da ferramenta distribuída como o pacote aider-chat no repositório Aider-AI/aider.

O que você paga ao Aider e o que é realmente cobrado

O FAQ do Aider informa que a ferramenta é distribuída como código aberto Apache 2.0, e não há menções a preços, planos ou assinaturas na página inicial, no FAQ, na página de instalação ou na página de conexão com LLM (verificado em 1º de outubro de 2026). Toda cobrança ocorre do outro lado do endpoint.

Antes de adotá-lo como ferramenta padrão da equipe, verifique também o estado das atualizações. O repositório não foi arquivado e tem 49.309 estrelas, mas main teve seu último commit em 22 de maio de 2026 (API do GitHub, 1º de outubro de 2026). A “versão mais recente” oficial também difere entre dois locais. O PyPI lista 0.86.2, publicada em 12 de fevereiro de 2026, enquanto o GitHub Releases parou na v0.86.0, de 9 de agosto de 2025. O que é instalado por pip install é a versão do PyPI. Para a versão do Python, >=3.10,<3.13 nos metadados do pacote 0.86.2 é a condição realmente aplicada pelo pip, não a descrição da página de instalação.

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

É a parte que não aparece na tabela de preços. O Aider determina 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 incorporada. O valor usado na comparação é a string completa, incluindo o prefixo, escrita após --model. Quando nada corresponde, os padrões, segundo a página de configuração de modelos avançados, são edit_format: whole, use_repo_map: false, cache_control: false e weak_model_name: null.

No código oficial da versão 0.86.2, a comparação ocorre em duas etapas. Primeiro, há uma comparação exata com 313 nomes completos, como gemini/gemini-3-pro-preview e openai/gpt-5.2; somente quando nenhum corresponde é que se passa às regras de substring, como sonnet-4-5, haiku-4-5 e gpt-4.1. Ao conectar-se a um gateway compatível com OpenAI, a regra é passar o ID do modelo como openai/<id>, mas os 40 itens com o prefixo openai/ na tabela são todos nomes de modelos próprios da OpenAI. Por isso, openai/claude-sonnet-4-6 não corresponde em nenhuma das duas etapas e funciona no estado reescrever o arquivo inteiro (whole), mapa do repositório desativado. O modelo reimprime o arquivo modificado inteiro a cada turno, e os tokens de saída são a parte mais cara da fatura.

São necessárias duas linhas para corrigir isso. O Aider lê este arquivo no diretório inicial, na raiz do git e no diretório atual, e 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 usá-lo apenas uma vez, você também pode acrescentar --edit-format diff ao executar. Por outro lado, openai/claude-haiku-4-5 corresponde à substring haiku-4-5 e ativa automaticamente o diff e o mapa do repositório. Como o nome pode coincidir por acaso e mudar entre versões do Aider, não dependa disso; verifique diretamente.

Há mais um efeito fácil de ignorar. O Aider chama a API com três papéis: o modelo principal, o modelo editor no modo --architect e o modelo weak usado para mensagens de commit e resumos do histórico da conversa (referência de opções). Quando o ID não é reconhecido, o código configura weak e editor para o modelo principal, fazendo com que os três papéis sejam cobrados pela tarifa mais cara. Você pode evitar isso especificando um ID barato com --weak-model (o prefixo openai/ também é necessário aqui).

Por fim, a exibição do custo também desaparece com IDs não reconhecidos. Sem input_cost_per_token, o Aider exibe apenas a contagem de tokens e, conforme a página de avisos, “presume que o modelo é gratuito”. É possível restaurá-la com o arquivo de metadados a seguir.

{
  "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 exibido pelo Aider é calculado por ele a partir dos tokens informados, e o multiplicador de cache também é codificado para valores específicos de provedores. Use-o como referência e faça a confirmação final comparando com o histórico de uso do provedor.

Estimativa do custo de uma sessão

Abaixo está um cálculo de tokens, não o custo medido de um trabalho nem um limite de cobrança. Suponha que uma sessão envie 200.000 tokens de entrada não armazenados em cache e receba 12.000 tokens de saída em uma edição diff. A coluna whole supõe, apenas para explicação, que o mesmo trabalho gere 40.000 tokens de saída por reimprimir o arquivo inteiro (não é uma medição). As tarifas são os preços atuais por milhão de tokens do catálogo da Kunavo.

Nessa hipótese, apenas o formato de edição faz o mesmo trabalho de Claude Sonnet 4.6 passar de $0.546 para $0.840. É por isso que você deve corrigir as configurações antes de comparar tarifas de provedores. Se as mensagens de commit e o tráfego de resumo (pressupondo 30.000 tokens de entrada e 2.000 de saída) também usarem o modelo principal, o custo com Claude Sonnet 4.6 será $0.084; ao definir o modelo weak como Claude Haiku 4.5, será $0.028.

Para usar isso em um orçamento real, multiplique pelo número de sessões diárias. O valor do catálogo da Kunavo é um piso da cobrança, não um teto. Quando o provedor upstream informa um custo, é cobrado o maior valor entre o “valor do catálogo” e o “custo upstream × margem aplicável”. As tarifas de cache e as ferramentas externas não estão incluídas neste exemplo.

“A API mais barata” são duas perguntas

O Aider tem um único padrão de custo de trabalho que pode ser verificado novamente. O benchmark polyglot faz modelos resolverem 225 problemas do Exercism em 6 linguagens, nas mesmas condições, e registra o custo.

São valores lidos do arquivo de dados da tabela de classificação. Há duas ressalvas mais importantes que a posição. A linha mais recente é de 3 de outubro de 2025, portanto modelos lançados depois disso nunca foram medidos aqui. Além disso, a coluna de custo não contém preço nem data; é apenas o custo daquela execução naquele dia, não a tarifa disponível hoje. Os modelos citados aqui servem como evidência do benchmark, e o DeepSeek não está no catálogo da Kunavo. Na tabela de estimativas acima, Claude Haiku 4.5 é o modelo correspondente ao lado de menor custo.

A conclusão utilizável é esta: o3-pro gastou cinco vezes mais que gpt-5(high) e obteve uma pontuação menor; portanto, uma tarifa alta não compra conclusão. Uma tarifa baixa também não garante o menor total. Um modelo barato que tenta três vezes pode custar mais que um modelo caro que termina de primeira. Escolha como candidato o modelo mais barato que conclui o trabalho dentro de um nível de revisão aceitável e confirme usando o valor efetivamente registrado na conta para essa tarefa. /tokens do Aider é, conforme a definição da referência de comandos, a quantidade de tokens do contexto atual da conversa, não o total cobrado até agora.

Quando cada rota é adequada

Duas limitações da rota do gateway. Um gateway sem módulo exclusivo do Aider conecta-se conforme a página da API compatível com OpenAI, usando OPENAI_API_BASE, OPENAI_API_KEY e o prefixo obrigatório openai/ no ID do modelo. A documentação não apresenta uma configuração para alterar a URL base no formato Anthropic, e a string ANTHROPIC_API_BASE também não existe no código-fonte 0.86.2. Não espere descontos de cache de prompt nessa rota. A página de cache limita os provedores-alvo, exige ativar explicitamente --cache-prompts e informa que as estatísticas e o custo do cache não podem ser vistos durante o streaming. Esta página não testou se o cache permanece ativo na rota compatível.

Como usar com a Kunavo e pagar a partir do Brasil

A Kunavo tem um guia de configuração para este cliente. Porém, ele é apenas material de referência pública de configuração, não um teste de compatibilidade. Não foi realizada uma validação executando o Aider de fato em um endpoint da Kunavo; todo o conteúdo desta página foi lido no código-fonte oficial do Aider e na documentação oficial. Mantenha a rota atual, execute uma tarefa com escopo definido e verifique o valor registrado na conta.

O pagamento é um carregamento pré-pago, sem mensalidade. O valor mínimo de carregamento é $10, o valor mínimo para criar saldo, não uma taxa de tarefa nem uma assinatura. O pagamento é feito no checkout da Stripe; na Coreia, é possível usar cartões (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay e Link, e, quando a tela de pagamento aparece em won sul-coreano, também aparecem KakaoPay, Naver Pay, PAYCO, Samsung Pay e cartões nacionais, inclusive cartões que não permitem pagamentos internacionais. A conversão para won sul-coreano inclui uma taxa de conversão de 2–4% paga pelo comprador, que não é aplicada ao pagar em dólares (documentação da Stripe sobre Adaptive Pricing, verificado em 2026-10-03). Toss não é aceito. Esses métodos carregam o saldo da Kunavo usado pelo Aider; não são pagamentos diretos à Anthropic ou à OpenAI. Consulte Informações sobre pagamentos para obter detalhes e, quando estiver pronto, crie uma conta. O texto original mais detalhado em inglês é Aider pricing.

Perguntas frequentes

O repositório, o pacote, a documentação e os dados da tabela de classificação do Aider foram verificados em 1º de outubro de 2026, e a descrição do comportamento baseia-se no código-fonte da tag oficial v0.86.2. As tarifas da Kunavo vêm do catálogo em tempo real, e todos os exemplos monetários desta página são cálculos ilustrativos de tokens, não custos de trabalhos medidos.