Claude se juntar à lista de ferramentas que lêem AGENTS.md parece unificação. É realmente o oposto: agora cada assistente de codificação IA pretende honrar o mesmo arquivo, mas cada um o interpreta ligeiramente diferente. Cursor ainda lê .cursorrules, Aider lê .aider.conf.yml, JetBrains tem sua própria camada, e ferramentas empresariais silenciosamente adicionam políticas ao que encontram. Testamos sete dos aplicativos de codificação IA mais usados para ver como tratam AGENTS.md, onde divergem, e quais oferecem uma forma limpa de manter suas regras em um único lugar.
O que procurar em um aplicativo consciente de AGENTS.md
O ponto de uma convenção compartilhada é menos arquivos. As ferramentas que valem a pena adotar compartilham essas características.
- Lê
AGENTS.mdde nível superior sem configuração adicional - Honra
AGENTS.mdaninhado dentro de um subdiretório quando o agente trabalha lá - Documenta quais seções o modelo realmente consome (algumas ferramentas usam apenas o primeiro título)
- Expõe uma visualização do que a ferramenta enviou ao modelo
- Funciona com monorepos onde as regras por pacote importam mais do que um arquivo global
- Não reescreve silenciosamente o arquivo por conta própria
Comparação rápida
| Aplicativo | Melhor para | Plano gratuito | Recurso destacado |
|---|---|---|---|
| Aider | Codificação baseada em terminal com git diff | Sim | Lê AGENTS.md e .aider.conf.yml juntos |
| Claude Code | Tarefas de longa execução com um loop agente | Nível gratuito | Honra AGENTS.md, plugin skills e hooks |
| Codex CLI | Fluxo de trabalho de terminal nativo do OpenAI | Sim | Usa AGENTS.md como política principal |
| Cursor | IDE com tab-completion e chat | Nível gratuito | Vincula .cursorrules e AGENTS.md |
| Continue | Extensão de editor com backend local | Sim | Lê AGENTS.md através de provedores de contexto |
| Zed | Editor rápido com painéis de IA de primeira classe | Sim | AGENTS.md carrega como um prompt do sistema |
| Windsurf | IDE gerenciada do time Codeium | Nível gratuito | Painel de regras personalizado mais AGENTS.md |
Os aplicativos
1. Aider — melhor escolha baseada em terminal
Aider é o leitor mais literal de AGENTS.md. Apontá-lo para um repo e ele trata o arquivo como o prompt do sistema, sobrepondo .aider.conf.yml por cima para comportamento específico da ferramenta. A integração Git é nativa: cada edição aterrissa como um commit que você pode revisar ou desfazer.
Onde fica aquém: Sem integração IDE por padrão. A configuração fica em dotfiles em vez de um painel.
Plataformas: Python em Linux, macOS, Windows.
Preço: Gratuito, Apache 2.0.
Download: aider.chat
Conclusão: A escolha certa quando o terminal é o IDE e Git é a revisão.
2. Claude Code — melhor para trabalho de longa duração
Claude Code lê AGENTS.md ao lado de seu próprio CLAUDE.md, plugin skills e repo hooks. O loop agente mantém o arquivo em contexto através de muitas chamadas de ferramenta, o que importa quando as regras incluem longas listas de proibições. Arquivos AGENTS.md aninhados em um subdiretório são honrados quando o diretório de trabalho do agente se move.
Onde fica aquém: A precedência de arquivo aninhado quando AGENTS.md e CLAUDE.md existem leva um tempo para entender. Alguns plugins adicionam política oculta que não é óbvia apenas a partir do repo.
Plataformas: Terminal Linux, macOS, Windows. Também disponível no navegador via claude.ai/code.
Preço: Nível gratuito disponível. Nível pago para uso maior.
Download: claude.com/code
Conclusão: A escolha certa para execuções agente de múltiplas horas onde o livro de regras deve permanecer aplicado.
3. Codex CLI — melhor para fluxos de trabalho nativos do OpenAI
Codex CLI foi um dos primeiros shells a se padronizar em AGENTS.md, e ainda trata o arquivo como a fonte de política principal. Não há uma segunda camada de regras para manter sincronizada, o que é refrescante ou limitante dependendo da sua configuração.
Onde fica aquém: Menos controles do que Aider ou Claude Code. A extensibilidade depende do ritmo de lançamento do OpenAI.
Plataformas: CLI Node em Linux, macOS, Windows.
Preço: CLI gratuita, usa seus créditos da API OpenAI.
Download: github.com/openai/codex
Conclusão: A escolha certa se OpenAI é seu modelo e você quer uma superfície de arquivo de regras mínima.
4. Cursor — melhor IDE que lê AGENTS.md
Cursor costumava ler apenas .cursorrules. Em 2026 também lê AGENTS.md, sobreposto em cima do arquivo de regras mais antigo. Regras aninhadas dentro de uma pasta de espaço de trabalho funcionam bem, e o painel “regras” agora mostra exatamente o que o modelo recebeu.
Onde fica aquém: Dois formatos de regras coexistindo convidam desvio. Alguns recursos ainda se baseiam em .cursorrules mesmo quando AGENTS.md diz o contrário.
Plataformas: Windows, macOS, Linux. Baseado em VS Code.
Preço: Nível gratuito. Pro a $20 por mês.
Download: cursor.com
Conclusão: A escolha certa quando um IDE gráfico é inegociável e você já usa Cursor.
5. Continue — melhor extensão do VS Code
Continue é uma extensão do VS Code e JetBrains que permite apontar para Ollama, LocalAI ou um provedor de nuvem. Seus provedores de contexto incluem um leitor AGENTS.md, e seu arquivo de configuração permite compor o arquivo com substituições por comando. A extensão mostra o prompt composto antes de enviar, que é o que a maioria dos desenvolvedores realmente quer.
Onde fica aquém: A visualização de prompt composto é poderosa mas leva tempo para aprender. Os modelos locais ainda ficam atrás dos modelos de nuvem para refatorações difíceis.
Plataformas: VS Code e JetBrains em Linux, macOS, Windows.
Preço: Gratuito, Apache 2.0.
Download: continue.dev
Conclusão: A extensão certa quando você quer IA nativa do editor mais um backend local.
6. Zed — melhor editor rápido com painéis de IA
Zed carrega AGENTS.md como o prompt do sistema para seus painéis assistente. O resto do editor é rápido de uma forma que a maioria dos forks do VS Code não é. Se a base de código é grande e o loop de revisão é apertado, a responsividade do Zed se acumula.
Onde fica aquém: O suporte do Windows chegou mais tarde do que Linux e macOS. Menos recursos de IA do que IDEs dedicados.
Plataformas: macOS, Linux, Windows.
Preço: Nível gratuito. Planos pagos opcionais para acesso a modelo hospedado.
Download: zed.dev
Conclusão: A escolha certa quando a velocidade do editor importa mais do que a maior lista de recursos de IA.
7. Windsurf — melhor IDE gerenciada
Windsurf é a IDE do time Codeium. Tem um painel de regras dedicado que se sobrepõe de forma limpa com AGENTS.md, e suas execuções agente (Cascade) mantêm o arquivo em contexto através de mudanças multi-arquivo. Políticas empresariais podem ser enviadas centralmente sem editar o arquivo do repo.
Onde fica aquém: Não é código aberto. O nível pago é o nível de valor; o plano gratuito é suficiente para tentar.
Plataformas: Windows, macOS, Linux.
Preço: Nível gratuito. Planos Pro para indivíduos e times.
Download: windsurf.com
Conclusão: A escolha certa quando um time quer política central em cima de AGENTS.md.
Como escolher a certa
- Se o terminal é onde você codifica: Aider ou Codex CLI
- Se a carga de trabalho é tarefas agente de múltiplas horas: Claude Code
- Se Cursor é já o motorista diário: mantenha-o e deixe-o ler AGENTS.md junto com
.cursorrules - Se o objetivo é um backend local dentro do VS Code: Continue
- Se a velocidade do editor importa mais do que profundidade de recursos de IA: Zed
- Se um time precisa de política de regras central: Windsurf
FAQ
Devo escrever CLAUDE.md, AGENTS.md, ou ambos?
Escreva AGENTS.md primeiro. Se usar Claude Code especificamente, adicione um pequeno CLAUDE.md para substituições apenas do Claude. Nada no ecossistema o castiga por ter ambos.
AGENTS.md funciona em monorepos?
Sim. Cada ferramenta nesta lista respeita um AGENTS.md aninhado, embora as regras de precedência diferem. Aider e Claude Code preferem o mais profundo; Cursor mescla de cima para baixo da raiz.
Como evito que uma ferramenta edite silenciosamente minhas regras?
Defina o arquivo como somente leitura no repo ou, para segurança extra, gere a partir de um modelo mantido em docs/. Algumas ferramentas respeitam um comentário “não editar” no topo; a maioria agora faz.
Qual ferramenta preview mostra o que o modelo realmente recebeu? Continue e Cursor ambos mostram o prompt composto. Claude Code imprime o rastro de chamada de ferramenta quando verbosidade é ligada.
AGENTS.md funciona com modelos locais? Sim, desde que a ferramenta o respeite. Continue mais Ollama, e Aider mais um modelo local ambos aplicam o arquivo corretamente.
Existe um linter para AGENTS.md? Nada amplamente adotado ainda. Times tipicamente aplicam estrutura com um hook pre-commit simples que verifica as seções necessárias.
