AGENTS.md

O que é

AGENTS.md é o nome que boa parte dos assistentes de código adotou para o arquivo de instruções do repositório. O Claude Code não usa esse nome: ele lê CLAUDE.md.

Isso não é um impasse, e não exige gambiarra. Se o seu repositório já tem um AGENTS.md, você liga um no outro com uma linha de importação no topo do CLAUDE.md:

@AGENTS.md

O Claude Code expande o arquivo importado no início da sessão e segue lendo o resto do CLAUDE.md depois. Assim as duas ferramentas leem o mesmo texto e você mantém um arquivo só. Abaixo da importação você pode acrescentar o que for específico do Claude.

Se não houver nada específico a acrescentar, um link simbólico resolve igual. No Windows criar link simbólico exige privilégio de administrador ou o modo de desenvolvedor, então lá prefira a importação.

Use quando o projeto é trabalhado por mais de um assistente, ou quando você alterna entre ferramentas conforme o limite de uso de cada plano. Não use para duplicar conteúdo: dois arquivos com o mesmo texto divergem na primeira semana, e instruções conflitantes fazem o modelo escolher uma delas por conta própria.

Existe ainda um caminho de mão única: o comando /import traz a configuração de outro assistente para dentro do Claude Code — anexa uma cópia do arquivo de instruções ao CLAUDE.md correspondente e transfere servidores MCP, comandos, subagentes e skills. É cópia, não vínculo: depois disso os arquivos seguem vidas separadas.

Relacionado

• claude-md

Você pode estar procurando isso se

• uso duas ferramentas de ia no mesmo projeto e uma não sabe o que a outra fez
• meu repositório já tem um arquivo de instruções com outro nome
• tenho que manter dois arquivos dizendo a mesma coisa
• o outro assistente parece que nunca leu nada do projeto