Depuis le 19 septembre, Claude Code prend nativement en charge le format des instructions de projet du projet AGENTS.md lancé par OpenAI, mettant fin à la longue période où il ne supportait que son propre CLAUDE.md. Cette démarche vise à résoudre la douleur des développeurs qui doivent maintenir deux fichiers très similaires en double, et renforce l’extensibilité via le système de plugins Mod. Dans la conception des fonctionnalités, on voit aussi une tendance à s’inspirer de concurrents comme DeepSeek.

Auteur de l’article : Quantum Channel

Source : Mars Finance

Claude s’est rendu au format OpenAI.

Depuis le 19 septembre, Claude Code prend nativement en charge AGENTS.md.

Il s’agit d’un format de fichier d’instructions de projet introduit par OpenAI en août 2025. Auparavant, Claude Code s’obstinait à ne lire que son CLAUDE.md.

C’est maintenant compatible. Pendant ce temps, Tibo, ajouté par OpenAI, est aussi venu observer et soutenir.

Vers mai, le nombre d’utilisations d’Agents.md avait déjà dépassé celui de Claude.md.

Le jour même de la mise à jour, quelqu’un a mené un sondage : 6,2 % des dépôts actifs sur GitHub contiennent AGENTS.md (les dépôts actifs sont définis comme ayant eu un push dans les 90 derniers jours, et n’étant ni des forks, ni archivé). La proportion de CLAUDE.md est de 5,4 %.

Donc, bon nombre de développeurs de projets doivent maintenir deux fichiers en parallèle.

Qu’il s’agisse du format ou du contenu, il n’y a presque aucune différence.

Il n’y a pas vraiment de différence, mais ça torture les développeurs pendant un an.

OpenAI a conçu AGENTS.md pour son Codex afin d’offrir à l’assistant de programmation IA une manière standardisée de lire les conventions de codage du projet, les étapes de construction et les exigences de test. Fondamentalement, c’est un fichier Markdown placé à la racine du dépôt de code : l’équivalent d’un README écrit pour l’IA.

Dès le départ, OpenAI ne l’a jamais appelé OpenAI.md ou Codex.md.

Ce format ouvert a été rapidement reconnu par l’industrie. En décembre 2025, OpenAI a fait don d’AGENTS.md à la nouvelle Agentic AI Foundation (AAIF), créée au sein de la Linux Foundation.

Étrangement, Anthropic fait aussi partie des cofondateurs de ce fonds : ils ont fait don de leur protocole MCP, et Block a contribué le framework goose. AWS, Google, Microsoft, Bloomberg et Cloudflare ont tous rejoint comme membres Platinum.

Codex, GitHub Copilot, Cursor, Windsurf, Gemini CLI, Aider, Zed, Jules et JetBrains Junie ont tour à tour annoncé la prise en charge native de Agents.md.

Parmi tous les outils de programmation IA grand public, Claude Code est le dernier.

Le fait que Claude Code ne reconnaisse que CLAUDE.md a déjà longtemps posé problème aux développeurs.

Dans un même projet, Codex lit AGENTS.md, Cursor lit AGENTS.md, et seul Claude Code exige un fichier CLAUDE.md distinct. Les deux fichiers se recouvrent à 90 %, mais ils doivent pourtant être maintenus séparément.

Dès qu’un côté est mis à jour et que l’autre oublie de s’ajuster, différents agents IA donnent des conseils contradictoires.

La communauté a été forcée d’inventer toutes sortes de solutions de contournement. Elles fonctionnent, mais chacune a ses propres problèmes.

Le cas le plus courant est d’exécuter ln -s AGENTS.md CLAUDE.md dans le répertoire racine du projet : on utilise un lien symbolique au niveau du système de fichiers pour faire pointer deux noms de fichiers vers le même contenu.

Mais sur Windows, cela nécessite des droits administrateur ou le mode développeur. De plus, Git sur Windows ne conserve pas non plus les liens symboliques par défaut. Si le dépôt est cloné sans configuration correcte, CLAUDE.md se transformera en un fichier squelette vide ne contenant que les lettres « AGENTS.md » ; l’agent n’y lira rien du tout, sans que cela ne génère d’erreur. Il est donc facile de ne pas s’en rendre compte.

D’autres ont aussi écrit @AGENTS.md sur la première ligne de CLAUDE.md afin de lire indirectement via une syntaxe d’import.

Pour les nouveaux membres d’une équipe, voir un fichier d’instructions ne contenant qu’une ligne et pointant vers un autre fichier Markdown à un nom différent, c’est difficile à comprendre ce qui se passe.

Les équipes qui collaborent avec plusieurs outils de programmation IA sont les plus touchées.

Dans le même dépôt de code, il faut maintenir à la fois CLAUDE.md et AGENTS.md : le contenu se ressemble beaucoup, mais n’est pas exactement identique. CLAUDE.md peut contenir des instructions propres à Claude ; AGENTS.md, lui, est indépendant des outils.

Dès que les deux fichiers dérivent et ne sont plus synchronisés, investiguer les problèmes devient extrêmement pénible.

La prochaine étape de Claude Code : Mod

La mise en œuvre de Claude Code 2.1.277 repose sur un mécanisme de repli, et non sur un remplacement intégral.

Le mode par défaut s’appelle « claude-md-or-agents-md » : AGENTS.md n’est recherché et chargé que lorsqu’il n’y a aucun CLAUDE.md dans le projet. Si le projet contient déjà un CLAUDE.md, même vide, AGENTS.md ne sera pas lu.

En plus du mode par défaut, les développeurs peuvent aussi choisir trois autres modes dans /config : n’en lire qu’un CLAUDE.md en lecture seule, lire les deux fichiers, ou ne charger que des fichiers d’instructions hébergées au niveau de l’organisation. L’ensemble de cette fonctionnalité est implémenté sous forme de plugin intégré (Mod).

Le système de mods de Claude Code vient juste d’être publié en septembre. En essence, c’est un système de plugins qui permet aux développeurs d’insérer une logique personnalisée dans le processus d’exécution de Claude Code.

Chaque mod peut écouter des événements de cycle de vie spécifiques, par exemple le démarrage de la session, la construction du contexte, l’appel à des outils, la dérivation d’agents enfants, etc. Sur ces nœuds clés, il intercepte, modifie ou complète le comportement par défaut de Claude Code.

Avec Mod, vous pouvez même jouer à Tetris dans Claude Code.

Mais on peut aussi voir, à travers la prise en charge d’Agents.md, que l’écosystème de plugins de Claude Code n’est pas encore tout à fait parfait.

Dans la documentation, une série d’entrées indiquent « des différences subsistent encore par rapport à CLAUDE.md » :

Les fichiers imbriqués dans AGENTS.md ne se déclenchent que lors d’opérations de lecture de type texte ; ils ne remplacent pas les cas comme les fichiers ouverts dans l’IDE, les notebooks et les images.

/memory et les #raccourcis clavier ne reconnaissent pas le fichier AGENTS.md ;

Autrement dit, les AGENTS.md ajoutés via --add-dir ne sont pas chargés ;

Les imports @ pointant vers des chemins externes dans AGENTS.md nécessitent d’obtenir l’autorisation via la boîte de dialogue de CLAUDE.md pour que cela prenne effet ; en soi, cela ne déclenche pas la demande d’autorisation.

Ces limitations viennent du fait que le système actuel d’événements de plugins ne couvre pas encore ces scénarios.

Donc, pour résumer : sur le plan du format, Claude Code ressemble davantage à OpenAI ; sur le plan des fonctionnalités, il ressemble davantage à DeepSeek.