Claude Code lit AGENTS.md, et ouvre ses mods

Ce qui se passe

« À partir d'aujourd'hui, en version 2.1.277, s'il n'y a pas de CLAUDE.md dans un dossier, Claude lira AGENTS.md », a annoncé Thariq Shihipar, d'Anthropic, le 18 septembre 2026. AGENTS.md est le fichier de consignes que lisent Codex, Cursor et d'autres agents ; les équipes qui en utilisent plusieurs maintenaient jusqu'ici deux fichiers, ou un lien symbolique entre les deux.

Le plus intéressant est la manière. Le support n'est pas écrit dans le moteur : c'est un mod, le nom qu'Anthropic donne à sa prochaine façon de personnaliser le harnais.

Ce qu'est un mod

Un mod est un plugin Claude Code dont le comportement tient dans un module de hooks : une entrée register(on, options) qui s'accroche aux événements du moteur (session.start, prompt.context, tool.call…). Quatre mods sont livrés dans le binaire et leur source est publiée dans le dépôt anthropics/claude-code, dossier mods/ : agents-md, diff (la commande /diff), telemetry et sec-default, qui protège les réglages gérés d'une organisation des plugins installés par une personne. Chacun se teste avec claude plugin test <dossier>.

Les quatre modes

Le mod agents-md expose une seule option, instructionFiles :

Valeur	Effet
`claude-md-or-agents-md` (défaut)	AGENTS.md chargé seulement si le projet n'a pas de fichier d'instructions à lui
`claude-md-and-agents-md`	AGENTS.md chargé à côté de CLAUDE.md, sans doublon si l'un importe l'autre ou est un lien vers lui
`claude-md`	CLAUDE.md seul, comme avant
`managed-only`	consignes du projet et de la personne retirées ; celles de l'organisation restent

« À lui » a un sens précis : un CLAUDE.md, .claude/CLAUDE.md ou CLAUDE.local.md dans n'importe quel dossier entre la racine et le dossier courant suffit pour que le mod s'efface. Le fichier géré de l'organisation, ~/.claude/CLAUDE.md, les fichiers .claude/rules et le CLAUDE.md d'un dossier ajouté ne comptent pas. Un AGENTS.md chargé est traité exactement comme un fichier de projet : même place, même présentation, mêmes règles d'omission pour les agents Explore et Plan.

Comment le régler

Dans /config, ligne Project instructions. À la main, dans ~/.claude/settings.json, en paramètre --settings ou dans les réglages gérés :

JSON

{
  "pluginConfigs": {
    "agents-md@builtin": {
      "options": { "instructionFiles": "claude-md-and-agents-md" }
    }
  }
}

Le .claude/settings.json du projet n'est pas lu pour cette option : le choix appartient à la personne ou à l'organisation, pas au dépôt.

Ce qui diffère encore de CLAUDE.md

La documentation liste huit écarts. Les plus visibles :

un AGENTS.md imbriqué n'est joint que lors d'un Read de fichier texte, pas pour un fichier mentionné par @ ou ouvert dans l'IDE ;
les dossiers ajoutés par --add-dir n'apportent pas leur AGENTS.md ;
/memory et le raccourci # ignorent les AGENTS.md.

Source : mods/agents-md, dépôt anthropics/claude-code sur GitHub, 18 septembre 2026. Annonce citée par Simon Willison.