Cursor Rules vs CLAUDE.md vs AGENTS.md : on a fait tourner une seule config sur les trois (2026)

Cursor Rules vs CLAUDE.md vs AGENTS.md : on a fait tourner une seule config sur les trois (2026)

La question cursor rules vs claude md cache un piège : ce ne sont pas deux options entre lesquelles choisir. Ce sont deux fichiers, lus par deux outils différents, qui font par hasard le même travail. Déposez un CLAUDE.md dans un projet Cursor, et Cursor l'ignore. Déposez un AGENTS.md dans Claude Code, et il ne se passe rien non plus. Ça nous a surpris aussi. AGENTS.md est déjà présent dans plus de 60 000 dépôts en tant que standard ouvert, piloté par l'Agentic AI Foundation sous l'égide de la Linux Foundation, et pourtant Claude Code refuse toujours de le lire tout seul. Voici la carte de compatibilité, testée sur notre propre dépôt.

Points clés à retenir

• Cursor lit .cursor/rules/*.mdc et AGENTS.md, pas CLAUDE.md.
• Claude Code lit uniquement CLAUDE.md, pas AGENTS.md de façon native.
• Pour partager un seul fichier : créez un lien symbolique entre AGENTS.md et CLAUDE.md, ou importez-le avec @AGENTS.md.
• Standardisez sur AGENTS.md (standard ouvert, 60 000+ dépôts), puis ajoutez des surcharges spécifiques à chaque outil.

Quel format de config choisir ? La décision en 30 secondes

Choisissez votre format en fonction de la composition de votre équipe, pas d'un effet de mode. Si vous utilisez un seul outil, utilisez son fichier natif. Si vous en utilisez deux ou plus, adoptez AGENTS.md comme source de vérité et ajoutez des surcharges par outil uniquement là où un outil a besoin de quelque chose que les autres n'ont pas. Cette seule règle règle la plupart des confusions.

Vous hésitez encore sur l'assistant à adopter avant même de vous soucier de sa config ? Commencez par notre guide sur le choix d'un agent de codage IA, puis revenez pour la configuration du fichier.

L'axe de décision qui compte vraiment, c'est la portabilité. Un fichier .cursor/rules est puissant dans Cursor et inutile partout ailleurs. Un AGENTS.md voyage. Donc à moins d'être verrouillé sur un seul outil pour toujours, le fichier agnostique est le pari le plus sûr.

Ce qu'est réellement chaque format (en 30 secondes chacun)

Ces trois fichiers font tous une seule chose : donner à un outil de codage IA les règles, conventions et pièges de votre projet avant qu'il n'écrive une ligne. La différence, c'est qui les lit et comment ils ciblent le contexte. Voici la version courte. Le mode d'emploi détaillé de chacun vit dans son propre guide.

Cursor Rules sont des fichiers .mdc situés dans .cursor/rules/. Cursor prend en charge quatre types de règles (toujours actives, demandées par l'agent, ciblées par glob, et manuelles via mention @), donc vous pouvez rattacher une règle à vos seuls fichiers *.tsx ou à vos migrations. Pour le frontmatter, les globs et le budget de tokens, lisez notre guide sur comment écrire concrètement des fichiers .cursor/rules.

CLAUDE.md est le fichier mémoire de Claude Code. Claude remonte l'arborescence des dossiers depuis votre répertoire de travail et concatène chaque CLAUDE.md qu'il trouve. C'est du Markdown pur, aucun frontmatter requis. Pour la structure et les règles qui évitent que Claude ne l'ignore, voir ce qui rend un CLAUDE.md que Claude ne peut pas ignorer.

AGENTS.md est le standard ouvert. Un seul fichier Markdown à la racine de votre dépôt, lu nativement par Cursor, Codex, Copilot, Windsurf, Zed, Aider et des dizaines d'autres. Il est piloté par l'Agentic AI Foundation et vit déjà dans plus de 60 000 projets.

Voici le recadrage à retenir : AGENTS.md, CLAUDE.md et .cursor/rules ne sont pas des concurrents, ce sont la même instruction, adressée à des lecteurs différents.

Cursor Rules vs CLAUDE.md vs AGENTS.md : le comparatif complet

Le plus rapide pour voir la différence, c'est de mettre tout côte à côte. La colonne décisive, c'est la portabilité : quels outils lisent le fichier sans configuration supplémentaire. AGENTS.md gagne en portée, Cursor Rules gagne en précision de ciblage, et CLAUDE.md gagne pour quiconque est full Claude Code.

Remarquez la ligne .cursorrules. Ce fichier racine unique fonctionne encore dans Cursor, mais il a disparu de la documentation officielle, traitez-le donc comme legacy. Les nouveaux projets devraient utiliser .cursor/rules/*.mdc ou AGENTS.md à la place.

Quel outil lit quel fichier ? (En finir avec le mythe AGENTS.md)

Voici le fait que la moitié d'internet se trompe : Claude Code ne lit pas AGENTS.md nativement, et Cursor ne lit pas CLAUDE.md. Cursor lit .cursor/rules/*.mdc plus AGENTS.md. Claude Code lit CLAUDE.md et rien d'autre. Il n'y a aucun repli automatique dans un sens ou dans l'autre, ce qui piège les équipes qui pensent qu'un seul fichier standard couvre tout.

On nous pose cette question sans arrêt, donc soyons directs. Déposer un AGENTS.md dans un projet Claude Code ne fait strictement rien à lui seul. Claude Code lit CLAUDE.md et uniquement CLAUDE.md. La documentation mémoire de Claude Code chez Anthropic décrit le comportement de chargement sans jamais mentionner AGENTS.md, la spécification AGENTS.md cite Cursor et Codex parmi les lecteurs natifs mais pas Claude Code, la documentation officielle des rules Cursor confirme la scission, et les issues GitHub de Claude Code regorgent de développeurs qui se heurtent exactement à ce mur.

Alors, Cursor lit-il claude.md ? Non. Claude Code lit-il agents.md ? Pas sans aide. Cette aide, c'est toute la raison d'être de cet article, et ce sont deux commandes courtes que vous verrez juste après.

Comment fonctionnent la priorité et l'imbrication, côte à côte

Chaque outil résout les conflits différemment, et se tromper là-dessus est la première cause du fameux « pourquoi ma règle est-elle ignorée ? ». Cursor fusionne les règles par priorité de source. Claude Code concatène par profondeur de répertoire. AGENTS.md choisit le fichier le plus proche dans l'arborescence. Une bonne claude md management commence par savoir dans quel modèle mental vous vous trouvez.

Dans notre configuration, la conséquence pratique est simple : placez les règles générales en haut (racine du dépôt) et les règles spécifiques en bas (dans un dossier de package). Pour Claude Code comme pour AGENTS.md, le fichier le plus proche de l'endroit où vous travaillez a priorité, donc un packages/api/AGENTS.md prime sur celui de la racine pour tout ce qui se trouve dans ce dossier. Cursor est l'exception, il résout par niveau de source plutôt que par profondeur de dossier.

On a fait tourner une seule config sur Cursor et Claude Code, voici ce que chaque outil a réellement chargé

Nous avons testé cela sur un dépôt client Techsy en production (un backend Next.js 15) avec Cursor 3.7 (build du 17 juin 2026) et Claude Code v2.1.x (début juillet 2026). Un seul AGENTS.md, trois configurations de partage, le même prompt ouvert dans les deux outils. Voici exactement ce que chacun a chargé.

Nous avons commencé avec un fichier minimal :

# AGENTS.md
- Package manager: pnpm, never npm.
- Tests: Vitest. Run `pnpm test` before any commit.
- DB access goes through `lib/db.ts` only, no inline SQL.

Configuration 1 : AGENTS.md seul. Cursor l'a récupéré immédiatement. Le fichier apparaissait dans son contexte, et il a correctement refusé de suggérer npm install. Claude Code n'en a rien fait. Lancer /memory dans Claude Code a listé zéro fichier de mémoire projet : aucun CLAUDE.md trouvé, et AGENTS.md n'était même pas mentionné. Confirmé : aucun repli natif.

Configuration 2 : lien symbolique. Nous avons pointé CLAUDE.md vers le même fichier :

ln -s AGENTS.md CLAUDE.md

/memory dans Claude Code a alors listé ./CLAUDE.md comme mémoire de Projet, et le contenu chargé était notre AGENTS.md à l'octet près. Cursor continuait de lire AGENTS.md directement. Un seul fichier physique, les deux outils satisfaits. Sous Windows, cela nécessite le mode Admin ou le mode Développeur activé, sinon ln/mklink échoue silencieusement.

Configuration 3 : @import. Nous avons supprimé le lien symbolique et mis à la place une seule ligne tout en haut d'un vrai CLAUDE.md :

@AGENTS.md

/memory a ensuite affiché CLAUDE.md comme fichier chargé, avec AGENTS.md importé en tant que référence en dessous. C'est la voie qu'Anthropic documente réellement, et elle ne nécessite aucune permission système particulière.

Le verdict de notre test : le lien symbolique fait lire Claude Code AGENTS.md à l'octet près ; l'import @AGENTS.md est la version compatible Windows qu'Anthropic recommande vraiment. Les deux vous donnent une source de vérité unique. Choisissez le lien symbolique sur macOS/Linux pour zéro indirection, ou la ligne d'import si quelqu'un dans l'équipe est sous Windows.

Migrer entre formats : .cursorrules → .cursor/rules → AGENTS.md

La plupart des équipes arrivent ici avec un vieux fichier .cursorrules et veulent sortir du piège du fichier unique. La migration est courte dans les deux sens, et les manipulations sont du copier-coller. Le piège qui mord tout le monde : un fichier .md dans .cursor/rules sans frontmatter est silencieusement ignoré, il doit donc obligatoirement être en .mdc.

Pour moderniser un vieux .cursorrules, vous avez deux voies propres :

• Vers .cursor/rules/*.mdc : créez .cursor/rules/general.mdc, ajoutez un frontmatter (alwaysApply: true pour une règle globale), et collez votre ancien contenu en dessous. Supprimez .cursorrules une fois la vérification faite.
• Vers AGENTS.md (recommandé pour les équipes multi-outils) : pour convertir cursorrules en agents.md, copiez le corps de .cursorrules dans un nouveau AGENTS.md à la racine de votre dépôt. Pas besoin de frontmatter, c'est du Markdown pur. Ajoutez ensuite le lien symbolique ou l'import @AGENTS.md pour que Claude Code le lise aussi.

Si vous restez sur Cursor et voulez en tirer davantage, notre guide sur tirer plus parti de Cursor au quotidien couvre le ciblage des règles en pratique.

Faire l'inverse (AGENTS.md → CLAUDE.md) revient simplement au lien symbolique ou à l'import de la section précédente. Il n'y a aucune conversion avec perte, puisque les trois formats sont du Markdown sous le capot.

Où se situent SKILL.md et les instructions Copilot ?

Deux formats supplémentaires apparaissent dans cette conversation, et skills md est une recherche en forte croissance en ce moment, donc ça mérite un placement rapide. Aucun des deux ne remplace les trois fichiers principaux, ils s'ajoutent à côté.

SKILL.md est le format Skills d'Anthropic : des instructions spécifiques à une tâche, regroupées dans .claude/skills/*/SKILL.md, que Claude charge à la demande quand une tâche correspond, plutôt que toujours actif comme CLAUDE.md. Pensez-y comme un manuel spécialisé que Claude va chercher, pas un fichier mémoire à l'échelle du projet. La portée est encore en évolution, donc n'y investissez pas trop pour l'instant. Pour voir comment il s'intègre dans un vrai flux de travail, voir où CLAUDE.md s'intègre dans un vrai flux de travail Claude Code.

Les instructions Copilot vivent dans .github/copilot-instructions.md pour GitHub Copilot. Bonne nouvelle : Copilot lit aussi AGENTS.md, donc si vous avez standardisé sur le standard ouvert, Copilot est déjà couvert sans fichier séparé.

Que devriez-vous utiliser ? (Selon la forme de votre équipe)

Adaptez le format à la façon dont votre équipe travaille réellement :

• Utilisateur solo de Claude Code : utilisez simplement CLAUDE.md. Aucune raison d'ajouter AGENTS.md, à moins de prévoir d'intégrer Cursor ou Codex plus tard.
• Utilisateur solo de Cursor : .cursor/rules/*.mdc pour le ciblage par glob, ou un simple AGENTS.md si vous voulez la portabilité dès le premier jour.
• Équipe multi-outils : un seul AGENTS.md comme source de vérité, lié symboliquement ou importé dans CLAUDE.md. Ajoutez un petit fichier .cursor/rules uniquement pour un comportement spécifique à Cursor.
• Monorepo : AGENTS.md à la racine plus des fichiers imbriqués par package, pour que chaque sous-projet se décrive lui-même et que le fichier le plus proche l'emporte.

Chez Techsy, nous standardisons la config du codage IA sur des équipes multi-outils, généralement avec un seul AGENTS.md comme source de vérité et des surcharges par outil là où c'est nécessaire. Si votre équipe jongle avec trois fichiers de config à la main, demandez une consultation gratuite et nous vous aiderons à y voir clair.

Un dernier point : cet article compare les fichiers de config. Si vous essayez plutôt de choisir entre les outils eux-mêmes, lisez comparer les assistants eux-mêmes, pas leur config.

Questions fréquentes

Cursor lit-il CLAUDE.md ?

Non. Cursor lit nativement .cursor/rules/*.mdc et AGENTS.md, mais CLAUDE.md n'est jamais mentionné dans la documentation de Cursor et n'est pas chargé. Si vous êtes sur Cursor et voulez partager votre config avec des utilisateurs de Claude Code, mettez vos règles dans AGENTS.md (que Cursor lit bien) plutôt que dans CLAUDE.md.

Claude Code lit-il AGENTS.md ?

Pas nativement. Claude Code lit uniquement CLAUDE.md, sans repli automatique vers AGENTS.md. Pour que ça fonctionne, créez un lien symbolique entre les deux fichiers (ln -s AGENTS.md CLAUDE.md) pour que Claude lise AGENTS.md à l'octet près, ou ajoutez @AGENTS.md en ligne 1 d'un CLAUDE.md pour l'importer. L'import est l'option recommandée par Anthropic, compatible Windows.

Puis-je utiliser un seul fichier pour les trois outils ?

Oui. Adoptez AGENTS.md comme source de vérité unique, et Cursor et Codex le liront directement. Pour Claude Code, ajoutez un seul pont : soit un lien symbolique entre AGENTS.md et CLAUDE.md, soit @AGENTS.md en haut d'un CLAUDE.md. Vous maintenez un seul fichier, et chaque outil charge les mêmes règles. C'est toute la recette pour partager une config unique.

.cursorrules est-il déprécié ?

En déclin. Le fichier unique .cursorrules à la racine de votre dépôt fonctionne encore dans Cursor, mais il n'apparaît plus dans la documentation officielle, ce qui est généralement le signe qu'un format est en train de disparaître. Les nouveaux projets devraient utiliser .cursor/rules/*.mdc pour des règles ciblées ou AGENTS.md pour la portabilité.

Comment convertir .cursorrules en AGENTS.md ?

Copiez le corps de votre fichier .cursorrules dans un nouveau AGENTS.md à la racine de votre dépôt. C'est du Markdown pur, aucun frontmatter ni reformatage n'est nécessaire. Ajoutez ensuite un lien symbolique ou un import @AGENTS.md pour que Claude Code le lise aussi, et supprimez l'ancien .cursorrules une fois que vous avez confirmé que Cursor charge bien le nouveau fichier.

Quelle est la différence entre CLAUDE.md et AGENTS.md ?

CLAUDE.md est le fichier mémoire propriétaire de Claude Code, lu uniquement par Claude Code. AGENTS.md est un standard ouvert lu par Cursor, Codex, Copilot et 20+ autres outils, mais pas nativement par Claude Code. Même format Markdown, même rôle. La différence, c'est la portée. AGENTS.md voyage entre les outils ; CLAUDE.md reste confiné à Claude Code.

Sur quel format une équipe utilisant plusieurs outils IA devrait-elle standardiser ?

AGENTS.md. C'est le standard ouvert, lu nativement par la plupart des outils et déjà présent dans plus de 60 000 dépôts. Standardisez vos règles partagées là-dessus, faites le pont vers Claude Code avec un lien symbolique ou un import, et ajoutez de petits fichiers spécifiques à un outil (comme .cursor/rules) uniquement là où un outil a besoin d'un comportement que les autres n'ont pas.

Comment fonctionne la priorité avec des fichiers de config imbriqués ?

Pour Claude Code comme pour AGENTS.md, le fichier le plus proche de votre répertoire de travail l'emporte, donc une règle dans packages/api/AGENTS.md prime sur le fichier racine du dépôt pour tout ce qui se trouve dans ce dossier. Cursor fonctionne différemment : il fusionne les règles Équipe, Projet et Utilisateur par niveau de source plutôt que par profondeur de dossier, les sources les plus anciennes gagnant les conflits.

Où se situe SKILL.md dans tout ça ?

SKILL.md est le format Skills émergent d'Anthropic : des instructions spécifiques à une tâche dans .claude/skills/*/SKILL.md, que Claude charge à la demande quand une tâche correspond, plutôt que toujours actif comme CLAUDE.md. Il complète CLAUDE.md plutôt que de le remplacer. La portée est encore en évolution en 2026, donc traitez-le comme un complément spécialisé, pas comme un quatrième fichier obligatoire pour chaque projet.