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, 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 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 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 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 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 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 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.