Shopify pourrait bannir Claude Code : une querelle de fichier qui révèle le vrai coût du verrouillage

La menace de Shopify ne porte pas vraiment sur l’extension d’un fichier. Elle concerne la manière dont une grande entreprise fait travailler plusieurs agents d’intelligence artificielle sur la même base de code.

Le 25 août 2026, Tobi Lütke a déclaré sur X qu’il envisageait d’interdire Claude Code chez Shopify tant qu’Anthropic ne changerait pas de position et ne prendrait pas en charge AGENTS.md, .agents/skills et d’autres fichiers similaires. Selon lui, le fait que Claude Code privilégie son propre format CLAUDE.md peut provoquer un effet de « cerveau divisé » lorsque les développeurs utilisent des outils différents. 415

Le reproche de Shopify, en termes simples

AGENTS.md est un fichier Markdown placé dans un dépôt de code. Il fournit aux agents des informations propres au projet :

• les commandes pour compiler et tester le code ;
• les conventions de programmation à respecter ;
• les répertoires à ne pas modifier ;
• les règles de contribution et les limites de sécurité.

L’intérêt est que ces consignes restent dans le dépôt, sous contrôle de version, plutôt que d’être liées à l’outil utilisé par chaque développeur. 2931

Claude Code s’appuie pour sa part sur l’écosystème CLAUDE.md, .claude/rules, les skills du projet, les hooks et certains paramètres. Sa documentation décrit un système récursif : Claude Code peut rechercher ces éléments dans le répertoire courant et dans ses répertoires parents. 2

Pour un développeur indépendant, cette différence peut se gérer sans trop de difficulté. Dans une grande entreprise, où Codex, Cursor, Claude Code, Gemini CLI, GitHub Copilot ou VS Code peuvent être utilisés en parallèle, elle devient un problème d’exploitation.

Dans un monorepo, deux fichiers signifient deux sources de vérité

Imaginons un monorepo utilisé par des milliers de développeurs. Les équipes y placent AGENTS.md, parce que plusieurs outils savent le lire. Claude Code, lui, attend surtout CLAUDE.md.

L’entreprise doit alors choisir entre plusieurs solutions peu séduisantes :

• conserver à la fois AGENTS.md et CLAUDE.md à la racine du dépôt ;
• reproduire ces fichiers dans les sous-répertoires concernés ;
• synchroniser les deux arborescences à chaque changement ;
• ajouter des contrôles automatisés pour repérer les divergences.

Une simple mise à jour oubliée peut avoir des conséquences concrètes. Codex ou Cursor peut appliquer une nouvelle commande de test tandis que Claude Code utilise l’ancienne. Un agent peut voir l’interdiction de modifier un dossier alors qu’un autre ne la reçoit jamais.

Le problème ne relève donc pas seulement de la documentation en double. Les agents peuvent produire des modifications différentes, suivre des règles incompatibles ou donner aux équipes une vision contradictoire du fonctionnement du projet : c’est le « split brain » dénoncé par Lütke. 47

Une demande publique déposée dans le dépôt de Claude Code décrit précisément cette friction : lorsqu’un projet contient déjà AGENTS.md, Claude Code peut ignorer ces instructions et contraindre le développeur à créer manuellement un CLAUDE.md avec le même contenu. 12

AGENTS.md est-il vraiment un standard universel ?

Pas au sens d’une norme technique obligatoire. Mais son adoption lui donne un poids pratique important.

Le format est né dans l’écosystème de Codex, dans le cadre d’un travail plus large associant notamment Google, OpenAI, Sourcegraph, Factory et Cursor. 1931 Le 9 décembre 2025, OpenAI et Anthropic ont contribué AGENTS.md, ainsi que d’autres briques destinées aux agents, à l’Agentic AI Foundation, une fondation soutenue par la Linux Foundation. 2829

Cette gouvernance vise à placer ces projets sous une gestion plus neutre et ouverte, plutôt que sous le contrôle exclusif d’un éditeur commercial.

La Linux Foundation indique qu’AGENTS.md avait déjà été adopté par plus de 60 000 projets open source et frameworks d’agents, notamment Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules et VS Code. 31

Cela en fait une couche de portabilité de fait : une équipe peut stocker ses règles de projet dans un emplacement commun et espérer qu’une large gamme d’outils les reconnaisse.

Les solutions de contournement proposées pour Claude Code

Claude Code peut néanmoins utiliser le contenu d’AGENTS.md grâce à sa configuration native. Une méthode consiste à importer le fichier depuis CLAUDE.md, par exemple en y ajoutant une référence au document partagé. D’autres équipes utilisent un lien symbolique ou un autre pont de configuration. 69

Ces solutions réduisent l’incompatibilité immédiate, mais elles ne valent pas une prise en charge native pour une entreprise. Elles :

• ajoutent une couche de configuration propre à chaque dépôt ;
• soulèvent des questions d’ordre de priorité et de portée des règles ;
• demandent aux équipes de gérer elles-mêmes les mises à jour ;
• peuvent se comporter différemment selon Windows, Git, les IDE, les conteneurs ou les politiques de sécurité internes.

En réponse à Tobi Lütke, Thariq, d’Anthropic, a indiqué que l’entreprise travaillait à rendre Claude Code plus configurable, notamment pour faciliter l’utilisation d’AGENTS.md ou la modification d’autres paramètres liés au prompt système. 15

Les éléments disponibles ne permettent toutefois pas d’établir avec certitude la raison technique ou commerciale pour laquelle Claude Code ne reconnaît pas directement le format. Toute explication plus catégorique sur les motivations d’Anthropic relève donc de la spéculation.

Une contradiction pour Anthropic ?

La situation est d’autant plus remarquée qu’Anthropic participe à l’écosystème de l’Agentic AI Foundation, qui comprend AGENTS.md sous la gouvernance de la Linux Foundation, alors que Claude Code conserve des conventions de projet principalement propres à Anthropic. 22829

Cela ne signifie pas nécessairement qu’Anthropic s’oppose aux standards ouverts. Un éditeur peut soutenir une base commune tout en conservant des extensions propriétaires pour les fonctions spécifiques de son produit ou de ses modèles.

Pour un acheteur informatique, la distinction est toutefois moins importante si les instructions essentielles doivent être réécrites ou reliées manuellement avant de pouvoir être utilisées par un autre outil.

Ce que cette querelle peut changer pour les outils de programmation IA

Une « taxe de configuration » récurrente

Chaque format propre à un fournisseur peut entraîner des fichiers en double, des scripts de migration, des tests de cohérence et des incidents liés à des règles obsolètes. Plus une entreprise ajoute d’agents, plus cette charge augmente avec le nombre d’outils et de périmètres de dépôt à maintenir.

Une pression accrue contre le verrouillage propriétaire

Les fichiers d’instructions ne contiennent pas seulement des préférences de style. Ils peuvent intégrer les méthodes de travail d’une équipe, ses règles de sécurité, ses processus de validation et une partie de son savoir opérationnel.

Si ces informations fonctionnent mieux dans le format d’un seul fournisseur, changer d’outil ou en utiliser plusieurs simultanément devient plus coûteux. Un format commun réduit ce coût de changement et donne davantage de marge de négociation aux directions techniques.

Vers un modèle à deux niveaux

Le scénario le plus réaliste n’est peut-être pas la disparition de tous les formats propriétaires. Un fichier commun comme AGENTS.md pourrait contenir les instructions portables du projet, tandis que CLAUDE.md et les fichiers propres à d’autres outils serviraient d’extensions facultatives.

Les éditeurs conserveraient ainsi des fonctions différenciantes sans rendre le contexte fondamental du dépôt dépendant d’un seul produit.

Les grands clients deviennent des arbitres de standard

La réaction de Shopify montre comment un grand client peut transformer une demande de compatibilité en critère de déploiement. Si des entreprises de cette taille exigent la prise en charge de formats interopérables, les éditeurs devront peut-être considérer cette compatibilité comme une composante de leur offre destinée aux entreprises, et non comme une simple demande de la communauté.

En résumé

Shopify ne menace pas Claude Code parce que CLAUDE.md serait intrinsèquement inférieur à AGENTS.md. Le problème est qu’un format propre à un fournisseur devient une charge lorsque des centaines ou des milliers d’ingénieurs utilisent plusieurs agents sur le même code.

L’adoption d’AGENTS.md par plus de 60 000 projets, sa gouvernance au sein de la Linux Foundation et sa compatibilité avec de nombreux outils en font une couche partagée crédible. 2931 Les imports et les liens symboliques constituent des palliatifs, mais ils reportent le travail d’intégration sur chaque organisation.

Derrière cette bataille de fichiers se trouve une question plus large : les agents de programmation IA vont-ils devenir une infrastructure interopérable, ou rester des plateformes fermées dont les connaissances de projet doivent être adaptées à chaque outil ?