Claude Code agora recorre ao AGENTS.md, simplificando repositórios multiagente

O Claude Code passa a ler o ficheiro AGENTS.md de um repositório quando não existe nenhum ficheiro de instruções específico do Claude, colmatando uma lacuna para equipas que executam vários agentes de programação de IA na mesma base de código. A alteração foi incluída no Claude Code 2.1.277, anunciada a 18 de setembro de 2026 pela equipa do Claude Code: se uma pasta não tiver CLAUDE.md, o Claude verifica e utiliza o AGENTS.md em alternativa.

Uma solução de recurso, não uma substituição

Este comportamento só se aplica quando não está presente nenhum ficheiro específico do Claude. Se o Claude Code encontrar um CLAUDE.md, um .claude/CLAUDE.md ou um CLAUDE.local.md em qualquer ponto do caminho para o diretório de trabalho, esse ficheiro prevalece e o AGENTS.md é ignorado. Quando nenhum destes existir, o AGENTS.md pode fornecer as regras de programação, os passos de compilação e os requisitos de teste do projeto. A funcionalidade é disponibilizada como um módulo integrado e as equipas podem ajustar o comportamento — apenas CLAUDE.md, AGENTS.md como alternativa, ambos carregados em conjunto ou uma lista restrita de origens — através de /config, definições do utilizador ou definições geridas.

Porque razão os repositórios acumulam ficheiros duplicados

As equipas que utilizam várias ferramentas acabam muitas vezes com mais do que um ficheiro de instruções no mesmo repositório: CLAUDE.md para o Claude Code, AGENTS.md para o Codex, o Cursor e outros. Estes ficheiros começam por ser cópias uns dos outros e divergem até que um deles aponte a um agente um comando de compilação que já não funciona. Um AGENTS.md partilhado elimina essa duplicação nos repositórios que não precisam de instruções específicas do Claude.

O que ter em conta antes de depender desta funcionalidade

• CLAUDE.md continua a prevalecer por predefinição — as equipas que pretendem que ambos os ficheiros sejam considerados precisam de alterar explicitamente a definição de origem das instruções.
• O suporte tem atualmente lacunas nas implementações do Bedrock, Vertex e Foundry, pelo que o mesmo repositório pode resolver as instruções de forma diferente consoante o fornecedor que cada membro da equipa utiliza.
• Um problema do GitHub em acompanhamento (#96005) assinala instruções duplicadas quando a mesma orientação também chega através de um segundo canal, como, por exemplo, um orquestrador de agentes — vale a pena verificar antes de assumir que o AGENTS.md é, por si só, a fonte definitiva.

Para os MSPs que estão a uniformizar um único ficheiro de instruções em repositórios de clientes que utilizam um conjunto misto de ferramentas de agentes, isto elimina uma fonte real de divergência — mas vale a pena confirmar qual o fornecedor e a versão do Claude Code que cada equipa executa antes de tratar o AGENTS.md como a única fonte de verdade.

Fontes: DevOps.com, dev.to.