Claude Code 2.1.277 lê AGENTS.md como alternativa

O Claude Code agora lê AGENTS.md, um arquivo de instruções compartilhado por vários agentes de programação rivais, quando um projeto não tem o seu próprio CLAUDE.md. A mudança chegou em 18 de setembro de 2026, na versão 2.1.277. Um único arquivo pode agora informar mais de uma ferramenta, o que remove uma tarefa de manutenção pequena mas real de qualquer repositório que use duas.

O registro de mudanças da Anthropic enuncia a regra em uma linha: "in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under 'Project instructions'". A publicação no GitHub correspondente saiu no mesmo dia, às 18h06 UTC.

O que é AGENTS.md

AGENTS.md é um arquivo Markdown simples guardado no repositório. Ele explica a um agente de programação como o projeto funciona, do mesmo modo que um guia de contribuição explica isso a uma nova colega.

O site do AGENTS.md chama o formato de "a README for agents: a dedicated, predictable place to provide the context and instructions to help AI coding agents work on your project". Descreve o conteúdo como "build steps, tests, and conventions that might clutter a README or aren't relevant to human contributors".

O formato não é da Anthropic. Ele nasceu de um trabalho que envolveu OpenAI Codex, Amp, Jules do Google, Cursor e Factory. Agora é conduzido pela Agentic AI Foundation, sob a Linux Foundation. O projeto afirma que mais de 60.000 repositórios de código aberto no GitHub carregam o arquivo.

Como a alternativa se comporta

A ordem de busca é a função inteira, e ela é curta.

Item	Detalhe
Versão	2.1.277
Publicada	18 de setembro de 2026, 18h06 UTC
Regra	AGENTS.md só é lido quando o projeto não tem CLAUDE.md
Interruptor	"Project instructions" em /config
Ainda não disponível em	Bedrock, Vertex, Foundry

Nada muda para um repositório que já tem um CLAUDE.md. Esse arquivo continua vencendo, e o novo comportamento nunca junta os dois. Um projeto usa um ou o outro.

A alternativa também pode ser desligada. O registro da Anthropic aponta para um interruptor em "Project instructions", no menu /config.

Um limite merece atenção antes de alguém construir sobre isso. O registro diz que o suporte a AGENTS.md não chegou a Bedrock, Vertex ou Foundry. Equipes cujos desenvolvedores usam o Claude Code por um provedor de nuvem verão comportamento diferente dos colegas que o executam diretamente.

O resto da versão

A versão 2.1.277 não trouxe apenas essa função. As notas da Anthropic listam mais de 50 correções, espalhadas pelo desenho do terminal, pelas operações com arquivos e pelos servidores MCP, as peças de ligação que permitem a um agente alcançar ferramentas externas.

Duas correções chamam atenção de quem já as enfrentou. Os pedidos de permissão para comandos de remoção perigosos agora nomeiam o comando sinalizado e sugerem uma proteção ${VAR:?}. Assim uma variável não definida falha, em vez de apagar o caminho errado. Servidores configurados como HTTP que ainda usavam o transporte antigo de HTTP e Server-Sent Events já não falham com respostas 422 e outras 4xx.

Uma segunda versão veio em 19 de setembro. A 2.1.278 passou o modo automático a usar, por padrão, um classificador no servidor, para usuários da API do Claude e do Enterprise.

O que isso significa para os desenvolvedores

Verifique primeiro qual arquivo o seu repositório realmente tem. Se houver um CLAUDE.md, esta versão não muda nada para você, e um AGENTS.md colocado ao lado continuará sem ser lido.

Para um projeto que aceita colaboradores em vários agentes, o passo prático é claro. Mantenha um AGENTS.md e apague o CLAUDE.md que apenas o duplica. Isso agora é uma configuração suportada, e não um contorno. Guarde um CLAUDE.md só onde as instruções realmente mudem de ferramenta para ferramenta.

Fique atento à divisão dentro do time. Como as versões em nuvem ainda não têm isso, um colaborador no Bedrock pode obter comportamento diferente de quem usa a ferramenta de linha de comando, sem nenhum erro que explique a diferença. Se as suas instruções de agente contam no processo de revisão, deixe escrito no repositório qual arquivo vale.

Há um ponto mais amplo sobre a velocidade com que esse comportamento muda sob os seus pés. O Claude Code passou a escrever um link de sessão nas mensagens de commit a menos que você recuse, um padrão que chegou aos repositórios antes de muitas equipes perceberem. Configuração versionada no repositório e revisada como código é a defesa contra as duas surpresas.

Fixe a versão se o seu fluxo de trabalho depender do comportamento anterior. Aqui as versões chegam todos os dias, e um padrão que troca entre duas delas é mais fácil de absorver quando todo o time usa a mesma compilação.