Aider: Programação AI desde o terminal, open-source e multi-modelo 
Se há uma ferramenta no ecossistema de programação com IA que encarna a filosofia Unix 100%, essa é Aider. Sem GUI, sem assinatura mensal obrigatória, sem vendor lock-in. Apenas você, seu terminal, seu repositório Git e o modelo de IA que você escolher. Em 2026, Aider se tornou a ferramenta favorita de uma categoria específica de desenvolvedores: aqueles que preferem ter controle total.
Neste artigo explico o que é Aider, como instalá-lo, como configurá-lo com diferentes modelos (incluindo opções locais gratuitas) e quando faz sentido usá-lo em relação a alternativas como Claude Code ou Cursor.
O que é Aider exatamente?
Aider é um assistente de pair programming open-source que roda no seu terminal. Você o instala uma vez, o aponta para seu repositório Git e pode pedir em linguagem natural que modifique código, adicione funcionalidades, corrija bugs ou refatore arquivos inteiros.
O que o diferencia da maioria das ferramentas similares:
- É completamente agnóstico ao modelo: funciona com Claude (Anthropic), GPT-4o (OpenAI), Gemini (Google), DeepSeek e dezenas de modelos locais via Ollama ou LM Studio.
- Integração nativa com Git: cada mudança que Aider faz gera automaticamente um commit com uma mensagem descritiva. Seu histórico fica limpo e auditável.
- Entende todo seu codebase: gera um mapa interno do repositório para entender a estrutura do projeto, não apenas o arquivo que você tem aberto.
- É gratuito como ferramenta: você só paga pelos tokens que consome na API do modelo que escolher.
Instalação em 5 minutos
Aider se instala com pip. Certifique-se de ter Python 3.8+ instalado.
# Instalação básica
pip install aider-chat
# Verificar instalação
aider --version
Para usá-lo com Claude (a configuração mais popular em 2026):
# Exporte sua chave de API do Anthropic
export ANTHROPIC_API_KEY=sua_chave_api_aqui
# Inicie Aider no seu projeto
cd meu-projeto
aider
Para GPT-4o:
export OPENAI_API_KEY=sua_chave_api_aqui
aider --model gpt-4o
Para um modelo local com Ollama (completamente gratuito, sem internet):
# Primeiro instale Ollama e baixe um modelo
ollama pull deepseek-coder-v2
# Depois inicie Aider apontando para o servidor local
aider --model ollama/deepseek-coder-v2
Os modos de chat: quando usar cada um
Aider tem quatro modos de chat que mudam como ele interage com seu código. Este é um dos aspectos mais poderosos da ferramenta e que muitos usuários ignoram no início.
Modo /code (padrão)
O modelo edita diretamente os arquivos que você indicar. Ideal para implementar funcionalidades concretas.
> /add src/auth.py src/models/user.py
> adiciona validação de email ao método register() e atualiza o modelo User para incluir o campo email_verified
Modo /architect
Primeiro planeja as mudanças em linguagem natural, depois um segundo modelo as implementa. É mais lento mas produz resultados mais consistentes em mudanças complexas que tocam múltiplos arquivos.
> /architect
> preciso refatorar o sistema de autenticação para usar JWT em vez de sessões. Tenho os arquivos auth.py, middleware.py e os testes em tests/test_auth.py
Modo /ask
Apenas responde perguntas sobre o código sem modificar nada. Perfeito para entender código existente ou planejar antes de agir.
> /ask
> qual é o fluxo de autenticação atual e onde há potenciais vulnerabilidades?
Modo /help
Ajuda com o uso do Aider mesmo.
Fluxo de trabalho real com Git
Uma das razões pelas quais Aider gera tanta lealdade é sua integração com Git. Cada mudança fica versionada automaticamente. Se algo der errado, você simplesmente faz git revert.
Exemplo de uma sessão típica:
$ cd minha-app-express
$ git status
On branch feature/payments
$ aider src/payments/stripe.js src/routes/checkout.js
Aider v0.62.0
Claude 3.7 Sonnet
Repo map: 47 tokens
Added 2 files to the chat.
> implementa o webhook do Stripe para confirmar pagamentos e atualiza a rota /checkout/confirm
# Aider analisa os arquivos, faz as mudanças e commits automaticamente:
# [main 3f8a12c] feat: add Stripe webhook handler and update checkout route
> /diff
# Mostra exatamente o que mudou
> os testes falham em webhook_test.js, veja por quê
# Aider revisa, diagnostica e propõe correção
O resultado: código modificado + commits limpos + histórico auditável. Sem necessidade de sair do terminal.
Configuração multi-modelo: a killer feature
Em 2026 Aider suporta mais de 60 modelos de forma nativa. Isso é especialmente relevante para desenvolvedores na América Latina, onde o custo das APIs pode ser uma consideração real.
Estratégia de custos para América Latina
| Modelo | Custo aproximado | Velocidade | Qualidade |
|---|---|---|---|
| Claude 3.7 Sonnet | ~$3-8 USD / 1M tokens | Rápido | Excelente |
| GPT-4o Mini | ~$0.15 / 1M tokens | Muito rápido | Boa |
| DeepSeek-V3 (API) | ~$0.27 / 1M tokens | Rápido | Excelente |
| Ollama (local) | $0 | Variável | Boa |
Para projetos grandes, muitos desenvolvedores usam uma estratégia híbrida:
- Modelos baratos (DeepSeek, GPT-4o Mini) para tarefas rotineiras
- Claude Sonnet ou GPT-4o para mudanças complexas ou arquitetura
- Ollama para sessões longas sem preocupação com custos
Para configurar o modelo padrão e economizar tempo:
# Crie um arquivo .aider.conf.yml no seu diretório home
echo "model: deepseek/deepseek-chat" > ~/.aider.conf.yml
# Ou diretamente no diretório do projeto para override
echo "model: claude-3-7-sonnet-20250219" > .aider.conf.yml
Dicas pro que fazem a diferença
1. Use comentários no código como instruções
Uma das features mais originais: você pode deixar comentários # AI: instrução aqui diretamente no seu código e Aider os processa automaticamente.
def calculate_discount(price, user_tier):
# AI: implementa lógica de descontos: bronze=5%, silver=10%, gold=20%, enterprise=customizado
pass
2. Prompt caching para sessões longas
Aider suporta prompt caching com Claude e GPT, o que reduz o custo até 90% em sessões onde o contexto do repositório se mantém estável. É ativado automaticamente.
3. .aiderignore para projetos grandes
Como .gitignore mas para Aider. Exclui pastas que você não quer que indexe:
node_modules/
dist/
.env
*.log
4. Modo voice para programação por voz
aider --voice
Sim, você pode literalmente falar com seu terminal. Útil para sessões longas quando os dedos já não aguentam mais.
5. Scripting e automação
Aider pode ser usado via script através da linha de comando, o que abre possibilidades para pipelines CI/CD:
# Executar uma instrução não-interativa e sair
aider --message "atualiza todos os testes para cobrir o novo módulo auth" src/auth.py tests/
# Modo yes para aceitar todas as mudanças automaticamente
aider --yes --message "corrige todos os erros de linting no diretório src/"
```## Quando usar Aider vs. Claude Code vs. Cursor?
Esta é a pergunta que todos fazem. A resposta honesta:
**Use Aider se:**
- Você é um desenvolvedor terminal-first e se sente desconfortável com o mouse
- Quer controle total sobre qual modelo usa e quanto gasta
- Sua empresa não pode enviar código para certos provedores (você pode usar modelos locais)
- Trabalha muito com repositórios legacy grandes
- Valoriza o open-source e quer poder auditar/modificar a ferramenta
**Use Claude Code se:**
- Quer o melhor equilíbrio entre poder agêntico e experiência de terminal
- Trabalha com projetos complexos que requerem raciocínio profundo
- A integração com servidores MCP é importante para seu workflow
**Use Cursor se:**
- Prefere uma experiência visual com IDE
- Seu time é misto em experiência com terminal
- A colaboração em tempo real importa
Os três não são mutuamente excludentes. Muitos devs em 2026 usam Cursor no dia a dia e Aider para tarefas específicas de refatoração massiva ou quando estão em servidores remotos via SSH.
---
## O modelo de custos real para LatAm
Aider é gratuito como software. O que você paga são os tokens da API.
Para um desenvolvedor que usa Aider moderadamente (2-3 horas/dia):
- **Com Claude 3.7 Sonnet**: ~15-30 USD/mês dependendo da complexidade
- **Com DeepSeek-V3**: ~2-5 USD/mês
- **Com Ollama local**: $0 (se você tiver a GPU para rodá-lo)
Comparado com Cursor Pro ($20/mês) ou GitHub Copilot Pro ($10/mês), Aider pode ser mais econômico se você usar modelos mid-tier, e mais caro se usar Claude/GPT-4 para tudo. A chave é a flexibilidade: **você decide o trade-off entre custo e qualidade**.
---
## Para começar hoje
```bash
# Instalação
pip install aider-chat
# Primeira sessão (com Claude)
export ANTHROPIC_API_KEY=sua_chave
cd seu-projeto
aider
# Dentro do Aider, adicione arquivos e comece:
# /add arquivo1.py arquivo2.py
# > descreva o que você quer fazer
A documentação oficial em aider.chat é excelente e cobre desde casos básicos até configurações avançadas com modelos locais.
Você já usa Aider em seu workflow? Você combina com algum outro editor AI ou usa como ferramenta principal? Compartilhe seu setup nos comentários — os fluxos de trabalho híbridos sempre são os mais interessantes de discutir. 