O MUNDO NÃO ESTÁ PARADO.RSS
BIG CHANGE.
BIG CHANGE, à distância de um toque
BIG CHANGE, à distância de um toque

Abra espaço para ver o panorama geral.

Adicione a BIG CHANGE ao ecrã principal ou ambiente de trabalho. Abre numa janela própria, com as histórias mais recentes quando está online.

iPhone & iPad
Abra bigchange.ai no Safari. Toque em Partilhar e, em seguida, em Adicionar ao ecrã principal. Ative Abrir como aplicação web, se for apresentado, e toque em Adicionar.
Android
Abra bigchange.ai no Chrome. No menu do navegador, escolha «Instalar aplicação» ou «Adicionar ao ecrã principal».
Computador
No Chrome ou Edge, utilize o ícone de instalação na barra de endereço ou o menu de aplicações do navegador. No Safari para Mac, escolha Ficheiro → Adicionar à Dock.

Edição Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# O Claude Code pode ignorar o AGENTS.md quando a telemetria está desativada

> O suporte nativo do Claude Code ao AGENTS.md depende da versão, do acesso às feature flags, do fornecedor e da precedência dos ficheiros. As linhas de telemetria do plugin agents-md disponibilizado não incluem caminhos nem texto dos ficheiros.

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 acrescentou suporte nativo para instruções de repositório no ficheiro `AGENTS.md`. Há uma limitação importante: a documentação atual da Anthropic diz que as sessões sem acesso às feature flags, incluindo as que têm a telemetria desativada e muitas configurações de fornecedores terceiros, carregam apenas o ficheiro `CLAUDE.md`.

O plugin `agents-md` separa o carregamento de ficheiros das respetivas linhas de telemetria opcionais. Essas linhas contêm contagens e opções predefinidas, mas não incluem caminhos nem texto dos ficheiros. A dependência surge uma camada antes: uma feature flag remota determina se o carregador integrado está disponível.

## A grande mudança

- **O que mudou:** Um ficheiro local de instruções passou a depender de uma ativação remota: o acesso às feature flags determina se o `AGENTS.md` integrado está disponível.
- **Porque é importante:** Dois programadores no mesmo commit podem receber instruções diferentes para o projeto devido à versão, ao fornecedor ou às definições de privacidade, tornando mais difícil reproduzir o comportamento do agente em toda a equipa.
- **O que acompanhar:** As equipas que utilizam vários fornecedores ou ambientes bloqueados podem tratar o carregamento de instruções como uma dependência de execução, verificá-lo em cada configuração e manter um ficheiro `CLAUDE.md` como alternativa portátil.

## O que demonstram a versão e a reportagem

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, indicam que o Claude Code lê o ficheiro `AGENTS.md` quando o projeto não tem um ficheiro de instruções do Claude `CLAUDE.md`. As notas também excluem o Bedrock, o Vertex e o Foundry dessa versão.

A documentação atual sobre [a memória do projeto](https://code.claude.com/docs/en/memory) também exclui a primeira sessão após a instalação ou atualização para uma versão compatível, bem como as sessões em que o plugin integrado está desativado.

O [relato que motivou a investigação](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) de Przemek Szypowski descreve um teste canário na versão 2.1.280. Segundo o autor, `DISABLE_TELEMETRY` e `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` impediram o carregamento do seu `AGENTS.md`, enquanto um `CLAUDE.md` próximo funcionou. A BIG CHANGE não reproduziu esse teste, que envolveu um modelo pago. A documentação da Anthropic confirma agora, de forma independente, as mesmas condições de disponibilidade.

## A disponibilidade das funcionalidades e o registo da telemetria são coisas distintas

A documentação da Anthropic sobre [variáveis de ambiente](https://code.claude.com/docs/en/env-vars) indica que qualquer valor não vazio de `DISABLE_TELEMETRY`, incluindo `0` ou `false`, desativa a telemetria e impede a obtenção de funcionalidades. Também podem interromper essa obtenção: `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` e `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`. As sessões com fornecedores terceiros estão excluídas, exceto quando o anfitrião que integra o modelo define `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`; as sessões através do gateway das aplicações Claude também estão excluídas.

O [ficheiro README do plugin disponibilizado](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) diz que as chamadas de telemetria em falta são descartadas sem alterar as restantes tarefas 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 a telemetria e o `agents-md` como componentes integrados distintos.

O código descreve um carregador em funcionamento; a documentação do produto explica se uma sessão recebe esse carregador. O registo opcional dentro do módulo não elimina a condição de disponibilidade que o antecede.

A 23 de setembro, a BIG CHANGE obteve o `agents-md` README e o [módulo de registo](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) tanto de `main` como da etiqueta 2.1.280, lançada a 22 de setembro; os ficheiros de cada par eram idênticos byte a byte.

## Quando o Claude Code carrega o ficheiro

Para um plugin disponível e ativado, o modo predefinido segue esta ordem de precedência:

| Ficheiros de instruções | Resultado predefinido |
| --- | --- |
| `AGENTS.md` , sem ficheiro de instruções do Claude no projeto | `AGENTS.md` carrega |
| Projeto `CLAUDE.md` , `.claude/CLAUDE.md` ou `CLAUDE.local.md` no diretório de trabalho ou num diretório superior | Direto `AGENTS.md` o carregamento dá prioridade a esses ficheiros |
| Do utilizador ou gerido `CLAUDE.md` ou `.claude/rules/` | Estes não substituem `AGENTS.md` |

Altere as instruções do projeto em `/config` para carregar os dois tipos de ficheiro. A opção JSON deve estar nas definições do utilizador, em `--settings` ou nas definições geridas; os ficheiros de definições do projeto e locais são ignorados.

## A alternativa é incluir uma importação explícita

Para sessões sem suporte direto, a Anthropic recomenda incluir um ficheiro `CLAUDE.md` junto do ficheiro partilhado, com o seguinte conteúdo:

`@AGENTS.md`

A importação inclui o ficheiro; uma instrução em texto que peça ao Claude para o ler deixa essa escolha ao modelo.

Verifique a versão com `claude --version` e as instruções do projeto em `/config`. Na versão 2.1.280, `/memory` ou `/context` podem indicar um ficheiro `AGENTS.md`; as versões compatíveis anteriores não o apresentavam nesse local.

## Sources

- [Claude Code só lê o AGENTS.md quando a telemetria está ativada](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) — Testes canário da versão 2.1.280 e alternativa relatados por Przemek Szypowski. A BIG CHANGE não reproduziu o teste com o modelo pago; o artigo distingue as observações do autor 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) — Registo oficial do lançamento que introduziu suporte ao AGENTS.md e excluiu o Bedrock, o Vertex e o Foundry da disponibilidade inicial.
- [Como o Claude Code memoriza o seu projeto](https://code.claude.com/docs/en/memory) — Documentação oficial atual sobre a versão mínima, precedência dos ficheiros, modos das instruções do projeto, condições que impedem o carregamento numa sessão, diagnósticos e a alternativa de importação do CLAUDE.md.
- [Variáveis de ambiente do Claude Code](https://code.claude.com/docs/en/env-vars) — Documentação oficial atual que indica que a desativação da telemetria também impede a obtenção de funcionalidades e, por isso, o carregamento direto do AGENTS.md, além de enumerar outras sessões afetadas.
- [Código e comportamento do componente integrado agents-md, 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 disponibilizado para os modos e a precedência dos ficheiros de instruções e para as linhas de telemetria opcionais. Indica que essas linhas contêm contagens e opções predefinidas, não caminhos nem texto dos ficheiros.
- [Módulos integrados do Claude Code, v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — Visão geral disponibilizada que confirma que a telemetria e o agents-md são plugins integrados distintos e que o código identificado com essa etiqueta é distribuído no Claude Code.
- [Módulo de registo 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 registo disponibilizado e analisado em conjunto com o README. Em 23 de setembro, os bytes correspondiam aos do ficheiro equivalente no ramo main.