À quoi sert ce fichier
Chaque session de Claude Code ou de Codex (l'outil de ChatGPT qui travaille sur un dossier) commence sans aucun souvenir de la précédente. Le fichier de règles est ce qu'elle relit en premier : vos consignes, vos conventions, les erreurs à ne plus refaire. Sans lui, vous répétez les mêmes corrections à chaque conversation.
Le problème : les deux outils ne cherchent pas le même nom de fichier.
Qui lit quoi
Claude Code
Lit CLAUDE.md, à la racine du dossier et dans les dossiers au-dessus.
Ne lit AGENTS.md à la place que s'il ne trouve aucun CLAUDE.md, ni CLAUDE.local.md. Il faut la version 2.1.277 ou plus récente, et certaines sessions ne le lisent pas du tout.
Recommande moins de 200 lignes par fichier : plus long, il suit moins bien les consignes.
Codex (ChatGPT)
Lit AGENTS.md (ou AGENTS.override.md s'il existe), de la racine du projet jusqu'au dossier de travail, un fichier par dossier.
Sa documentation ne mentionne pas CLAUDE.md.
S'arrête à 32 Kio de consignes au total : au-delà, la fin n'est pas lue.
La solution : deux fichiers, une seule source
Toutes vos règles vont dans AGENTS.md. Votre CLAUDE.md ne contient qu'une ligne : @AGENTS.md.
Dans un CLAUDE.md, une ligne qui commence par @ suivie d'un chemin importe ce fichier : Claude le lit comme s'il était recopié à cet endroit. Codex lit AGENTS.md directement. Résultat : les deux outils appliquent exactement les mêmes règles, et vous n'en modifiez qu'un seul.
Pourquoi ne pas compter sur la lecture directe d'AGENTS.md par Claude ? Parce qu'elle saute dès qu'un CLAUDE.md apparaît, et qu'elle n'existe pas dans toutes les sessions. L'import, lui, marche partout.
Ce qu'on met dedans
Le fichier est relu en entier à chaque session : chaque ligne compte. Ce qui marche le mieux, ce sont des règles courtes, chacune avec le signe qui montre que l'IA est en train de l'enfreindre. Par exemple :
On n'écrase jamais une valeur : la valeur actuelle reste en haut, l'ancienne descend dans l'historique avec sa date. Le signe : une fiche modifiée dont l'historique n'a pas bougé.
Une procédure en plusieurs étapes n'a pas sa place dans ce fichier : elle devient un skill, une recette que l'IA ne charge que quand on en a besoin.
Le récit d'une erreur, avec vos mots, va dans un fichier à part que l'IA n'ouvre que si on le lui demande. Le fichier de règles ne garde que la règle.
Trois pièges
Un CLAUDE.local.md ajouté en passant. Il compte comme un CLAUDE.md : si votre projet comptait sur la lecture directe d'AGENTS.md, Claude cesse de le lire. Avec l'import @AGENTS.md, le problème ne se pose pas.
Un fichier qui grossit sans fin. Codex en ignore la fin au-delà de 32 Kio, et Claude suit moins bien un fichier long. Relisez-le régulièrement, et déplacez ce qui ne sert pas à chaque session.
Une règle que rien ne contrôle. La documentation de Claude Code le dit elle-même : ces fichiers sont un contexte, pas une configuration imposée. Une règle qui doit tenir à coup sûr se double d'un contrôle automatique.
Sources, lues le 18 novembre 2026 : documentation de Claude Code, page « How Claude remembers your project » (code.claude.com/docs/en/memory) ; documentation de Codex, page « AGENTS.md » (learn.chatgpt.com/docs/agent-configuration/agents-md). Claude est une marque d'Anthropic ; ChatGPT et Codex sont des marques d'OpenAI.