L'outil de programmation Claude Code, d'Anthropic, prend en charge AGENTS.md depuis la version 2.1.277. La règle est simple : quand un dossier n'a pas de CLAUDE.md, Claude Code cherche un fichier AGENTS.md dans ce même dossier et le charge dans le contexte comme instruction de projet ; là où un CLAUDE.md existe déjà, l'outil continue de ne lire que ce fichier, comme avant.
Cette version a été publiée sur GitHub le 18 septembre. Thariq, membre de l'équipe Claude Code, a annoncé ce changement sur un réseau social :
"Starting today in version 2.1.277, if there is no CLAUDE.md in a folder, Claude will check for and use AGENTS.md."
(Dès aujourd'hui, avec la version 2.1.277, si un dossier n'a pas de CLAUDE.md, Claude recherchera et utilisera AGENTS.md.)
Quatre niveaux de réglage
La prise en charge d'AGENTS.md est implémentée sous forme de plugin intégré, dont le code est public dans le dépôt GitHub de Claude Code. L'utilisateur bascule d'un mode à l'autre dans "Project instructions", sous /config, avec quatre niveaux au total :
| Mode | Comportement |
|---|---|
| claude-md | Ne lit que CLAUDE.md, revient à désactiver la fonction |
| claude-md-or-agents-md (par défaut) | Si le dossier a un CLAUDE.md, ignore l'AGENTS.md qui s'y trouve ; sinon, le lit |
| claude-md-and-agents-md | Lit les deux types de fichiers dans toute l'arborescence |
| managed-only | Écarte les fichiers d'instructions commités dans le dépôt et les fichiers personnels, ne garde que ceux distribués de façon centralisée par l'organisation, ainsi que la mémoire |
Le mode par défaut est un repli, pas une fusion de contenu. Les dépôts qui ont déjà un CLAUDE.md prévu pour Claude Code ne changent pas de comportement après la mise à jour ; seuls les dépôts qui n'ont jamais eu de CLAUDE.md, et qui n'avaient préparé un AGENTS.md que pour d'autres outils, chargeront ce fichier pour la première fois. Si un même fichier est identifié comme un doublon d'après son chemin ou son contenu, il n'est pas chargé deux fois.
Encore quelques écarts avec CLAUDE.md
La documentation du plugin liste plusieurs différences par rapport à CLAUDE.md. Un AGENTS.md situé dans un sous-dossier n'est joint que lorsque l'agent utilise Read pour lire un fichier texte de ce dossier ; une sélection dans l'IDE, un notebook, une image ou un PDF ne déclenchent pas cet ajout. Les fichiers ainsi joints ne sont pas marqués comme lus et ne reviennent pas automatiquement après une compression du contexte. La commande /memory et le raccourci mémoire rapide avec # n'atteignent pas non plus AGENTS.md, les dossiers ajoutés via --add-dir ne fournissent pas d'AGENTS.md, et les chemins de liens symboliques sont comparés littéralement, sans résolution.
Côté canaux, AWS Bedrock, Google Vertex et Microsoft Foundry ne sont pas encore pris en charge. Cette même version apporte un autre changement lié aux fichiers d'instructions : au démarrage en mode SDK ou sans interface, le premier tour de conversation n'attend plus la fin de la recherche de CLAUDE.md.
Un dépôt, plusieurs agents
AGENTS.md équivaut à un README écrit pour les agents de programmation : comment compiler, comment lancer les tests, quelles conventions de style de code suivre, quels dossiers éviter. Ce format a d'abord été porté conjointement par OpenAI Codex et quelques autres outils en 2025, avant d'être confié à l'Agentic AI Foundation, rattachée à la Linux Foundation ; Cursor, GitHub Copilot et d'autres outils le reconnaissent. Claude Code ne lisait jusqu'ici que son propre CLAUDE.md, obligeant les équipes qui utilisent plusieurs outils à maintenir en parallèle deux fichiers au contenu presque identique ; une solution courante dans la communauté consistait à utiliser un lien symbolique pour que les deux pointent vers le même fichier.
Les équipes en Chine combinent souvent un ensemble d'outils encore plus varié : outre Claude Code, on y trouve fréquemment Kimi Code, Qwen Code, Cursor et Codex, dont beaucoup lisent AGENTS.md par défaut ou permettent de renommer le fichier d'instructions. En mode par défaut, les anciens dépôts n'ont rien à modifier ; les équipes qui souhaitent ne maintenir qu'un seul AGENTS.md peuvent supprimer CLAUDE.md et y regrouper les instructions, mais doivent d'abord passer en revue les limites mentionnées plus haut, notamment le fait que les instructions des sous-dossiers ne reviennent pas automatiquement après compression du contexte dans les sessions longues.
Le niveau managed-only s'adresse aux administrateurs d'entreprise. Les fichiers d'instructions commités dans le dépôt sont exécutés par l'agent comme des instructions, ce qui constitue en soi une porte d'entrée pouvant être empoisonnée ; ce niveau permet aux administrateurs de n'autoriser que les règles distribuées de façon centralisée par l'organisation. On ne dispose pas encore de données publiques sur l'usage de ce niveau dans les grandes équipes.
Sources : notes de version GitHub de Claude Code, CocoLoop, publication publique de l'ingénieur Anthropic Thariq ; les quatre modes, l'ordre de chargement et les restrictions ont été vérifiés dans la documentation du plugin agents-md.