AI-translated from English; not yet reviewed by a fluent editor. # Claude Code pode ignorar AGENTS.md quando a telemetria está desativada > O suporte nativo do Claude Code a AGENTS.md depende da versão, do acesso a sinalizadores de recurso, do provedor e da precedência entre arquivos. As linhas de telemetria do plugin agents-md lançado não registram caminhos nem o conteúdo dos arquivos. By BIG CHANGE Editorial Published: 2026-09-23T13:54:58.721Z Updated: 2026-09-23T13:54:58.721Z Canonical: https://bigchange.ai/blog/claude-code-agents-md-telemetry-feature-flags ![A desktop monitor shows a minimal project-instructions view with plain AGENTS.md and CLAUDE.md labels above a keyboard and mouse.](https://bigchange.ai/api/media/file/claude-code-project-instructions-hero-v2.png) AI-generated conceptual illustration by BIG CHANGE. O Claude Code 2.1.277 adicionou suporte nativo a instruções de repositório em `AGENTS.md`. Esse recurso tem uma limitação importante: a documentação atual da Anthropic diz que sessões sem acesso a sinalizadores de recurso — incluindo sessões com telemetria desativada e muitas configurações de provedores terceirizados — carregam apenas `CLAUDE.md`. O plugin `agents-md` separa o carregamento dos arquivos de suas linhas opcionais de telemetria. Essas linhas registram contagens e opções fixas, sem incluir caminhos ou o conteúdo dos arquivos. A dependência surge uma etapa antes: um sinalizador remoto determina se o carregador integrado está disponível. ## A grande mudança - **O que mudou:** Um arquivo local de instruções agora depende de uma etapa de liberação remota: o acesso a sinalizadores de recurso determina se o leitor integrado do Claude Code para `AGENTS.md` está disponível. - **Por que isso importa:** Dois desenvolvedores no mesmo commit podem receber instruções de projeto diferentes por causa da versão, do provedor ou das configurações de privacidade, o que dificulta reproduzir o comportamento do agente em uma equipe. - **O que observar:** Equipes que usam vários provedores ou ambientes restritos podem tratar o carregamento de instruções como uma dependência de execução, verificá-lo em cada configuração e usar uma importação em `CLAUDE.md` como alternativa portátil. ## O que o lançamento e a reportagem comprovam As [notas de lançamento da versão 2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277), datadas de 18 de setembro, dizem que o Claude Code lê `AGENTS.md` quando o projeto não tem o arquivo `CLAUDE.md`. As notas também excluem Bedrock, Vertex e Foundry dessa versão. A documentação atual sobre [memória de projeto](https://code.claude.com/docs/en/memory) também exclui a primeira sessão após instalar ou atualizar para uma versão compatível e as sessões em que o plugin integrado está desativado. A [reportagem que desencadeou a discussão](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) de Przemek Szypowski descreve um teste Canary na versão 2.1.280. Ele relata que `DISABLE_TELEMETRY` e `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` impediram que seu `AGENTS.md` fosse carregado, enquanto uma importação adjacente de `CLAUDE.md` funcionou. A BIG CHANGE não reproduziu esse teste com modelo pago. A documentação da Anthropic agora declara de forma independente as mesmas condições de disponibilidade. ## Disponibilidade do recurso e registro de telemetria são coisas distintas A documentação da Anthropic sobre [variáveis de ambiente](https://code.claude.com/docs/en/env-vars) diz que qualquer valor não vazio de `DISABLE_TELEMETRY` — inclusive `0` ou `false` — desativa a telemetria e a busca de sinalizadores de recurso. `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` e `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` também podem interromper essa busca. Sessões com provedores terceirizados ficam excluídas, a menos que o host de integração defina `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`; sessões pelo gateway dos aplicativos Claude também são excluídas. O README do [plugin lançado](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) diz que chamadas de telemetria ausentes são descartadas sem alterar as demais funções do plugin. A [visão geral dos módulos](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) do repositório identifica telemetria e `agents-md` como plugins integrados separados. O código descreve um carregador funcional; a documentação do produto explica se uma sessão recebe esse carregador. O registro opcional dentro do módulo não elimina a condição de disponibilidade externa. Em 23 de setembro, a BIG CHANGE baixou arquivos do repositório `agents-md` (README e [módulo de registro](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts)), comparando a branch `main` com a tag 2.1.280, lançada em 22 de setembro; cada par de arquivos era idêntico byte a byte. ## Quando o Claude Code carrega o arquivo Para um plugin disponível e ativado, o modo padrão segue esta precedência: | Arquivos de instruções | Resultado padrão | | --- | --- | | `AGENTS.md`, sem arquivo de instruções do Claude no projeto | `AGENTS.md` é carregado | | Arquivos do projeto: `CLAUDE.md`, `.claude/CLAUDE.md` ou `CLAUDE.local.md` no diretório de trabalho ou em um diretório superior | O carregamento direto `AGENTS.md` cede lugar a esses arquivos | | Arquivos do usuário ou gerenciados: `CLAUDE.md`, ou `.claude/rules/` | Eles não substituem `AGENTS.md` | Altere as instruções do projeto em `/config` para carregar os dois tipos de arquivo. A opção JSON pertence às configurações do usuário, `--settings` ou gerenciadas; os arquivos de configurações do projeto e locais são ignorados. ## A alternativa é uma importação explícita Para sessões sem suporte direto, a Anthropic recomenda adicionar um `CLAUDE.md` ao lado do arquivo compartilhado, com o seguinte conteúdo: `@AGENTS.md` A importação inclui o arquivo; uma instrução em prosa pedindo ao Claude que o leia deixa essa escolha a cargo do modelo. Confira `claude --version` e as instruções do projeto em `/config`. Na versão 2.1.280, `/memory` ou `/context` podem listar o arquivo `AGENTS.md` carregado diretamente; as versões compatíveis anteriores não o listavam ali. ## Sources - [Claude Code só lê AGENTS.md quando a telemetria está ativada](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) — Testes Canary na versão 2.1.280 e alternativa relatados por Przemek Szypowski. A BIG CHANGE não reproduziu o teste com modelo pago; o artigo separa as observações dele da documentação oficial do produto e da interpretação do código-fonte. - [Lançamento do Claude Code v2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) — Registro oficial do lançamento que introduziu o suporte a AGENTS.md e excluiu Bedrock, Vertex e Foundry da disponibilidade inicial. - [Como o Claude se lembra do seu projeto](https://code.claude.com/docs/en/memory) — Documentação oficial atual sobre versão mínima, precedência de arquivos, modos de instruções do projeto, condições de indisponibilidade da sessão, diagnóstico e alternativa de importação por CLAUDE.md. - [Variáveis de ambiente do Claude Code](https://code.claude.com/docs/en/env-vars) — Documentação oficial atual que mostra que desativar a telemetria também desativa a busca de sinalizadores de recurso, impedindo o carregamento direto de AGENTS.md, e lista outras sessões afetadas. - [Código-fonte e comportamento do plugin agents-md integrado, Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) — Descrição do código lançado sobre modos de arquivos de instruções, precedência e linhas opcionais de telemetria. Informa que essas linhas contêm contagens e opções fixas, não caminhos nem o texto dos arquivos. - [Plugins integrados do Claude Code, v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — Visão geral lançada que estabelece que telemetria e agents-md são plugins integrados separados e que o código marcado é distribuído dentro do Claude Code. - [Módulo de registro do agents-md, Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) — Código de registro lançado e inspecionado junto com o README. Em 23 de setembro, seus bytes correspondiam aos do arquivo correspondente na branch main.