AGENTS.md
AGENTS.md est un fichier Markdown d'instructions permanentes pour les agents de code, chargé dans leur contexte avant le début du travail.
Codex CLI le lit avant d'agir. En septembre 2026, il prend d'abord un fichier global dans son répertoire personnel (~/.codex par défaut), puis un fichier par répertoire entre la racine du projet et le répertoire de travail. Les consignes les plus proches arrivent donc en dernier et priment. AGENTS.override.md remplace le fichier ordinaire dans son répertoire, et /init crée un premier fichier.
Codex limite aussi la quantité chargée. Il cesse d'ajouter des fichiers dès que leur taille cumulée atteint project_doc_max_bytes, soit 32 Kio par défaut. Les instructions au-delà n'arrivent jamais au modèle. Cette chaîne est constituée au démarrage de Codex : une modification prend effet lors de l'exécution suivante.
Depuis la version 2.1.277, Claude Code lit AGENTS.md comme instructions de projet si aucun CLAUDE.md ne se trouve dans le répertoire de travail ou au-dessus. Un réglage lui permet de lire les deux. On peut aussi importer explicitement le fichier avec @AGENTS.md dans CLAUDE.md, pour partager les mêmes consignes entre plusieurs outils.
Partager le fichier évite les doublons, mais ne réduit pas son coût. Comme toute instruction chargée dans la session, AGENTS.md fait partie de chaque requête. Chacune de ses lignes est donc payée à chaque tour, par chaque agent qui la lit. Gardez les règles utiles à toutes les tâches et placez les autres là où elles ne seront chargées qu'au besoin.