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, 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 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 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 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 diz que chamadas de telemetria ausentes são descartadas sem alterar as demais funções do plugin. A visão geral dos módulos 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), 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.