Claude Code só lê AGENTS.md com a telemetria ligada

O Claude Code só lê AGENTS.md quando a telemetria está ligada, segundo um relato de bug aberto contra o agente de programação da Anthropic em 20 de setembro de 2026. O recurso chegou na versão 2.1.277. Quem desligou o envio de dados de uso, ou usa a ferramenta pelo Amazon Bedrock ou pelo Google Vertex, não recebe AGENTS.md nenhum. Nada na tela avisa isso.

O relato é a issue #95690 no repositório público do Claude Code. Um post de blog publicado em 23 de setembro detalha o mesmo comportamento e uma solução alternativa.

O que o suporte a AGENTS.md deveria fazer

AGENTS.md é um arquivo de instruções em texto simples compartilhado por vários agentes de programação. Ele diz a um agente como um projeto é compilado, testado e organizado. O Claude Code tem um arquivo próprio para essa tarefa, chamado CLAUDE.md.

A versão 2.1.277 prometia uma regra simples. Nas palavras das notas da versão citadas pela issue, "em um projeto sem CLAUDE.md, o Claude Code lê AGENTS.md no lugar". O Tech AI Wire cobriu essa mudança quando ela saiu: Claude Code 2.1.277 lê AGENTS.md como alternativa.

Por que não funciona sem telemetria

Segundo a issue, o recurso não faz parte do carregamento normal. Ele é um plugin embutido que vem desligado por padrão. Um interruptor remoto o liga.

Esse interruptor é um feature flag chamado tengu_agents_md_mod, servido pela Statsig. A Statsig é um serviço externo que permite a uma empresa ligar ou desligar recursos para os usuários sem lançar uma nova versão. Para consultar o flag, o Claude Code precisa contatar esse serviço.

Ele não consegue fazer isso em várias configurações comuns, concordam a issue e o post.

Configuração	AGENTS.md é carregado?
Instalação padrão, telemetria ligada	Sim, quando o flag está ligado
DISABLE_TELEMETRY=1 definido	Não
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 definido	Não
Pelo Bedrock ou pelo Vertex	Não

Em cada caso "não", o arquivo é simplesmente ignorado. A issue descreve o resultado sem rodeios: "Nenhum erro. Nenhum aviso. Ele simplesmente não carrega." O autor do relato classificou o impacto como crítico.

A queixa: um arquivo local atrás de um interruptor remoto

As duas fontes fazem o mesmo argumento. Ler um arquivo Markdown da pasta do projeto não precisa de rede. Amarrar isso a um flag no servidor faz uma escolha de privacidade desligar em silêncio um recurso sem relação.

A issue fala em "ler um arquivo Markdown local, um ato que não exige rede nenhuma", que "fica trancado em silêncio por um interruptor no servidor". O post transforma isso em regra: "Uma configuração de privacidade nunca deveria desligar em silêncio um comportamento local sem relação."

A solução alternativa

O post traz uma correção que funciona hoje. Crie um CLAUDE.md no projeto e faça-o importar o outro arquivo com uma linha: @AGENTS.md. O Claude Code sempre lê CLAUDE.md, e a importação traz AGENTS.md junto. Nenhum flag entra na história.

O que isso significa para desenvolvedores

Verifique se a sua configuração cai em alguma das linhas "não" acima. Times que desligam a telemetria por política da empresa e times que acessam o Claude por um provedor de nuvem são os casos prováveis. Se algum deles se aplica, considere que AGENTS.md não está sendo lido, digam o que disserem as notas da versão.

A importação de uma linha no CLAUDE.md é o padrão seguro por enquanto. Ela custa um único arquivo pequeno e se comporta igual em qualquer configuração. Se você apagou um CLAUDE.md depois da versão 2.1.277, coloque de volta um enxuto.

Teste as instruções em vez de confiar nelas. Peça ao agente que repita uma regra que só existe no AGENTS.md, como o seu comando de testes. Se ele não conseguir, o arquivo não foi carregado. Faça isso uma vez em cada ambiente que o seu time usa.

Acompanhe a issue #95690 à espera de uma correção. A lição maior é que o comportamento de uma ferramenta pode depender de interruptores que você não vê. Manter as instruções em um arquivo que a ferramenta sempre lê é a escolha confiável.