Claude Code AGENTS.md é realidade a partir da versão 2.1.277: o Claude Code da Anthropic agora lê e obedece o arquivo AGENTS.md quando não há CLAUDE.md na pasta do projeto.

A mudança foi anunciada pelo engenheiro Thariq Shihipar em 18 de setembro de 2026: "Starting today in version 2.1.277, if there is no CLAUDE.md in a folder, Claude will check for and use AGENTS.md." Thibault Sottiaux, head of core product da OpenAI, respondeu positivamente — um sinal raro de alinhamento entre os dois concorrentes em torno de um padrão aberto.

O que é o AGENTS.md e por que este anúncio é relevante

O AGENTS.md é um arquivo Markdown padronizado, agnóstico de ferramentas, que define instruções para agentes de codificação com IA dentro de um projeto: comportamento esperado, ferramentas preferidas, convenções de código e contexto do repositório.

O formato foi criado pela OpenAI e contribuído à Agentic AI Foundation, organização vinculada à Linux Foundation. Mais de 60 mil repositórios open-source já adotaram o padrão antes desta atualização. Antes do suporte ao Claude Code AGENTS.md, desenvolvedores que usavam Claude junto com outros agentes tinham que manter 2 arquivos separados: CLAUDE.md e AGENTS.md, com workarounds como symlinks para sincronizá-los.

Com a versão 2.1.277, os 4 principais agentes de codificação com IA são compatíveis com o mesmo arquivo:

  • Claude Code (Anthropic)
  • OpenAI Codex
  • GitHub Copilot (Microsoft)
  • Gemini CLI (Google)

Como usar e o que não mudou

O suporte ao Claude Code AGENTS.md é configurável via /config — não é substituição forçada. Repositórios com CLAUDE.md não são afetados: o AGENTS.md só entra como fallback quando não existe um CLAUDE.md no diretório.

Há uma limitação: o suporte não está disponível em Bedrock, Vertex ou Foundry no lançamento inicial.

O anúncio veio 1 dia após a Anthropic redesenhar os Claude Code Projects com foco em coordenação de múltiplas threads de agentes. A combinação aponta para uma tendência: Anthropic está apostando em compatibilidade com o ecossistema em vez de padrões proprietários.

Por que isso importa para o seu negócio

Se a sua empresa mantém repositórios com instruções personalizadas para agentes de IA, o suporte ao Claude Code AGENTS.md reduz fricção operacional. Um único arquivo de instruções funciona independente de qual agente o desenvolvedor usa.

O sinal maior é que a Anthropic, que concorre diretamente com a OpenAI, escolheu adotar um padrão criado pelo concorrente em vez de exigir o próprio formato. Isso indica que o AGENTS.md está se tornando o padrão de fato do setor — apostar nele como base das instruções dos seus agentes é decisão com respaldo crescente.

Para entender o contexto de segurança dos agentes que usam esses arquivos, veja Plugin4Shell: a falha zero-click nos agentes de IA e Claude Code Projects: Anthropic lança coordenador de agentes que não esquece o projeto.

Conteúdo reescrito e traduzido para PT pela redação luiscortex, revisado por humano.

Fonte: The Register