AGENTS.mdAGENTS.md : emplacement et lecture par les outils
AGENTS.md est un fichier Markdown en texte brut qui contient les instructions du projet et que la plupart des agents de programmation lisent sans configuration supplémentaire. OpenAI en a fait don à l’Agentic AI Foundation, sous l’égide de la Linux Foundation, et plus de 60k projets open source l’utilisent.
Emplacement
- AGENTS.md à la racine du dépôt, pour l’ensemble du projet.
- Fichiers AGENTS.md imbriqués dans des sous-répertoires ou des packages ; les agents utilisent le fichier le plus proche dans l’arborescence.
- OpenAI Codex : fichier global ~/.codex/AGENTS.override.md ou, s’il est vide ou absent, ~/.codex/AGENTS.md.
- Cline : fichier global ~/.agents/AGENTS.md.
- Claude Code accepte également .claude/AGENTS.md.
Format
Markdown en texte brut, sans frontmatter ni champs obligatoires ; tous les titres conviennent. Le format n’impose aucune limite de taille, mais OpenAI Codex arrête la lecture à project_doc_max_bytes, soit 32 KiB par défaut.
# Acme web app
Customer-facing web app with an admin area and a REST API.
## Commands
- Install: `pnpm install`
- Test: `pnpm test`
- Lint and type-check: `pnpm lint && pnpm tsc --noEmit`
## Code style
- TypeScript strict mode; no `any` in new code.
- Keep database access in `src/db/`.
## Never
- Never commit secrets or .env files.
- Never edit files under `src/generated/` by hand.
Priorité et fusion
Le fichier AGENTS.md le plus proche du fichier modifié prévaut, et toute instruction explicite dans le chat prime sur les fichiers. OpenAI Codex concatène un fichier par répertoire, de la racine du projet au répertoire de travail ; les fichiers les plus proches apparaissent donc en dernier et sont prioritaires. Claude Code ignore AGENTS.md par défaut dès qu’un fichier CLAUDE.md est présent.
Outils qui le lisent
| Outil | Compatibilité |
|---|---|
| OpenAI Codex | Pris en charge nativement. Lit un fichier global, puis au maximum un fichier par répertoire, de la racine au répertoire de travail, jusqu’à 32 KiB par défaut. |
| Claude Code | Pris en charge nativement depuis la v2.1.277, mais uniquement en l’absence de CLAUDE.md et de CLAUDE.local.md, sauf si claude-md-and-agents-md est défini. |
| Cursor | Pris en charge nativement, à la racine et dans les sous-répertoires ; les fichiers imbriqués se combinent avec ceux des répertoires parents, et le fichier le plus spécifique prévaut. |
| GitHub Copilot (cloud agent, code review, VS Code) | Pris en charge nativement, partout dans le dépôt ; le fichier le plus proche prévaut. |
| Devin Desktop (formerly Windsurf) | Pris en charge nativement. Le fichier à la racine est toujours actif ; un fichier dans un sous-répertoire s’applique à ce répertoire. |
| Cline | Pris en charge nativement, avec un fichier global ~/.agents/AGENTS.md ; activez ou désactivez cette option dans le panneau Rules. |
| Gemini CLI | À activer : ajoutez AGENTS.md à context.fileName dans .gemini/settings.json. |
| Aider | À activer : ajoutez read: AGENTS.md à .aider.conf.yml. |
| OpenClaw | Pris en charge nativement, comme fichier obligatoire d’instructions de fonctionnement dans l’espace de travail de l’agent. |
| Listed on agents.md (not individually re-verified) | L’un des 23 outils répertoriés sur agents.md, parmi lesquels Amp, Jules, Zed, Warp, goose, opencode et JetBrains Junie ; nous ne les avons pas vérifiés individuellement. |
Conseils
- Vous renommez un ancien AGENT.md ? agents.md recommande mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md afin que les deux noms restent utilisables.
- Indiquez les commandes de test et de lint : les agents essaient d’exécuter les vérifications indiquées et de corriger les échecs avant de terminer.
- Dans un monorepo, ajoutez un fichier AGENTS.md concis par package plutôt que d’allonger le fichier à la racine.
- Dans OpenAI Codex, AGENTS.override.md est prioritaire sur AGENTS.md dans le même répertoire.
Générez un AGENTS.md et des fichiers de règles correspondants pour cinq outils à partir d’un seul formulaire. Ouvrir le générateur AGENTS.md →