21 de setembro de 2026
Claude Code passa a ler AGENTS.md quando não há CLAUDE.md
A v2.1.277 (18 de setembro) fez o Claude Code passar a ler o arquivo AGENTS.md quando o projeto não tem CLAUDE.md, sem precisar de import ou atalho manual. O CLAUDE.md continua valendo quando os dois existem, e dá para trocar qual arquivo é lido em Project instructions, dentro do config. O suporte ainda não chegou ao Bedrock, Vertex nem Foundry.
Até a v2.1.277 (18 de setembro), um projeto sem CLAUDE.md simplesmente
não tinha instrução de projeto nenhuma para o Claude Code — mesmo que já
existisse um AGENTS.md escrito para outra ferramenta. Agora, na ausência
de CLAUDE.md, o Claude Code lê o AGENTS.md do projeto diretamente, sem
precisar de um arquivo-ponte importando um no outro. Quando os dois
arquivos existem, CLAUDE.md continua tendo prioridade; qual dos dois é
lido pode ser trocado manualmente em "Project instructions", dentro do
/config.
AGENTS.md é um formato aberto, mantido pela Agentic AI Foundation sob a Linux Foundation, e já era lido por mais de trinta ferramentas — Cursor, GitHub Copilot, OpenAI Codex e Google Jules entre elas. Até aqui, quem usava Claude Code ao lado de outro agente no mesmo repositório precisava manter os dois arquivos sincronizados à mão, ou usar um import de um dentro do outro. A ressalva: o suporte ainda não chegou ao Bedrock, Vertex nem Foundry, então quem roda o Claude Code por essas plataformas continua precisando de CLAUDE.md por enquanto.
Por que importa
Quem já mantinha AGENTS.md para outro agente (Cursor ou Copilot, por exemplo) ganha compatibilidade com o Claude Code de graça, sem duplicar arquivo. Se você tem os dois arquivos hoje só por precaução, dá para simplificar: com CLAUDE.md ausente, o AGENTS.md já basta, contanto que não esteja rodando via Bedrock, Vertex ou Foundry.
Publicado em Digest — 21 de setembro