Claude Code da Anthropic adota AGENTS.md da OpenAI, simplificando o fluxo de trabalho dos devs

Introdução

AGENTS.md virou palavra de ordem nos times que trabalham com agentes de código. A decisão da Anthropic de suportar AGENTS.md no Claude Code, anunciada em 18 de setembro de 2026, coloca fim a uma dor diária, manter CLAUDE.md e AGENTS.md em paralelo, e aproxima os ecossistemas da OpenAI e da Anthropic em torno de um padrão de instruções que os agentes realmente leem no repositório. (theregister.com)

Essa convergência não nasce no vazio. AGENTS.md foi doado pela OpenAI à Agentic AI Foundation, hospedada pela Linux Foundation, para ganhar governança aberta e acelerar a adoção por ferramentas e frameworks. O resultado concreto, segundo a própria Linux Foundation, é uma base comum para instruções de agentes que já aparece em dezenas de milhares de projetos e em produtos populares de desenvolvimento. (linuxfoundation.org)

Este artigo analisa o que muda com o suporte do Claude Code ao AGENTS.md, por que isso importa para fluxos de trabalho, como aplicar o padrão na prática e quais armadilhas evitar ao migrar instruções de agentes entre provedores.

O que exatamente mudou no Claude Code

A alteração é simples, porém estratégica. A partir da versão 2.1.277 do Claude Code, quando um repositório não tiver um arquivo CLAUDE.md, a ferramenta passa a procurar automaticamente por AGENTS.md e a usar esse documento como fonte principal de instruções do agente. O comportamento pode ser ajustado via comando de configuração no próprio CLI, o que dá controle fino ao time para ativar ou desativar a compatibilidade conforme a necessidade. (theregister.com)

Notas de release rastreadas pela comunidade indicam ainda nuances operacionais. Em provedores como Bedrock, Vertex e Foundry, a compatibilidade pode não estar disponível no mesmo ritmo do release principal, ponto de atenção para equipes multicloud que distribuem agentes por diferentes runtimes. (ai-tldr.dev)

Para quem vive no dia a dia do código, o ganho é direto, menos arquivos redundantes no repositório, menos risco de drift entre instruções, menos scripts caseiros de symlink para manter CLAUDE.md e AGENTS.md sincronizados. É a eliminação de um atrito que, sozinho, não decide um roadmap, porém somado a outros, corrói horas de sprint. (theregister.com)

Por que AGENTS.md virou padrão de fato

AGENTS.md não é apenas um arquivo com dicas para o agente. É uma convenção emergente, com governança aberta na Agentic AI Foundation, para padronizar como ferramentas interpretam instruções de repositórios, desde comportamento esperado, guidelines de estilo, ferramentas permitidas, até políticas de segurança e limites de autonomia. O movimento para padronizar surgiu com tração em 2025, quando a Linux Foundation anunciou a fundação da AAIF com três projetos âncora, o Model Context Protocol da Anthropic, o goose da Block e o AGENTS.md da OpenAI. (linuxfoundation.org)

Desde então, a AAIF reportou um aumento acelerado de membros e de implementações, reforçando a tese de que padrões abertos para agentes são necessários para interoperabilidade real entre IDEs, CLIs, serviços de nuvem e runtimes de orquestração. Para empresas, isso significa reduzir lock-in em formatos proprietários e ganhar previsibilidade quando times usam múltiplos provedores. (linuxfoundation.org)

Na prática, AGENTS.md já aparece em SDKs e exemplos de agentes de código, inclusive no ecossistema open source da OpenAI, o que facilita aprender o formato e integrá-lo a pipelines de CI e revisões automatizadas. (github.com)

Como o novo suporte reduz fricções no workflow dos devs

• Onboarding mais rápido. Em projetos com AGENTS.md bem escrito, novos devs e agentes começam a produzir mais cedo, já que o arquivo deixa claro estilo, estrutura de branches, convenções de testes e políticas de segurança. Agora, com o Claude Code interpretando AGENTS.md quando não há CLAUDE.md, a configuração inicial de ambientes mistos OpenAI e Anthropic fica mais direta. (theregister.com)
• Menos duplicação. Manter CLAUDE.md e AGENTS.md em paralelo gerava inconsistências, frequentemente corrigidas com symlinks ou scripts de sincronização. A mudança elimina boa parte dessa manutenção. (theregister.com)
• Portabilidade de instruções. Se a equipe decide testar outro agente ou alternar entre fornecedores por custo, compliance ou features, as mesmas instruções continuam válidas. Essa portabilidade é um dos objetivos declarados da AAIF ao abrigar o AGENTS.md sob governança neutra. (linuxfoundation.org)
• Integração com SDKs e orquestração. A presença do AGENTS.md nas ferramentas e exemplos da OpenAI simplifica orquestrar turns, ferramentas e guardrails com menos glue code, algo essencial quando agentes passam a atuar em repositórios reais, e não apenas em sandboxes. (github.com)

Um guia rápido, escrevendo um AGENTS.md eficaz

AGENTS.md funciona melhor quando é específico, versionado e testável. Padrões que têm rendido bons resultados nos cases analisados incluem:

1. Contexto do projeto, objetivo claro, stack suportada, linguagens e versões homologadas.
2. Convenções de código e formatação, por exemplo, estilo do linter, padrões de docstring, regras de commit semântico e estrutura de PRs.
3. Políticas de dependências, ranges permitidos, repositórios privados permitidos, scanners de segurança a serem executados.
4. Fluxo de testes e de CI, como rodar suites localmente, thresholds de cobertura, e quais jobs do pipeline o agente pode disparar.
5. Ferramentas externas e escopo, que comandos de CLI são permitidos, quais APIs podem ser chamadas, limites de timeout e de custo por operação.
6. Guardrails, arquivos e pastas proibidos, dados sensíveis, regras de privacidade e de segurança, além de comportamento em caso de exceções.
7. Sinalização de autonomia, o que o agente pode fazer sozinho, o que exige aprovação humana, e quais rotas de escalonamento usar.

Esses elementos aparecem com frequência em guias e discussões públicas, bem como em documentação de SDKs de agentes. Em pipelines profissionais, o arquivo passa a ser mais uma peça auditável, revisada por PR, ao lado de testes e políticas de segurança. (github.com)

O pano de fundo, governança aberta e o fim do “cada um por si”

Padrões de agentes só decolam quando há governança e adesão multivendor. A Linux Foundation posicionou a Agentic AI Foundation como casa neutra para padrões, reunindo contribuições de OpenAI, Anthropic e Block, e apoio de grandes fornecedores de nuvem e tecnologia. O efeito, além de legitimidade, é a criação de um caminho público para evolução do AGENTS.md, com propostas de versão, issues e discussões abertas. (linuxfoundation.org)

Relatórios recentes da própria LF e de parceiros destacam que a padronização de agentes começa a ser comparada a protocolos de base da web, com novas camadas como MCP, para conexão a ferramentas, e iniciativas paralelas para descoberta e roteamento seguro de agentes. Isso ajuda a explicar por que a interoperabilidade ganhou urgência, especialmente em ambientes regulados. (linuxfoundation.org)

O que observar na migração de CLAUDE.md para AGENTS.md

• Controle de versões. Mover instruções sem versionamento claro pode quebrar pipelines. Trate AGENTS.md como código, com PR, revisão e changelog.
• Compatibilidade por provedor. Em alguns ambientes gerenciados, a compatibilidade pode chegar depois. Se o time roda Claude em plataformas como Bedrock ou Vertex, valide antes a disponibilidade da leitura de AGENTS.md. (ai-tldr.dev)
• Escopo mínimo viável. Evite transformar AGENTS.md em um dumping ground. Especifique o que o agente deve fazer, como deve se comportar e quais limites respeitar. Se necessário, complemente com arquivos específicos de ferramentas.
• Testes automatizados. Scripts que verificam conformidade com o AGENTS.md, por exemplo, checando se comandos e flags documentados batem com o que o agente realmente executa, reduzem regressões.

Nas comunidades técnicas, relatos mostram que uma boa curadoria do AGENTS.md corrige ruídos práticos, como nomes de jobs em CI divergentes do código. Pequenas inconsistências assim derrubam produtividade, e o arquivo de instruções bem cuidado vira um hub para alinhar humano e agente. (reddit.com)

O impacto estratégico, menos lock-in e mais produtividade

Ao suportar AGENTS.md, a Anthropic sinaliza um realinhamento com padrões abertos que interessam às empresas, especialmente quando a adoção de agentes cresce além de pilotos de equipe. Para CTOs, dois benefícios se destacam. Primeiro, queda do lock-in operacional em torno de instruções proprietárias. Segundo, melhor previsibilidade de custos de integração, já que ferramentas diferentes passam a respeitar o mesmo contrato de comportamento. (linuxfoundation.org)

Para times de plataforma, a facilidade de portar instruções entre agentes reduz o custo de experimentar novos provedores, comparar latência e qualidade de código gerado e reagir a mudanças de preço. Em mercados dinâmicos, essa margem de manobra vira vantagem competitiva.

O que vem a seguir para AGENTS.md e agentes de código

Comunidades já discutem propostas evolutivas, como versões do arquivo e campos mais estruturados para descrever habilidades e limites, sempre com o cuidado de manter simplicidade e legibilidade. A tendência é ver AGENTS.md coexistindo com descrições formais de ferramentas via MCP e com catálogos de habilidades por projeto. A governança aberta facilita esse caminho incremental. (reddit.com)

Para devs, a consequência prática é clara. Quanto mais as ferramentas convergirem em torno do AGENTS.md, mais fácil será padronizar a forma de instruir agentes em repositórios e automatizar revisões, testes e auditorias.

Conclusão

A adoção de AGENTS.md pelo Claude Code fecha uma lacuna que atrapalhava times híbridos. Em vez de manuais duplicados e scripts para sincronizar instruções, um único arquivo governa o comportamento dos agentes em repositórios, reduzindo fricções e acelerando entregas. O movimento também reforça o papel da Agentic AI Foundation como guardiã de padrões abertos para agentes. (theregister.com)

Para quem gerencia plataformas e para quem escreve código, o recado é o mesmo. Vale investir em um AGENTS.md objetivo, versionado e testável, e monitorar a compatibilidade nos diferentes provedores usados pelo time. Interoperabilidade não é slogan, é uma prática que começa no repositório e se traduz em mais velocidade, menos retrabalho e autonomia real para adotar o melhor de cada ecossistema.