Cursor Rules vs CLAUDE.md vs AGENTS.md: Wij Testten Eén Config in Alle Drie (2026)

Cursor Rules vs CLAUDE.md vs AGENTS.md: Wij Testten Eén Config in Alle Drie (2026)

De vraag cursor rules vs claude md zit met een addertje onder het gras: het zijn geen twee opties waaruit je kiest. Het zijn twee bestanden, gelezen door twee verschillende tools, die toevallig dezelfde taak doen. Zet een CLAUDE.md in een Cursor-project en Cursor negeert het gewoon. Zet een AGENTS.md in Claude Code en er gebeurt ook niets. Dat verraste ons ook. AGENTS.md staat inmiddels in 60.000+ repo's als de open standaard, beheerd door de Agentic AI Foundation onder de Linux Foundation, en toch leest Claude Code het niet vanzelf. Hier is de compatibiliteitskaart, getest op ons eigen repo.

Belangrijkste Punten

• Cursor leest .cursor/rules/*.mdc en AGENTS.md, geen CLAUDE.md.
• Claude Code leest alleen CLAUDE.md, niet native AGENTS.md.
• Om één bestand te delen: symlink AGENTS.md naar CLAUDE.md, of importeer het met @AGENTS.md.
• Standaardiseer op AGENTS.md (open standaard, 60k+ repo's), voeg daarna tool-specifieke overrides toe.

Welk Configformaat Moet Je Gebruiken? De 30-Secondenbeslissing

Kies je formaat op basis van je teamopstelling, niet op hype. Werk je met één tool, gebruik dan het native bestand daarvan. Werk je met twee of meer, adopteer dan AGENTS.md als bron van waarheid en voeg alleen per-tool overrides toe waar een tool iets nodig heeft dat de anderen niet hebben. Die ene regel lost het meeste verwarring op.

Weet je nog niet welke assistent je gaat draaien voordat je je druk maakt over de config? Begin met onze gids over het kiezen van een AI coding agent en kom daarna terug voor de bestandsopzet.

De doorslaggevende as is overdraagbaarheid. Een .cursor/rules-bestand is krachtig binnen Cursor en nutteloos daarbuiten. Een AGENTS.md reist mee. Tenzij je voor altijd aan één tool vastzit, is het tool-onafhankelijke bestand de veiligere keuze.

Wat Elk Formaat Eigenlijk Is (in 30 Seconden per Stuk)

Deze drie bestanden doen allemaal hetzelfde: een AI coding tool de regels, conventies en valkuilen van je project meegeven voordat hij een regel code schrijft. Het verschil zit in wie ze leest en hoe de scope werkt. Hier de korte versie. De diepgaande how-to per formaat staat in een eigen gids.

Cursor Rules zijn .mdc-bestanden binnen .cursor/rules/. Cursor ondersteunt vier regeltypes (altijd actief, agent-requested, glob-scoped en handmatig via @-mention), waardoor je een regel kunt koppelen aan alleen je *.tsx-bestanden of alleen je migraties. Voor de frontmatter, globs en tokenbudget, lees onze gids over hoe je .cursor/rules-bestanden schrijft.

CLAUDE.md is het geheugenbestand van Claude Code. Claude loopt de mappenstructuur op vanaf je werkmap en voegt elke CLAUDE.md die het tegenkomt samen. Het is gewone Markdown, geen frontmatter nodig. Voor structuur en de regels die voorkomen dat Claude het negeert, zie wat een CLAUDE.md maakt die Claude niet negeert.

AGENTS.md is de open standaard. Eén platte Markdown-bestand in de root van je repo, native gelezen door Cursor, Codex, Copilot, Windsurf, Zed, Aider en tientallen andere tools. Het wordt beheerd door de Agentic AI Foundation en staat al in 60.000+ projecten.

Hier is de herkadering die het onthouden waard is: AGENTS.md, CLAUDE.md en .cursor/rules zijn geen concurrenten, het is dezelfde instructie, gericht aan verschillende lezers.

Cursor Rules vs CLAUDE.md vs AGENTS.md: De Complete Vergelijking

De snelste manier om het verschil te zien is naast elkaar. De doorslaggevende kolom is overdraagbaarheid: welke tools het bestand lezen zonder extra werk. AGENTS.md wint op bereik, Cursor Rules winnen op precisie in scoping, en CLAUDE.md wint voor iedereen die volledig op Claude Code zit.

Let op de rij .cursorrules. Dat ene root-bestand werkt nog steeds in Cursor, maar het viel uit de documentatie, dus behandel het als legacy. Nieuwe projecten gebruiken beter .cursor/rules/*.mdc of AGENTS.md.

Welke Tool Leest Welk Bestand? (De AGENTS.md-Mythe Ontkracht)

Hier is het feit dat het halve internet fout heeft: Claude Code leest AGENTS.md niet native, en Cursor leest geen CLAUDE.md. Cursor leest .cursor/rules/*.mdc plus AGENTS.md. Claude Code leest CLAUDE.md en verder niets. Er is geen automatische fallback in beide richtingen, wat teams verrast die aannemen dat één standaardbestand alles dekt.

Deze vraag komt continu terug, dus laten we het rechtstreeks zeggen. Een AGENTS.md in een Claude Code-project zetten doet op zichzelf niets. Claude Code leest CLAUDE.md en alleen CLAUDE.md. De memory-documentatie van Claude Code van Anthropic beschrijft het laadgedrag zonder enige verwijzing naar AGENTS.md, de AGENTS.md-specificatie noemt Cursor en Codex als native lezers maar niet Claude Code, Cursor's eigen rules-documentatie bevestigt de splitsing, en de GitHub issues van Claude Code staan vol ontwikkelaars die precies tegen deze muur aanlopen.

Leest Cursor dan claude.md? Nee. Leest Claude Code agents.md? Niet zonder hulp. Die "hulp" is de hele reden dat dit artikel bestaat, en het zijn twee korte commando's die je hierna ziet.

Hoe Precedentie & Nesting Werken, Naast Elkaar

Elke tool lost conflicten anders op, en dit verkeerd inschatten is de grootste bron van "waarom wordt mijn regel genegeerd?"-verwarring. Cursor voegt regels samen op basis van bronprioriteit. Claude Code voegt samen op mapdiepte. AGENTS.md kiest het dichtstbijzijnde bestand in de boom. Goed claude md management begint met weten in welk mentaal model je zit.

In onze opzet is de praktische conclusie simpel: zet brede regels hoog (repo-root) en specifieke regels laag (binnen een package-map). Voor zowel Claude Code als AGENTS.md geldt: het bestand dat het dichtst bij je werklocatie staat, krijgt voorrang, dus een packages/api/AGENTS.md overschrijft de root voor alles binnen die map. Cursor is de uitzondering en werkt met brontiers in plaats van mapdiepte.

We Draaiden Eén Config Door Cursor + Claude Code, Dit Laadde Elke Tool Echt

We testten dit op een live Techsy-klantrepo (een Next.js 15-backend) met Cursor 3.7 (build van 17 juni 2026) en Claude Code v2.1.x (begin juli 2026). Eén AGENTS.md, drie manieren om te delen, dezelfde prompt geopend in beide tools. Hier precies wat elke tool binnenhaalde.

We begonnen met een minimaal bestand:

# 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.

Opstelling 1: alleen AGENTS.md. Cursor pikte het direct op. Het bestand verscheen in de context en Cursor weigerde terecht om npm install voor te stellen. Claude Code deed er niets mee. Het commando /memory in Claude Code toonde nul projectgeheugenbestanden: geen CLAUDE.md gevonden, en AGENTS.md werd niet eens herkend. Bevestigd: geen native fallback.

Opstelling 2: symlink. We lieten CLAUDE.md naar hetzelfde bestand wijzen:

ln -s AGENTS.md CLAUDE.md

Nu toonde /memory in Claude Code ./CLAUDE.md als Project-geheugen, en de geladen inhoud was onze AGENTS.md byte voor byte. Cursor las nog steeds AGENTS.md rechtstreeks. Eén fysiek bestand, beide tools tevreden. Op Windows heb je hiervoor Admin- of Developer Mode nodig, anders faalt ln/mklink stilletjes.

Opstelling 3: @import. We verwijderden de symlink en zetten in plaats daarvan één regel bovenaan een echte CLAUDE.md:

@AGENTS.md

/memory liet daarna CLAUDE.md zien als geladen bestand, met AGENTS.md daaronder als geïmporteerde referentie. Dit is het pad dat Anthropic daadwerkelijk documenteert, en het vereist geen speciale OS-rechten.

De conclusie uit onze test: de symlink laat Claude Code AGENTS.md byte voor byte lezen; de @AGENTS.md-import is de Windows-veilige variant die Anthropic zelf aanraadt. Beide geven je één bron van waarheid. Kies de symlink op macOS/Linux voor nul indirectie, of de importregel als iemand in het team op Windows werkt.

Migreren Tussen Formaten: .cursorrules → .cursor/rules → AGENTS.md

De meeste teams komen hier terecht met een legacy .cursorrules-bestand en willen weg uit de single-file-val. De migratie is in elke richting kort, en de stappen zijn copy-paste. De ene valkuil waar mensen over struikelen: een .md-bestand in .cursor/rules zonder frontmatter wordt stilletjes genegeerd, het moet dus .mdc zijn.

Om een oude .cursorrules te moderniseren, heb je twee schone routes:

• Naar .cursor/rules/*.mdc: maak .cursor/rules/general.mdc aan, voeg frontmatter toe (alwaysApply: true voor een globale regel), en plak je oude inhoud eronder. Verwijder .cursorrules zodra je het hebt geverifieerd.
• Naar AGENTS.md (aanbevolen voor teams met meerdere tools): om cursorrules naar agents.md te converteren, kopieer je de body van .cursorrules naar een nieuwe AGENTS.md in de root van je repo. Geen frontmatter nodig, het is gewone Markdown. Voeg daarna de symlink of @AGENTS.md-import toe zodat Claude Code het ook leest.

Wil je binnen Cursor blijven en er meer uit halen, dan behandelt onze gids over meer uit Cursor halen in je dagelijkse workflow regelscoping in de praktijk.

Andersom (AGENTS.md → CLAUDE.md) is gewoon dezelfde symlink of import uit de vorige sectie. Er is geen verliesgevende conversie omdat alle drie onder de motorkap Markdown zijn.

Waar Passen SKILL.md en Copilot-Instructies?

Twee andere formaten duiken op in dit gesprek, en skills md is momenteel een doorbrekende zoekterm, dus verdient het een korte plaatsbepaling. Geen van beide vervangt de drie hoofdbestanden; ze staan ernaast.

SKILL.md is het Skills-formaat van Anthropic: taakspecifieke instructies gebundeld in .claude/skills/*/SKILL.md die Claude on-demand laadt wanneer een taak past, in plaats van altijd actief zoals CLAUDE.md. Zie het als een gespecialiseerd draaiboek waar Claude naar grijpt, geen projectbreed geheugenbestand. De scope is nog in ontwikkeling, dus investeer er nog niet te veel in. Voor hoe het past in een echte workflow, zie waar CLAUDE.md past in een echte Claude Code-workflow.

Copilot-instructies staan in .github/copilot-instructions.md voor GitHub Copilot. Goed nieuws: Copilot leest ook AGENTS.md, dus als je al gestandaardiseerd hebt op de open standaard, is Copilot al gedekt zonder een apart bestand.

Welke Moet Je Gebruiken? (Per Teamopstelling)

Match het formaat met hoe je team echt werkt:

• Solo Claude Code-gebruiker: gebruik gewoon CLAUDE.md. Geen reden om AGENTS.md toe te voegen tenzij je later Cursor of Codex erbij haalt.
• Solo Cursor-gebruiker: .cursor/rules/*.mdc voor de glob-scoping, of één AGENTS.md als je vanaf dag één overdraagbaarheid wilt.
• Team met meerdere tools: één AGENTS.md als bron van waarheid, gesymlinkt of geïmporteerd in CLAUDE.md. Voeg een klein .cursor/rules-bestand toe alleen voor Cursor-specifiek gedrag.
• Monorepo: AGENTS.md in de root plus nested bestanden per package, zodat elk subproject zichzelf beschrijft en het dichtstbijzijnde bestand wint.

Bij Techsy standaardiseren we AI-coding-config bij teams met meerdere tools, meestal één AGENTS.md als bron van waarheid met per-tool overrides waar een tool ze nodig heeft. Jongleert jouw team handmatig met drie configbestanden, vraag dan een gratis consult aan en wij brengen het in kaart.

Nog één ding: dit artikel vergelijkt de configbestanden. Wil je juist kiezen tussen de tools zelf, lees dan de assistenten zelf vergeleken, niet hun config.

Veelgestelde Vragen

Leest Cursor CLAUDE.md?

Nee. Cursor leest native .cursor/rules/*.mdc en AGENTS.md, maar CLAUDE.md wordt nergens in Cursor's documentatie genoemd en wordt niet geladen. Werk je in Cursor en wil je config delen met Claude Code-gebruikers, zet je regels dan in AGENTS.md (dat Cursor wel leest) in plaats van in CLAUDE.md.

Leest Claude Code AGENTS.md?

Niet native. Claude Code leest alleen CLAUDE.md, zonder automatische fallback naar AGENTS.md. Om het toch te laten werken, symlink je de bestanden (ln -s AGENTS.md CLAUDE.md) zodat Claude AGENTS.md byte voor byte leest, of voeg je @AGENTS.md toe op regel 1 van een CLAUDE.md om het te importeren. De import is de door Anthropic aanbevolen, Windows-veilige optie.

Kan ik gewoon één bestand gebruiken voor alle drie de tools?

Ja. Adopteer AGENTS.md als je enige bron van waarheid, en Cursor en Codex lezen het direct. Voor Claude Code voeg je één brug toe: symlink AGENTS.md naar CLAUDE.md, of zet @AGENTS.md bovenaan een CLAUDE.md. Je onderhoudt één bestand, en elke tool laadt dezelfde regels. Dat is het hele recept voor één gedeelde config.

Is .cursorrules verouderd?

Zacht verouderd. Het single-file .cursorrules in je repo-root werkt nog steeds in Cursor, maar staat niet meer in de officiële documentatie, wat meestal het signaal is dat een formaat op weg is naar uitfasering. Nieuwe projecten gebruiken beter .cursor/rules/*.mdc voor scoped regels of AGENTS.md voor overdraagbaarheid.

Hoe converteer ik .cursorrules naar AGENTS.md?

Kopieer de body van je .cursorrules-bestand naar een nieuwe AGENTS.md in de root van je repo. Het is gewone Markdown, dus geen frontmatter of herformattering nodig. Voeg daarna een symlink of @AGENTS.md-import toe zodat Claude Code het ook leest, en verwijder de oude .cursorrules zodra je hebt bevestigd dat Cursor het nieuwe bestand oppikt.

Wat is het verschil tussen CLAUDE.md en AGENTS.md?

CLAUDE.md is het eigen geheugenbestand van Claude Code, alleen gelezen door Claude Code. AGENTS.md is een open standaard, gelezen door Cursor, Codex, Copilot en 20+ andere tools, maar niet native door Claude Code. Zelfde Markdown-formaat, zelfde taak. Het verschil zit in bereik. AGENTS.md reist tussen tools; CLAUDE.md blijft binnen Claude Code.

Op welk formaat moet een team met meerdere AI-tools standaardiseren?

AGENTS.md. Het is de open standaard, native gelezen door de meeste tools en staat al in 60.000+ repo's. Standaardiseer je gedeelde regels daar, brug het naar Claude Code met een symlink of import, en voeg kleine tool-specifieke bestanden toe (zoals .cursor/rules) alleen waar één tool gedrag nodig heeft dat de anderen niet hebben.

Hoe werkt precedentie bij geneste configbestanden?

Voor zowel Claude Code als AGENTS.md geldt: het bestand dat het dichtst bij je werkmap staat, wint, dus een regel in packages/api/AGENTS.md overschrijft het root-bestand voor alles binnen die map. Cursor werkt anders: het voegt Team-, Project- en Gebruikersregels samen op brontier in plaats van mapdiepte, waarbij eerdere bronnen conflicten winnen.

Waar past SKILL.md in?

SKILL.md is het opkomende Skills-formaat van Anthropic: taakspecifieke instructies in .claude/skills/*/SKILL.md die Claude on-demand laadt wanneer een taak past, in plaats van altijd actief zoals CLAUDE.md. Het vult CLAUDE.md aan in plaats van het te vervangen. De scope is in 2026 nog in ontwikkeling, dus behandel het als een gespecialiseerde toevoeging, geen vierde bestand dat elk project nodig heeft.