Claude Code adopte AGENTS.md : comment structurer vos instructions de projet pour Claude et Codex
Anthropic a annoncé que Claude Code prend désormais en charge AGENTS.md, le fichier d'instructions Markdown promu par OpenAI. Concrètement, cela signifie qu'une équipe qui utilise à la fois Claude Code et Codex n'a plus forcément besoin de maintenir deux fichiers de consignes séparés. L'information a été rapportée par Génération NT, qui cite l'ingénieur Anthropic Thariq Shihipar pour les détails de version.
Pour les développeurs, l'enjeu est moins spectaculaire qu'il n'y paraît, mais il touche à un point sensible : la duplication des règles de projet entre plusieurs assistants. Voici ce que change cette prise en charge, et comment organiser vos instructions pour en tirer parti.
AGENTS.md, CLAUDE.md : de quoi parle-t-on ?
AGENTS.md est un document Markdown qui contient des instructions permanentes destinées à un agent d'IA. On y trouve typiquement les conventions de codage d'un projet, les commandes de build, les exigences de test et d'autres directives propres au dépôt. Le standard est open source et porté par OpenAI, concurrent direct d'Anthropic.
Jusqu'ici, les équipes qui combinaient les outils des deux éditeurs devaient gérer deux fichiers : CLAUDE.md pour Claude Code, AGENTS.md pour les autres agents. La prise en charge d'AGENTS.md par Claude Code réduit cette charge, puisque le même document peut servir à plusieurs assistants.
Ce que change concrètement la mise à jour
Selon la source, le support arrive dans la version 2.1.277 de Claude Code. Le comportement annoncé est le suivant : si aucun fichier CLAUDE.md n'est présent dans un dossier, Claude vérifie alors la présence d'un AGENTS.md et l'utilise. Ce comportement peut être activé ou désactivé dans la configuration.
Ce point mérite d'être souligné, car il détermine votre stratégie de migration. Claude Code ne remplace pas CLAUDE.md par AGENTS.md : il s'en sert comme solution de repli lorsque le fichier historique est absent. Si vous conservez un CLAUDE.md, c'est lui qui reste prioritaire.
Autre élément rapporté : l'implémentation repose sur un système de « mod » natif. La portée réelle de ce mécanisme et son calendrier de déploiement ne sont pas précisés dans les informations disponibles, et il convient donc de rester prudent sur ce que cela permettra à terme. La source indique seulement qu'il préfigure une personnalisation plus large, avec la possibilité pour les développeurs de créer leurs propres modules.
Pourquoi l'interopérabilité compte pour les équipes
Claude Code peut ainsi lire les mêmes instructions que Codex d'OpenAI, Gemini CLI ou GitHub Copilot. Pour une équipe qui fait cohabiter plusieurs assistants — un cas de plus en plus courant — cela évite de réécrire les mêmes règles à plusieurs endroits et de les voir diverger avec le temps.
Les réactions sont toutefois contrastées. Des développeurs ont salué sur les réseaux sociaux un pas vers l'interopérabilité, et Thibault Sottiaux, responsable produit chez OpenAI, a commenté positivement la décision, selon la source. Sur Reddit, d'autres utilisateurs ont jugé la mise à jour comme un petit ajustement attendu, en estimant que CLAUDE.md reste plus pertinent pour les utilisateurs intensifs de Claude. Le contenu exact des syntaxes spécifiques de CLAUDE.md évoquées dans ces discussions n'est pas détaillé.
La source rapporte également qu'AGENTS.md a été adopté fin 2025 par plus de 60 000 projets open source. Ce chiffre provient de la source et n'a pas été vérifié indépendamment ; il donne un ordre de grandeur de la dynamique du standard, pas une mesure exacte.
Comment structurer vos instructions de projet
La bonne approche dépend de votre outillage. Voici les cas les plus fréquents.
Vous utilisez uniquement Claude Code
Rien ne vous oblige à changer. CLAUDE.md reste prioritaire lorsqu'il est présent, et certains utilisateurs intensifs de Claude continuent de le considérer comme plus adapté à leurs usages. Vous pouvez néanmoins tester AGENTS.md sur un dépôt secondaire pour évaluer la différence.
Vous utilisez Claude Code et Codex (ou un autre agent)
C'est le cas où la mise à jour apporte le plus. Deux options se dessinent :
- Un AGENTS.md unique : vous centralisez les règles communes et laissez Claude Code s'en servir en l'absence de CLAUDE.md. Avantage : une seule source de vérité. Limite : vous perdez les spécificités propres à Claude si vous en aviez.
- Un AGENTS.md socle + un CLAUDE.md d'appoint : le premier contient les conventions partagées, le second les consignes spécifiques à Claude. Avantage : vous gardez le contrôle fin. Limite : deux fichiers à maintenir, avec un risque de divergence si vous ne définissez pas clairement ce qui va où.
Ce qu'il faut mettre dans le fichier
Quel que soit votre choix, un bon fichier d'instructions reste factuel et vérifiable. Les éléments généralement utiles :
- les commandes de build et de lancement des tests ;
- les conventions de nommage et de formatage ;
- les contraintes d'architecture ou de dépendances ;
- les règles de contribution et de revue.
Évitez les consignes vagues ou contradictoires : un agent suit ce qui est écrit, pas ce que vous aviez en tête.
À retenir
- Claude Code prend en charge AGENTS.md, selon Anthropic, avec un support annoncé dans la version 2.1.277.
- AGENTS.md sert de repli : il n'est utilisé que si aucun CLAUDE.md n'est présent dans le dossier, et le comportement est configurable.
- L'intérêt principal est de réduire la duplication d'instructions entre Claude Code, Codex, Gemini CLI et GitHub Copilot.
- Les avis divergent : interopérabilité saluée d'un côté, ajustement jugé mineur de l'autre.
- Le chiffre de plus de 60 000 projets adoptants provient de la source et n'est pas vérifié indépendamment.
Pour les équipes qui jonglent déjà avec plusieurs assistants, la question n'est pas tant de savoir quel fichier gagne, mais de décider où placer la vérité de votre projet — et de s'y tenir.
Cet article est publié par Roboto, une plateforme de génération de textes, images, vidéos et voix off avec l'IA.
Source
Anthropic aligne Claude Code sur le standard AGENTS.md
