O Claude Code, agente de programação da Anthropic, passou a reconhecer o arquivo AGENTS.md como fonte de instruções para projetos de software. O anúncio foi feito por Thariq Shihipar, da própria Anthropic, e vale a partir da versão 2.1.277 da ferramenta.
A novidade foi registrada por Simon Willison em seu blog, em 18 de setembro de 2026.
A mudança estabelece uma ordem de prioridade entre dois arquivos de contexto. Ao abrir uma pasta, o Claude Code procura primeiro por um CLAUDE.md.
A ferramenta só verifica a presença de um AGENTS.md quando esse arquivo não existe.
Não é uma substituição do formato anterior. É um caminho alternativo para quem já organiza as instruções do projeto com o outro nome.
Como funciona o encadeamento de arquivos
A checagem é automática e não exige configuração adicional além da presença do arquivo na pasta. O CLAUDE.md mantém a preferência.
O AGENTS.md entra como segunda opção.
Para projetos que convivem com os dois nomes, o conteúdo do AGENTS.md só é considerado quando o CLAUDE.md está ausente. O detalhe é relevante para equipes que esperavam alguma forma de combinação entre os dois arquivos.
Arquivos desse tipo dão ao agente de código contexto sobre o projeto em que ele vai atuar. São um dos pontos centrais da rotina de quem usa assistentes de programação no dia a dia.
Com o suporte nativo, quem já mantém um arquivo chamado AGENTS.md deixa de precisar reproduzir o mesmo conteúdo em um CLAUDE.md para que o Claude Code o leia.
Mods: a camada de customização
O suporte a AGENTS.md não é um recurso isolado. Ele foi construído sobre os Claude Code mods.
Shihipar descreve os mods como o mecanismo que a Anthropic prepara para permitir a customização do harness da ferramenta.
O recurso é um mod embutido, ou seja, vem pronto no produto. A empresa afirma que os usuários também poderão construir versões próprias de instruções de projeto, conforme a necessidade.
O código do mod está público no repositório da Anthropic no GitHub. O mesmo repositório reúne outros mods disponibilizados pela empresa.
Por que isso importa
O ponto mais significativo é a adoção de um nome de arquivo genérico, em contraste com o CLAUDE.md, que é específico da ferramenta. Para times que trabalham com mais de um assistente de código, isso reduz a duplicação de arquivos de contexto, desde que as outras ferramentas também reconheçam o mesmo nome de arquivo.
A decisão sinaliza uma preocupação com interoperabilidade entre agentes de programação. Por enquanto, ela está limitada ao ecossistema do Claude Code.
O segundo aspecto é a arquitetura. Ao transformar o suporte a AGENTS.md em um mod, a Anthropic expõe uma camada de customização que antes não estava disponível aos usuários.
Isso pode abrir espaço para que equipes criem suas próprias versões de instruções de projeto, adaptadas a fluxos específicos de desenvolvimento.
O anúncio foi publicado por Shihipar e replicado por Willison, cujo blog é um dos registros mais acompanhados sobre o setor de inteligência artificial. A data de publicação da citação é 18 de setembro de 2026.
Fontes e links
- Simon Willison — matéria original
- Anúncio de Thariq Shihipar
- Código do mod agents-md
- Outros mods do Claude Code
