Aider e Claude Code não são duas versões da mesma ferramenta: Aider é uma CLI gratuita de programação em dupla, sob a licença Apache-2.0, que edita os arquivos que você entrega e faz commit de cada alteração no git, enquanto Claude Code é um agente proprietário da Anthropic que planeja, executa comandos e pede permissão. A diferença de configuração não pode apagar é o protocolo que cada um usa para se comunicar com um endpoint de terceiros — Aider usa chat-completions da OpenAI, enquanto Claude Code precisa de um dos três formatos no padrão da Anthropic, dos quais Anthropic Messages é o formato exposto por um gateway simples — e esse único fato determina quais modelos você pode acessar, qual plano paga e quanto custa a migração.
Primeiro, uma desambiguação, porque a página de resultados mistura os dois. Uma empresa diferente, de software de contabilidade, também atua como Aider e publica preços para automação de fechamento de períodos. Esses preços pertencem àquele produto. Esta página trata da CLI de programação em aider.chat, distribuída como o pacote aider-chat de Aider-AI/aider, e do Claude Code, distribuído como @anthropic-ai/claude-code. Se você está escolhendo entre o assistente Claude e a CLI, e não entre duas CLIs, Claude vs Claude Code é a página correspondente.
Qual você deve escolher
| Decida com base em | Escolha o Aider quando | Escolha o Claude Code quando |
|---|---|---|
| Fluxo de trabalho | Você quer conduzir o processo: adicionar arquivos específicos ao chat, revisar um diff e manter cada alteração em seu próprio commit | Você quer que a ferramenta explore, execute comandos e encadeie etapas sem receber cada arquivo antecipadamente |
| Permissões | Um comando de shell proposto pelo modelo fica condicionado a um sim explícito, e as edições entram como commits do git que você pode reverter | Você quer modos de permissão graduados e ampliá-los deliberadamente, com sandboxing e checkpoints por baixo |
| Protocolo e plano | Seu endpoint é compatível com a OpenAI, ou você quer modelos de vários laboratórios em uma única instalação; não há uma conta para substituir | Seu endpoint fala Anthropic Messages, e você aceita que uma credencial de gateway suspenda a assinatura claude.ai naquela sessão |
| Caminho de custo | Somente tokens medidos, sem taxa de software, assento ou assinatura envolvidos | Uma assinatura fixa se ajusta à sua cadência, ou você quer deliberadamente cobrança por token contra uma chave sua |
| Custo da migração | Você vem de um editor simples: duas variáveis de ambiente e um ID de modelo são suficientes para começar | Você vem do Aider: nada é transferido, porque os dois leem arquivos de configuração completamente diferentes |
Mais um fator para a escolha, expresso como datas em vez de adjetivos. O repositório do Aider está ativo e não foi arquivado, mas o último commit em main é de 22 de maio de 2026, e a versão instalável mais recente é aider-chat 0.86.2, de 12 de fevereiro de 2026 — a anterior foi lançada em 13 de agosto de 2025 (PyPI e o histórico de commits de main, verificados em 21 de setembro de 2026). O Claude Code publicou oito versões npm nos seis dias até 19 de setembro de 2026 — 2.1.271 a 2.1.278 — com latest em 2.1.278 e a tag stable em 2.1.267 (registro npm, verificado no mesmo dia). Não foi encontrada nenhuma declaração de mantenedor sobre a direção do Aider; interprete a lacuna como evidência de cadência, não como um anúncio.
A fronteira dos protocolos, em dois blocos
# Aider — OpenAI chat-completions. The openai/ prefix is mandatory: it is
# what tells Aider to speak that protocol to OPENAI_API_BASE instead of
# resolving the id against its own provider table.
export OPENAI_API_BASE=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...
aider --model openai/claude-sonnet-5
# Claude Code — Anthropic Messages. ANTHROPIC_BASE_URL is an ORIGIN; the
# client appends /v1/messages itself, so a value ending in /v1 produces
# /v1/v1/messages. The credential variable picks an HTTP header.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# Pin models Kunavo serves. Claude Code's default and its opus/sonnet aliases
# follow Anthropic's newest models; the sonnet alias asks for Sonnet 5.5, which
# Kunavo does not serve, so unpinned, /model sonnet, opusplan's execution phase
# and sonnet subagents 404. Opus 5.5 needs Claude Code v2.1.280 or later
# (claude update).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
claudeA página de APIs compatíveis com a OpenAI do Aider documenta exatamente esse par de variáveis e afirma que você deve prefixar o nome do modelo com openai/. O guia de compatibilidade de gateways do Claude Code afirma que um gateway deve expor pelo menos um de três formatos — Anthropic Messages selecionado por ANTHROPIC_BASE_URL, Amazon Bedrock InvokeModel com CLAUDE_CODE_USE_BEDROCK=1 ou rawPredict da Agent Platform do Google Cloud com CLAUDE_CODE_USE_VERTEX=1. Um endpoint de chat-completions da OpenAI não está em nenhuma das duas listas. Ambos verificados em 21 de setembro de 2026.
Duas consequências costumam causar problemas. Primeiro, a variável de credencial escolhe um cabeçalho: ANTHROPIC_AUTH_TOKEN envia Authorization: Bearer, ANTHROPIC_API_KEY envia x-api-key, e a opção errada chega ao gateway em um cabeçalho que ele não lê, falhando com 401. Segundo, o Aider decide o formato de edição, o mapa do repositório e a exibição de custo comparando o ID fornecido com uma tabela incluída no pacote — portanto, um ID de gateway com prefixo openai/ que ele não reconhece recai em edições do arquivo inteiro sem linha de custo, algo que preços do Aider explica por completo. O fallback equivalente do Claude Code é diferente: para um ID que não reconhece, ele presume uma janela de contexto de 200K, ou 1M quando o ID contém [1m]. O Aider, para um ID desconhecido, presume uma janela ilimitada e um modelo gratuito.
Fluxo de trabalho, permissões e ferramentas
| Comportamento | Aider (versão 0.86.2) | Claude Code (2.1.x) |
|---|---|---|
| Licença e código-fonte | Apache-2.0, distribuído como código-fonte no PyPI | Proprietário: o campo license do npm contém "SEE LICENSE IN README.md", o pacote não tem dependências e sua entrada bin é um executável compilado. Seu repositório no GitHub contém o changelog, exemplos e plugins, sem árvore de código-fonte para o cliente |
| Modos de chat | code, ask, architect e help; o modo arquiteto faz duas solicitações ao modelo por turno, algo que a própria documentação do Aider alerta que "pode levar mais tempo e aumentar os custos" | Seis modos de permissão, desde apenas leitura até tudo; o modo em que uma sessão começa depende do plano ou do provedor |
| Loop de ferramentas | Sem suporte a MCP e sem seleção de ferramentas orientada pelo modelo em 0.86.2; o único uso que faz do campo tools é uma função nomeada forçada para os formatos de edição do *_func | Subagentes, hooks, comandos, skills, plugins e servidores MCP, todos disponíveis em todos os provedores |
| Comandos de shell | Condicionado: um comando proposto pelo modelo exibe "Run shell command?" e exige um sim explícito. --yes-always altera isso | Governado pelo modo de permissão em vigor; skip-permissions cobre o modo mais amplo e o que ele custa para você |
| Git | Faz commit de cada edição, faz commit primeiro das alterações sujas preexistentes e acrescenta "(aider)" aos metadados de autor e committer. Desative com --no-auto-commits, --no-dirty-commits ou --no-git | Lida com fluxos de trabalho do git quando solicitado, em vez de fazer commit automático de cada edição; os checkpoints oferecem um caminho separado para retroceder |
| Instruções do projeto | Um arquivo de convenções somente quando passado com --read; nenhum tratamento automático de CONVENTIONS.md ou AGENTS.md em 0.86.2 | CLAUDE.md é carregado em todos os provedores; AGENTS.md exige uma sessão que busque flags de recursos |
O comportamento do Aider foi obtido do código-fonte lançado da versão 0.86.2 e de aider.chat/docs/git.html e da página de modos; o comportamento do Claude Code veio de disponibilidade de recursos e modos de permissão. Tudo verificado em 21 de setembro de 2026.
Quanto cada um custa, nos mesmos termos
| Item | Aider | Claude Code |
|---|---|---|
| O cliente | $0 — Apache-2.0, e aider.chat não anuncia plano, nível, assento ou serviço hospedado | Incluído em um plano Claude, ou executado contra uma chave sua |
| Assinatura individual | Não existe | Pro por "$20 se cobrado mensalmente", ou $17 por mês no desconto anual ($200 cobrados antecipadamente). Max "A partir de $100 por mês" |
| Assentos | Não existe | Assento padrão de equipe $20 por assento/mês com cobrança anual, $25 mensal. Enterprise US$20/assento/mês com cobrança anual, mais uso às taxas da API |
| Tokens | O endpoint para o qual OPENAI_API_BASE aponta cobra de você | Por token do responsável pela credencial, depois que uma credencial de gateway ou chave do Console está ativa |
| Gasto observado | Nenhum valor publicado | A própria página de custos da Anthropic informa "cerca de $13 por desenvolvedor por dia ativo e $150-250 por desenvolvedor por mês" em implantações empresariais, com custos abaixo de $30 por dia ativo para 90% dos usuários |
Os valores dos planos foram obtidos de claude.com/pricing e os valores de gasto da página de custos da Anthropic, ambas verificadas em 21 de setembro de 2026. Três ressalvas. A faixa de gasto empresarial se aplica a implantações empresariais e não representa uma pessoa ou uma equipe pequena. Um preço do Max 20x não é publicado no HTML renderizado pelo servidor daquela página, portanto esta página não o imprime — preços do Claude Code usa a mesma forma segura. E duas páginas da Anthropic divergem sobre o assento premium de equipe: a página de preços informa $100 por assento/mês com cobrança anual ($125 mensal), enquanto a página de integrações de terceiros informa "Teams: $150/seat (Premium)". Confirme o valor do assento no checkout; esta página não escolhe um deles.
Uma estimativa calculada na mesma sessão
Isto é aritmética ilustrativa de tokens, não um custo medido de tarefa nem um teto de cobrança. Suponha dez turnos, cada um carregando 200,000 tokens de contexto e produzindo 3,000 tokens de saída. As duas colunas diferem apenas quanto ao contexto é cobrado novamente como entrada nova a cada turno ou lido à taxa de leitura do cache depois que um turno o grava. As tarifas são preços atuais do catálogo da Kunavo por milhão de tokens; cobranças de gravação no cache e quaisquer ferramentas externas estão excluídas.
| Modelo | Entrada / saída por 1M | Leitura de cache por 1M | Cada turno sem cache | Contexto lido do cache |
|---|---|---|---|---|
| Claude Haiku 4.5 | $0.70 / $3.50 | $0.07 | $1.505 | $0.371 |
| Claude Sonnet 5 | $1.40 / $7.00 | $0.14 | $3.010 | $0.742 |
| Claude Opus 5 | $3.50 / $17.50 | $0.35 | $7.525 | $1.855 |
Por que esta tabela, e não um preço cliente contra cliente: a diferença entre essas duas colunas é a única alavanca de custo que se comporta de modo diferente em cada ferramenta. No lado do Claude Code, não é uma configuração que você escolhe — o guia de compatibilidade da Anthropic afirma que, quando um gateway não encaminha cache_control inalterado, "Não há erro: a conversa é cobrada como entrada sem cache em todos os turnos". No lado do Aider, não há um padrão comparável a perder, porque o cache de prompts depende da opção --cache-prompts ativada explicitamente, e a página de cache de prompts do Aider nomeia famílias específicas de fornecedores; não foi testado aqui se os blocos de cache sobrevivem ao caminho compatível com a OpenAI até um endpoint arbitrário. Sob essas suposições, a diferença em Claude Sonnet 5 é de $3.010 contra $0.742 nos mesmos dez turnos. Cache de prompts explica a mecânica.
O valor do catálogo da Kunavo é um piso de cobrança, não um teto: quando o upstream informa sua cobrança, a fatura é o maior valor entre o custo do catálogo e o custo do upstream multiplicado pelo markup aplicável. O recarregamento mínimo é de $10 em crédito pré-pago — um mínimo de financiamento, não uma taxa de tarefa ou uma assinatura. Consulte detalhes de cobrança.
O que um endpoint de terceiros não pode alcançar
No Aider, o limite está na documentação, não no plano. As strings ANTHROPIC_API_BASE e ANTHROPIC_BASE_URL não aparecem em nenhum lugar da árvore lançada da versão 0.86.2, e --openai-api-base é a única substituição de URL base que ele oferece — portanto, não existe uma rota documentada de Anthropic Messages no Aider. Ele oferece uma opção geral --set-env, então interprete isso como ausência na documentação, não como um bloqueio demonstrado. O reconhecimento do ID do modelo é o verdadeiro gate, e API compatível com a OpenAI descreve o formato dessa rota.
No Claude Code, os limites são explícitos e vale conhecê-los antes de se comprometer. O próprio cliente desativa Remote Control e as configurações gerenciadas pelo servidor sempre que ANTHROPIC_BASE_URL não é api.anthropic.com. Uma lista separada exige login no claude.ai e fica inacessível com qualquer credencial de gateway: sessões na nuvem, celular, Slack, Routines, Ultrareview, Code Review, Remote Control, a extensão do Chrome, uso do computador, Artifacts e ditado por voz. Desktop é a exceção parcial documentada nessa lista — a Anthropic afirma que o roteamento por gateway pode ser configurado no aplicativo ou por um administrador, e que o Claude Desktop em 3P executa sua aba Code no Amazon Bedrock, na Agent Platform do Google Cloud, no Microsoft Foundry ou em um gateway auto-hospedado. A busca de ferramentas MCP fica desativada por padrão atrás de um host que não seja de primeira parte, e o streaming granular de ferramentas fica desativado a menos que CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1 esteja definido. A descoberta de modelos é opcional por meio de CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, consulta GET /v1/models?limit=1000, trata qualquer redirecionamento como falha e mantém apenas IDs que contenham claude ou anthropic. A Anthropic também afirma que não oferece suporte ao roteamento do Claude Code para modelos que não sejam Claude por meio de qualquer gateway — por isso claude-code-router, um projeto de terceiros, é documentado separadamente e não como um recurso oficial.
Configure qualquer um dos dois e depois leia a primeira cobrança
A Kunavo documenta os dois protocolos no mesmo host, em caminhos diferentes: https://api.kunavo.com/v1 no formato da OpenAI para o Aider e https://api.kunavo.com como uma origem no formato Anthropic Messages para o Claude Code. Essa é uma referência de configuração publicada, não um resultado de compatibilidade — nenhum cliente foi testado em tempo de execução contra o endpoint aqui, e a lista de recursos do Claude Code acima depende de comportamentos do gateway (anthropic-beta pass-through, cache_control preservação, pings keep-alive, count_tokens, /v1/models) que ninguém verificou nele. Mantenha uma rota funcional disponível enquanto testa qualquer um deles, execute uma única tarefa limitada e leia a cobrança realmente registrada na sua conta. Comece pelo guia de integração do Aider ou pelo guia de integração do Claude Code, usando ANTHROPIC_BASE_URL para a armadilha entre origem e /v1, e crie uma conta Kunavo quando estiver pronto para financiar uma chave.
Ainda está reduzindo as opções? opencode vs Claude Code e Cline vs Claude Code comparam outros dois clientes na mesma questão de protocolo, e alternativas ao Aider aborda o que mais ocupa o espaço do terminal.
Perguntas frequentes
Qual é a diferença entre o Aider e o Claude Code?
Aider é um assistente de programação de linha de comando gratuito, sob a licença Apache-2.0, que edita os arquivos adicionados ao chat e faz commit de cada alteração no git; Claude Code é uma ferramenta agentiva proprietária da Anthropic que, em suas próprias palavras, lê sua base de código, edita arquivos, executa comandos e se integra às suas ferramentas de desenvolvimento. A diferença estrutural é o protocolo que cada um usa para se comunicar com um endpoint de terceiros. A rota documentada do Aider é a de chat-completions da OpenAI: OPENAI_API_BASE, OPENAI_API_KEY e o prefixo obrigatório openai/ no ID do modelo. Claude Code exige exatamente um de três formatos — Anthropic Messages, Amazon Bedrock InvokeModel ou rawPredict da Agent Platform do Google Cloud — e um endpoint de chat-completions da OpenAI não está entre eles. Um endpoint que ofereça apenas um desses dois protocolos só pode atender a um desses dois clientes.
O Aider ainda é mantido em 2026?
O repositório está ativo e não foi arquivado — Aider-AI/aider, Apache-2.0 —, mas a cadência é o fato que vale verificar, e é melhor expressá-la por datas. O último commit na branch principal é de 22 de maio de 2026. A versão instalável mais recente é aider-chat 0.86.2, enviada ao PyPI em 12 de fevereiro de 2026, e a versão anterior foi lançada em 13 de agosto de 2025. O GitHub Releases termina em v0.86.0, de 9 de agosto de 2025, portanto as duas visões oficiais sobre o que conta como a versão mais recente divergem; é o PyPI que o pip install resolve. O trabalho incorporado desde 0.86.2 está na main como 0.86.3.dev e não faz parte de nenhuma versão instalável. Não foi encontrada nenhuma declaração de mantenedor sobre a direção do projeto; portanto, trate isso como evidência de cadência, não como um anúncio.
O Claude Code pode usar o mesmo endpoint de API que o Aider?
Somente se esse endpoint oferecer os dois protocolos. O Aider se comunica com um endpoint genérico de terceiros por chat-completions da OpenAI, no caminho /v1/chat/completions; o Claude Code precisa de Anthropic Messages em /v1/messages, e o guia de compatibilidade de gateways da Anthropic não lista um endpoint de chat-completions da OpenAI entre os formatos que um gateway pode expor. Um gateway compatível apenas com a OpenAI não pode atender ao Claude Code. A Anthropic também declara claramente que não endossa, mantém nem audita produtos de gateway de terceiros e não oferece suporte ao roteamento do Claude Code para modelos que não sejam Claude por meio de qualquer gateway — uma posição de suporte, não um bloqueio técnico.
Qual é mais barato, Aider ou Claude Code?
O software cliente não é onde está o custo. O Aider custa $0 e não cobra nada; o Claude Code está incluído em uma assinatura Claude — Pro por $20 por mês se cobrado mensalmente, Max a partir de $100 por mês — ou é cobrado por token contra uma chave do Anthropic Console ou uma credencial de gateway. O número comparável é a quantidade de tokens, e os dois clientes os utilizam de maneiras diferentes: o Aider reenvia os arquivos do chat e, no modo arquiteto, faz duas solicitações ao modelo por turno, enquanto o Claude Code executa um loop agentivo cujo trabalho em segundo plano a Anthropic estima normalmente em menos de $0.04 por sessão e cujas equipes de agentes usam aproximadamente 7x mais tokens que as sessões padrão quando os colegas executam no modo de planejamento. Não existe, em nenhuma fonte verificada aqui, um benchmark controlado que compare esses dois clientes; portanto, não se pode afirmar que um deles seja mais barato para concluir determinada tarefa.
Uma credencial de gateway cancela minha assinatura Claude no Claude Code?
Ela a suspende naquela sessão, em vez de cancelá-la. A documentação de gateways da Anthropic afirma que, enquanto uma variável de credencial de gateway ou apiKeyHelper estiver ativa, a assinatura claude.ai do desenvolvedor não é usada: a credencial substitui o login da assinatura naquela sessão, os limites de uso da assinatura não se aplicam e esse tráfego é cobrado por token do responsável pela credencial. Definir apenas ANTHROPIC_BASE_URL sem uma credencial não substitui a assinatura — as solicitações passam pelo gateway, mas o login salvo do claude.ai continua sendo a credencial ativa. O login salvo retorna quando você remove a variável. O Aider não tem um mecanismo equivalente porque não oferece uma conta própria.
O que perco no Claude Code ao apontá-lo para um endpoint de terceiros?
São duas listas separadas. O próprio Claude Code desativa Remote Control e as configurações gerenciadas pelo servidor sempre que ANTHROPIC_BASE_URL aponta para um host diferente de api.anthropic.com, independentemente do que o gateway encaminhar. Separadamente, um conjunto documentado de recursos exige login no claude.ai e, portanto, fica inacessível com qualquer credencial de gateway: sessões na nuvem, Claude Code no celular, Claude Code no Slack, Routines, Ultrareview, Code Review, a extensão do Chrome, uso do computador, Artifacts e ditado por voz. Claude Code Desktop aparece nessa lista com uma exceção que a Anthropic declara na mesma página: o roteamento por gateway pode ser configurado no aplicativo ou por um administrador, e o Claude Desktop em 3P executa sua aba Code no Amazon Bedrock, na Agent Platform do Google Cloud, no Microsoft Foundry ou em um gateway auto-hospedado. A busca de ferramentas MCP fica desativada por padrão atrás de um host que não seja de primeira parte, e os conectores importados do claude.ai carregam somente sob uma assinatura claude.ai. O loop principal do agente não é bloqueado: a CLI, o Agent SDK, as extensões para VS Code e JetBrains, subagentes, hooks, comandos, skills, CLAUDE.md, plugins, servidores MCP, checkpoints, sandboxing e Workflows funcionam em todos os provedores.
Posso migrar minha configuração do Aider para o Claude Code sem refazê-la?
Nenhuma parte dela é transferida, porque as duas ferramentas leem arquivos diferentes. O Aider lê ~/.aider.conf.yml para flags, .aider.model.settings.yml para o formato de edição e o comportamento do mapa do repositório, .aider.model.metadata.json para a janela de contexto e o custo, e um arquivo de convenções somente quando você o passa com --read — a versão 0.86.2 lançada não tem tratamento automático de CONVENTIONS.md ou AGENTS.md. O Claude Code lê CLAUDE.md, .claude/settings.json, .mcp.json e seus diretórios de skills, hooks e plugins. Nada de um conjunto é um formato que o outro entenda, portanto a migração exige reescrever a configuração, não convertê-la. Quanto tempo isso leva depende do seu repositório e não foi medido aqui.
Verificado em 21 de setembro de 2026 por meio da consulta a cada fonte mencionada acima: os repositórios git do aider.chat, as páginas de modos de chat, cache de prompts e compatibilidade com OpenAI, os metadados do pacote aider-chat no PyPI, a entrada @anthropic-ai/claude-code no registro npm, claude.com/pricing e a documentação da Anthropic sobre gateway, disponibilidade de recursos e custos. As afirmações em nível de código-fonte do Aider foram lidas na tag lançada 0.86.2, e as datas do repositório vêm dos feeds públicos de commits e lançamentos do GitHub, não da API REST limitada por taxa. Nenhum benchmark comparando esses dois clientes foi encontrado nas fontes verificadas, portanto esta página não faz nenhuma afirmação de desempenho em nenhuma direção, e todo valor em dólar nela é um preço publicado ou uma aritmética ilustrativa de tokens.