Aider vs Claude Code se resume a quanto você quer que o agente faça por conta própria. O Aider é um programador em par de código aberto (Apache-2.0) para o terminal: você adiciona os arquivos que precisam mudar, ele os edita com o modelo que você escolher e a sua própria chave, e faz commit de cada edição no git. O Claude Code é o agente de programação proprietário da Anthropic: explora o repo sozinho, roda comandos, delega para subagentes e se estende com hooks e MCP, mas usa só modelos Claude e vem com um plano do Claude. Os dois trabalham no seu terminal, no seu repo de verdade, então a decisão depende sobretudo de modelos, custo e controle.
Este artigo compara os dois no que importa, em outubro de 2026 e sem benchmarks inventados. Depois mostra qual escolher e como usar os dois sem que um atrapalhe o outro.
O que eles são
O Aider se descreve como “AI pair programming in your terminal”. O código está no GitHub (Aider-AI/aider) sob a licença Apache-2.0. Você roda aider num repo git, escolhe um modelo, adiciona os arquivos que precisam mudar e descreve a mudança. O Aider monta um mapa do repo inteiro, edita os arquivos num formato adequado ao modelo e faz commit do resultado. O passo a passo está em como usar o Aider.
O Claude Code é o agente da Anthropic. Rode claude na pasta de um projeto e converse com ele. Ele lê e busca arquivos sozinho, edita, roda comandos e confere o resultado. Também funciona no VS Code (e no Cursor), no JetBrains, num app de desktop, na web e no app móvel do Claude. Se você está começando, veja como usar o Claude Code.
Aider vs Claude Code num relance
| Aider | Claude Code | |
|---|---|---|
| Criador | O projeto Aider (Aider-AI/aider) | Anthropic |
| Licença | Apache-2.0, código aberto | Proprietária, sob os Commercial Terms da Anthropic |
| Comando | aider | claude |
| Modelos | A maioria dos LLMs: Anthropic, OpenAI, Gemini, DeepSeek, xAI, OpenRouter, Bedrock, Vertex AI, GitHub Copilot, modelos locais… | Só modelos Claude |
| Como você paga | A chave de API do seu provedor, uma assinatura do Copilot ou nada com modelos locais | Claude Pro, Max, Team ou Enterprise, créditos de API no Console ou um provedor de nuvem |
| Contexto | Os arquivos que você adiciona com /add, mais um mapa do repo inteiro | O agente lê e busca arquivos sozinho |
| Edições | Formatos de edição por modelo (whole, diff, udiff…) | Ferramentas de arquivo próprias |
| Git | Faz commit de cada edição por padrão; /undo desfaz | Faz commit e abre PRs quando você pede; checkpoints com /rewind |
| Planejamento | /ask e modo architect | Modo plano (Shift+Tab) |
| Subagentes | Não | Nativos e personalizados, em .claude/agents/ |
| Hooks | Não; roda os seus comandos de lint e testes | Sim, em eventos como PreToolUse e Stop |
| MCP | Não integrado | Sim, claude mcp add ou /mcp |
| Instruções do projeto | Um arquivo de convenções carregado com --read | CLAUDE.md (lê AGENTS.md se não houver CLAUDE.md) |
| Execução não interativa | aider --message "..." | claude -p "..." |
Modelos e provedores
Esta é a maior diferença.
O Aider se conecta à maioria dos LLMs. A documentação tem páginas de configuração para OpenAI, Anthropic, Gemini, Groq, xAI, Azure, Cohere, DeepSeek, OpenRouter, Amazon Bedrock, Vertex AI e GitHub Copilot, e ele roda modelos locais com Ollama, LM Studio ou qualquer API compatível com OpenAI. Você passa o modelo e a chave na linha de comando, ou guarda os dois em variáveis de ambiente e no .aider.conf.yml:
aider --model sonnet --api-key anthropic=<chave>
aider --model deepseek --api-key deepseek=<chave>Ele também usa um “weak model” mais barato para mensagens de commit e resumos do chat, e no modo architect você pode juntar um modelo forte que planeja com um mais barato que edita (--editor-model).
O Claude Code usa modelos Claude. /model alterna entre eles. Você pode chegar a esses modelos direto pela Anthropic ou via Amazon Bedrock, Google Cloud ou Microsoft Foundry, mas é sempre Claude, e a ferramenta é ajustada justamente para esses modelos.
Se você quer testar um modelo novo no dia em que ele sai, ou rodar tudo na sua própria GPU, o Aider faz isso de fábrica. Se o modelo que você quer é o Claude, o Claude Code tira mais proveito dele.
Custo: sua própria chave ou um plano do Claude
O Aider não custa nada. Você paga pelos modelos:
- A sua própria chave de API, cobrada por token pelo provedor.
/tokensmostra quanto custa o contexto atual, e--cache-prompts(desligado por padrão) ativa o cache de prompts nos modelos que o suportam, como Claude e DeepSeek. - Uma assinatura do GitHub Copilot. O Aider pode usar os modelos do Copilot, e as chamadas entram no seu plano do Copilot.
- Modelos locais, sem conta além do seu hardware.
Como é você quem decide o que entra no contexto, uma sessão disciplinada do Aider pode ficar pequena: adicione só os arquivos a editar e deixe o mapa do repo cobrir o resto.
O Claude Code faz parte dos planos do Claude. Em outubro de 2026 isso significa Pro (US$ 20 por mês, ou US$ 17 por mês no plano anual), Max (a partir de US$ 100 por mês), além de assentos no Team e no Enterprise. O plano Free não inclui o Claude Code. Você também pode dispensar o plano e pagar por token com uma conta do Console.
Usar modelos Claude no Aider significa uma chave de API da Anthropic e cobrança por token; o seu plano Claude Pro ou Max é para o Claude Code. Então, se você já paga o Claude, o Claude Code é o jeito mais barato de usar os modelos dele. Se você quer um modelo barato, ou já paga o Copilot, o Aider deixa você usar o que já tem.
Licença e abertura
O Aider tem licença Apache-2.0. Você pode ler o código, fazer fork, aplicar patches e rodar onde quiser. O repositório do Claude Code no GitHub tem issues, plugins e exemplos, mas o arquivo de licença diz “© Anthropic PBC. All rights reserved” e remete aos Commercial Terms da Anthropic. A instalação é gratuita e você usa a ferramenta nos termos da Anthropic.
Para a maioria dos desenvolvedores isso pesa menos que os modelos e o preço. Para equipes que precisam auditar ou modificar a ferramenta, pode ser decisivo.
Como eles trabalham: programador em par ou agente
É aqui que a diferença mais aparece no dia a dia.
Aider: você escolhe os arquivos
O Aider trabalha com o que você entrega. /add coloca arquivos no chat para edição, /read-only adiciona arquivos de referência e /drop os remove. Ele também envia um mapa do repo: uma lista compacta dos arquivos do repo com as classes, funções e assinaturas mais importantes, ordenada pela forma como os arquivos dependem uns dos outros. O mapa ocupa cerca de 1k tokens por padrão (--map-tokens) e cresce quando você não adicionou nenhum arquivo. Assim o modelo sabe onde fica cada coisa sem que você precise adicionar meio repo.
O Aider pede ao modelo que responda no formato de edição que funciona melhor para ele: whole (o arquivo inteiro), diff (blocos de busca e substituição), diff-fenced, udiff e variantes para o editor. Você quase nunca mexe nisso, mas é por isso que o Aider funciona bem com tantos modelos diferentes.
Ele tem quatro modos de chat:
/code fazer a mudança (padrão)
/ask conversar sobre o código, sem nunca editar
/architect um modelo planeja, um modelo editor escreve as edições
/help perguntas sobre o próprio AiderO modo architect envia duas requisições por mudança, então é mais lento e mais caro, mas ajuda nos problemas difíceis.
Claude Code: o agente encontra o caminho
O Claude Code trabalha como agente. Você descreve a tarefa e ele decide quais arquivos ler, busca no código, edita arquivos, roda os seus testes e comandos, e segue até terminar ou até precisar de você. Ele pergunta antes de editar e de rodar comandos, a menos que você escolha um modo de permissões mais solto.
Para trabalhos grandes ele tem mais recursos. O modo plano (Shift+Tab) pesquisa e escreve um plano sem mexer no código até você aprovar. Os subagentes cuidam de uma tarefa paralela no próprio contexto e devolvem o resultado, para que a conversa principal continue focada. Skills e plugins empacotam fluxos de trabalho que você repete.
Resumindo: o Aider é preciso e econômico quando você sabe quais arquivos importam. O Claude Code é melhor quando você não sabe, ou quando a tarefa exige rodar e consertar coisas pelo repo inteiro.
Git: commits automáticos ou commits quando você pede
O Aider faz commit de cada edição, com uma mensagem escrita pelo weak model no estilo Conventional Commits. Se um arquivo tem mudanças sem commit antes de ele editá-lo, ele faz commit delas primeiro, para que o seu trabalho e o dele fiquem separados. Ele acrescenta “(aider)” ao nome do autor e do committer. /diff mostra a última mudança e /undo a desfaz. Por padrão ele faz commit com --no-verify, então adicione --git-commit-verify se quiser que os seus hooks de pre-commit rodem. --no-auto-commits deixa as mudanças sem commit.
O Claude Code não faz commit até você pedir. Quando você pede, ele prepara as mudanças, escreve a mensagem de commit e abre pull requests. A rede de segurança dele são os checkpoints: /rewind volta as edições de arquivos dele a um ponto anterior.
Se você gosta de um histórico limpo e reversível a cada passo, o comportamento padrão do Aider é difícil de superar. Se prefere revisar e fazer commit você mesmo, o do Claude Code combina mais.
Como estender: hooks, MCP e convenções
O Claude Code oferece bastante aqui:
- Hooks que rodam os seus scripts em eventos como
PreToolUse,PostToolUseeStop, a partir de.claude/settings.json. O guia de hooks do Claude Code tem exemplos reais. - MCP conecta servidores locais e remotos com
claude mcp addou/mcp. - CLAUDE.md guarda as regras do projeto, e o Claude Code lê
AGENTS.mdquando não háCLAUDE.md.
O Aider é mais enxuto. Não tem MCP integrado; em outubro de 2026, nem a documentação nem as notas de versão o mencionam. O que ele tem:
- Lint e testes depois de cada mudança:
--lint-cmd,--test-cmde--auto-test, e ele tenta consertar o que falhar. - Convenções num arquivo Markdown carregado como somente leitura:
aider --read CONVENTIONS.md, ou pelo.aider.conf.yml. - Modo watch (
--watch-files): escreva no seu editor um comentário que termine emAI!e o Aider faz a mudança; termine emAI?e ele responde a pergunta. - Entrada por voz, e imagens e páginas web como contexto.
Para scripts e CI, os dois têm um modo de execução única:
aider --message "adicione type hints em utils.py" utils.py
claude -p "adicione type hints em utils.py"Plataformas
| Aider | Claude Code | |
|---|---|---|
| macOS, Linux | Script de instalação, aider-install, uv, pipx | Instalador nativo, Homebrew, apt/dnf/apk |
| Windows | Script de instalação para PowerShell, aider-install, uv, pipx | Instalador nativo (PowerShell, CMD), WinGet, WSL |
| Editor | Qualquer editor com --watch-files | Extensão para VS Code (e Cursor), plugin para JetBrains |
| Outras superfícies | Terminal | App de desktop, web, celular, Slack, GitHub Actions |
Qual escolher?
- Você quer escolher o modelo, usar modelos locais ou ter um código aberto sob Apache-2.0: escolha o Aider. Ele também serve se você já paga o Copilot.
- Você já paga o Claude, ou quer subagentes, hooks, MCP e modo plano: escolha o Claude Code. É a única forma de usar o seu plano do Claude, e ele é construído em torno desses modelos.
- Você sabe quais arquivos uma mudança toca e quer controle rígido com um commit por passo: o Aider é leve e previsível.
- A tarefa abrange o repo inteiro e exige rodar comandos e corrigir erros em ciclo: o Claude Code faz isso sozinho.
- O custo é o mais importante: o Aider com um modelo barato ou local pode custar bem menos. O Claude Code com o Pro é previsível se o que você quer é o Claude.
O teste honesto é o de sempre: dê aos dois a mesma tarefa real no seu próprio repo, por exemplo um bug com um teste falhando, e compare os diffs. Se você também está avaliando outros agentes de código aberto, leia opencode vs Claude Code.
Aider e Claude Code lado a lado no AgentVera
Muita gente fica com os dois: o Claude Code com o plano do Claude, o Aider para outros modelos ou para edições rápidas em arquivos específicos. O atrito é conhecido: dois terminais, dois fluxos de commits e dois agentes que podem editar o mesmo arquivo.
O AgentVera é um app de desktop para macOS, Windows e Linux que abre o Aider e o Claude Code (e outros 16 agentes de CLI) em terminais reais, com as suas próprias instalações, chaves e logins:
- Uma grade. Os dois agentes dividem a grade do workspace, cada um no seu próprio git worktree, então os commits automáticos do Aider nunca caem na cópia de trabalho do Claude Code.
- As suas chaves. O Aider lê as chaves dos provedores das variáveis de ambiente ou do
.aider.conf.yml, como sempre. O modelo que você escolhe no AgentVera é passado com--model, e o nível de esforço com--reasoning-effort. O seu login do Claude funciona como está. - Conversa entre eles. O Aider não aceita MCP, então os servidores MCP que você configura no AgentVera não são passados para ele, mas ele ainda tem mensagens entre agentes pelo comando de shell
agentvera-agents. - Revisão. A revisão de código automática confere o código quando um turno termina, e com os fluxos (Pro e Team) a resposta de um agente passa para o outro automaticamente.
A grade, os worktrees e a revisão de código estão no plano gratuito. Baixe o AgentVera e abra um agente do Aider ao lado de um do Claude Code para comparar os dois no seu próprio código.