Claude Code lit enfin AGENTS.md, un an après la demande la plus votée de son dépôt

Anthropic a livré le 18 septembre la version 2.1.277 de Claude Code, qui lit désormais les fichiers AGENTS.md. Le mécanisme est un repli (fallback) : quand un dossier ne contient pas de CLAUDE.md, l'outil charge AGENTS.md à la place. L'annonce vient de Thariq Shihipar, ingénieur de l'équipe Claude Code, et la fonction est construite comme un « mod » dont le code source est publié sur le dépôt GitHub. Elle clôt un an de demandes insistantes de la communauté.

TL;DRL'essentiel pour les pressés

Claude Code charge AGENTS.md quand aucun CLAUDE.md n'est présent. Le réglage « Project instructions » dans /config offre quatre modes : CLAUDE.md seul, repli AGENTS.md, fichiers combinés, instructions gérées centralement.
CLAUDE.md garde la priorité quand il existe : les projets déjà configurés ne changent pas de comportement, personne ne voit ses instructions remplacées en silence.
La prise en charge est absente au lancement sur Amazon Bedrock, Google Vertex AI et Microsoft Foundry, les déploiements entreprise attendront.

20 000+dépôts GitHub utilisaient déjà AGENTS.md à l'été 2025, quelques mois après la création du format soutenu par OpenAI, Google, Sourcegraph et Cursor (Socket)

La demande la plus votée du dépôt, fermée puis exaucée un an après

AGENTS.md est né en mai 2025 d'un ras-le-bol : chaque agent de code imposait son fichier d'instructions, CLAUDE.md, GEMINI.md, copilot-instructions.md. Le format neutre, poussé par OpenAI, Google, Sourcegraph et Cursor, a été adopté par Codex, Gemini CLI, GitHub Copilot, Aider, Zed ou Warp. Claude Code restait le grand absent. L'issue GitHub #6235 réclamant cette prise en charge est devenue la plus votée du dépôt, avec deux fois plus de réactions que la deuxième. Boris Cherny, créateur de l'outil, l'avait fermée en proposant un contournement. La communauté y a vu un refus d'interopérabilité et une stratégie de verrouillage.

Claude Code lit CLAUDE.md, mais vous pouvez partager un même fichier avec d'autres agents : créez un CLAUDE.md contenant simplement l'import @AGENTS.md, ou faites de CLAUDE.md un lien symbolique vers AGENTS.md.

Boris Cherny, Anthropic, en réponse à l'issue GitHub #6235

Le revirement passe par les mods, la nouvelle couche de personnalisation de Claude Code. Un mod accroche des fonctions au harnais de Claude Code, la partie qui assemble le contexte et appelle les outils. Le modèle, lui, ne change pas. Quatre mods intégrés sont publiés dans le dépôt public : le chargeur AGENTS.md, un panneau de diff, la télémétrie et un mod de sécurité pour les organisations. Les mods personnalisés restent en accès anticipé, avec une API qui peut encore changer entre deux versions.

Mon avis : notable, pas un basculement. Anthropic cède sur le symbole après un an de résistance, mais garde la priorité à CLAUDE.md et livre la fonction hors des plateformes cloud tierces. Pour les équipes françaises qui font tourner plusieurs agents sur les mêmes dépôts, c'est surtout une ligne de maintenance qui disparaît.

Un seul fichier d'instructions pour tous vos agents

Si votre équipe alterne entre Codex, Gemini CLI et Claude Code sur les mêmes projets, vous pouvez supprimer les doublons : un AGENTS.md unique à la racine suffit pour les trois. Les liens symboliques et les imports @AGENTS.md deviennent inutiles. Le mode « deux fichiers combinés » couvre le cas le plus propre : les consignes communes dans AGENTS.md, les spécificités Claude (skills, hooks, sous-agents) dans un CLAUDE.md court par-dessus.

Si vous n'utilisez que Claude Code, rien ne change et rien n'est à faire. Si votre entreprise passe par Bedrock, Vertex AI ou Foundry, la fonction n'est pas encore disponible : gardez le contournement par import pour l'instant. Et si vos scripts d'automatisation SEO tournent dans Claude Code, c'est l'occasion de basculer les instructions partagées vers le format que les autres agents lisent aussi.

Ce que vous devez faireConcrètement, pour votre visibilité

Mets à jour Claude Code vers la 2.1.277 ou plus, puis ouvre /config et règle « Project instructions » sur le mode voulu : repli, combiné ou CLAUDE.md seul.
Dans les dépôts qui dupliquent CLAUDE.md et AGENTS.md, garde AGENTS.md comme source commune et réduis CLAUDE.md aux consignes propres à Claude, puis supprime les symlinks devenus inutiles.
Vérifie sur un dépôt de test que le fichier attendu est bien chargé au démarrage de session avant de généraliser, surtout si tes environnements mélangent postes locaux et Bedrock ou Vertex.