A abordagem open-source e agnóstica em relação a modelos do Aider oferece flexibilidade que nenhuma ferramenta comercial consegue igualar. Mas essa flexibilidade significa que há mais parâmetros para ajustar. Aqui estão as dicas que usuários experientes do Aider confiam.
1. A Estratégia de Troca de Modelos
Não escolha um modelo e fique com ele. Diferentes tarefas precisam de diferentes modelos:
# Refatoração complexa, mudanças de arquitetura
aider --model claude-opus-4-20250514
# Desenvolvimento diário, implementação de recursos
aider --model claude-sonnet-4-20250514
# Edições rápidas, correções simples
aider --model gpt-4o
# Trabalho exploratório, prototipagem (mais barato)
aider --model deepseek/deepseek-chat
# Trabalho offline, código sensível à privacidade
aider --model ollama/qwen2.5-coder:32b
Você também pode trocar de modelo durante a sessão com /model claude-sonnet-4-20250514. Esta é uma das maiores vantagens do Aider — sem dependência de fornecedor, nunca.
2. A Disciplina de /add e /drop
O gerenciamento de contexto é tudo para qualidade e custo:
Seja cirúrgico com /add. Adicione apenas arquivos diretamente relevantes para sua tarefa atual. O mapa de repositório do Aider oferece consciência de toda a estrutura do seu projeto sem precisar de cada arquivo em contexto.
/add src/services/orderService.ts
/add src/types/order.ts
/add src/routes/orders.ts
Use /read-only para arquivos de referência que não devem ser editados:
/read-only src/services/userService.ts
Isso permite que o Aider veja os padrões sem risco de editar código funcionando.
Remova arquivos agressivamente ao trocar de tarefas:
/drop src/services/orderService.ts
/add src/services/notificationService.ts
Isso mantém o contexto focado e os custos baixos.
3. Use /test para Fluxos de Trabalho Test-Driven
O comando /test é o superpower do Aider para qualidade:
/test npm test
Os testes em src/__tests__/orderService.test.ts estão falhando.
Corrija a implementação para fazer todos os testes passarem.
Não modifique os arquivos de teste.
O Aider executa os testes, lê as falhas, corrige o código, re-executa os testes e itera até que passem. Este loop automatizado de teste-correção é incrivelmente eficiente para TDD.
Você também pode usá-lo proativamente:
Escreva testes abrangentes para src/services/authService.ts,
depois execute-os com /test npm test e corrija qualquer problema.
4. Histórico do Git como Documentação
Cada edição do Aider cria um commit do git. Use isso estrategicamente:
# Veja tudo que o Aider fez hoje
git log --since="8am" --oneline
# Revise todas as mudanças em um arquivo específico
git log --follow -p src/services/orderService.ts
# Desfaça a última mudança do Aider
/undo
# Desfaça múltiplas mudanças
git reset --hard HEAD~3
Antes de fazer push, comprima os commits granulares do Aider em unidades lógicas:
git rebase -i HEAD~8 # comprima os últimos 8 commits em grupos significativos
5. A Configuração Power User do .aider.conf.yml
model: claude-sonnet-4-20250514
auto-commits: true
show-diffs: true
dark-mode: true
# Sempre inclua contexto do projeto
read:
- CLAUDE.md
- ARCHITECTURE.md
- docs/API.md
# Lint após cada edição
lint-cmd: npm run lint -- --fix
auto-lint: true
# Teste após cada edição
test-cmd: npm test
auto-test: false # manual — auto-test em cada edição fica caro
# Configurações do Git
attribute-author: true # marca commits como criados por IA
attribute-committer: false
commit-prompt: "Escreva uma mensagem de commit convencional (feat/fix/refactor/docs)"
Esta configuração significa que o Aider faz lint automaticamente após cada mudança e você pode disparar testes manualmente quando pronto.
6. Use /web para Documentação Atual
Bibliotecas mudam. Dados de treinamento ficam desatualizados. Use /web para fundamentar o Aider em documentação atual:
/web https://supabase.com/docs/reference/javascript/auth-signinwithoauth
Implemente o sign-in do Google OAuth usando a abordagem desta
documentação. Use o fluxo PKCE, não o fluxo implícito.
O Aider faz scrape da página e a usa como contexto para geração de código. Isso é essencial para bibliotecas em rápida evolução onde a API que você aprendeu seis meses atrás pode ter mudado.
7. Padrões de Refatoração Multi-Arquivo
O Aider lida com mudanças em múltiplos arquivos de forma limpa. A chave é ser específico sobre o padrão:
/add src/routes/*.ts
Refatore todos os manipuladores de rota para usar este padrão:
1. Extraia validação de requisição em uma chamada validateRequest() separada
2. Envolva o corpo do manipulador em um tryCatch que chama handleError()
3. Adicione logging de requisição no início: logger.info({ method, path, userId })
4. Padronize o formato de resposta para { data, meta: { requestId, timestamp } }
Aplique a todos os arquivos. Mantenha a lógica de negócio inalterada.
O Aider processa cada arquivo sistematicamente. Revise os commits um por um — serão atômicos por arquivo.
8. Modelos Locais para Prática Gratuita
Configure o Ollama para codificação sem custo:
# Instale o Ollama
curl -fsSL https://ollama.ai/install.sh | sh
# Baixe um modelo de codificação
ollama pull qwen2.5-coder:14b
# Use com o Aider
aider --model ollama/qwen2.5-coder:14b
Modelos locais são ótimos para:
- Aprender Aider sem custos de API
- Trabalhar offline (voos, viagens)
- Edições rápidas onde a qualidade não precisa ser perfeita
- Código sensível à privacidade que você não quer que saia da sua máquina
A qualidade é menor que Claude ou GPT-4o, mas para muitas tarefas é suficiente.
9. O Comando /architect para Planejamento
Para tarefas complexas, use o modo architect do Aider:
/architect
Preciso adicionar um sistema de notificações em tempo real.
Os usuários devem ver notificações em um dropdown, receber
notificações push no mobile e receber resumos por email diariamente.
Planeje a implementação: modelo de dados, endpoints de API,
integração WebSocket, jobs em background e quais arquivos
existentes precisam de modificação.
O modo architect usa um modelo mais forte para planejar, depois um modelo mais rápido para implementar. Isso economiza dinheiro mantendo qualidade na fase de pensamento.
10. Rastreamento de Custos e Otimização
Monitore seus gastos:
/tokens
Mostra o uso da sessão atual. Mantenha custos baixos:
- Claude Sonnet é o ponto ideal para uso diário (~$3/1M tokens de entrada, $15/1M tokens de saída)
- GPT-4o é mais barato para tarefas simples
- DeepSeek é muito barato com qualidade surpreendentemente boa
- Modelos locais não custam nada após o download inicial
- Use
/clearentre tarefas para resetar contexto em vez de carregar histórico desnecessário
Um dia típico de desenvolvimento ativo custa $2-8 com Sonnet. Isso é menos que uma assinatura mensal do Cursor se você codificar alguns dias por semana.
Qual é sua estratégia de modelo do Aider? Compartilhe sua configuração .aider.conf.yml abaixo. 