Project Impact
Terug naar Woordenboek
intermediateTechnisch
5 min leestijd

CLAUDE.md

Simpele Uitleg

CLAUDE.md is het instructiebestand waarmee je Claude Code vertelt hoe het met jouw project moet werken. Je plaatst het in de root van je project en Claude leest het automatisch bij elke sessie. Denk aan een briefing voor een nieuwe collega: welke technologieën gebruiken we, hoe is de code gestructureerd, wat zijn de afspraken? Dat schrijf je één keer op, en Claude weet het voortaan.

Technische Definitie

CLAUDE.md is een Markdown-bestand dat automatisch in de systeemprompt van Claude Code wordt geladen. Het werkt op meerdere niveaus: een persoonlijk bestand in ~/.claude/CLAUDE.md (voor al je projecten), een projectbestand in ./CLAUDE.md (gedeeld via git), en lokale overrides in ./CLAUDE.local.md (persoonlijk, niet gecommit). Claude Code loopt bij het opstarten vanaf de werkdirectory omhoog naar de root en laadt elk CLAUDE.md-bestand dat het tegenkomt — ideaal voor monorepos. Daarnaast ondersteunt het @import-syntax en modulaire regels via .claude/rules/.

Waarom Dit Belangrijk Is

Zonder CLAUDE.md moet je bij elke sessie opnieuw uitleggen hoe je project werkt. Welke buildcommando's gebruik je? Welke conventies volg je? Welke bestanden zijn belangrijk? Dat kost tijd en leidt tot inconsistente resultaten.

Met een goed CLAUDE.md-bestand werkt Claude Code vanaf de eerste prompt alsof het je project al kent. Het is het verschil tussen "schrijf een functie" (vaag) en "schrijf een functie volgens onze TypeScript-conventies met Tailwind-styling" (specifiek).

Voor development teams is het essentieel om een gedeeld CLAUDE.md in git te hebben. Dan werkt Claude voor iedereen in het team op dezelfde manier. In de Claude Code Masterclass leer je hoe je een effectief CLAUDE.md opzet.

Hoe Het Werkt

Je maakt een bestand genaamd CLAUDE.md in de root van je project. Daarin schrijf je de context die Claude nodig heeft: welke frameworks je gebruikt, hoe je test, wat de mappenstructuur is, en eventuele codestandaarden.

Claude Code heeft een handig commando: /init. Dat analyseert je codebase en genereert een eerste versie van CLAUDE.md op basis van je package.json, configuratiebestanden en codestructuur. Van daaruit pas je het aan.

Het bestand werkt op meerdere niveaus. Een persoonlijk bestand in ~/.claude/CLAUDE.md geldt voor al je projecten — handig voor voorkeuren als "gebruik altijd Nederlandse variabelenamen." Een projectbestand in ./CLAUDE.md deel je via git met je team. En .claude/rules/ bevat modulaire regels die je per onderwerp organiseert.

Houd het beknopt: minder dan 300 regels is de vuistregel. Hoe specifieker je instructies, hoe beter de output. In AI als Teamsport leer je hoe je dit als team inricht.

Use Cases

Projectstandaarden afdwingen

Een development team legt in CLAUDE.md vast: "Gebruik TypeScript strict mode, Tailwind voor styling, en schrijf tests met Vitest." Claude Code volgt deze afspraken automatisch bij elke code-wijziging — geen handmatige review nodig voor basisstandaarden.

Buildcommando's centraliseren

In CLAUDE.md staan de commando's voor development, testing en deployment. Claude Code weet dan precies hoe het de app moet draaien, testen en bouwen zonder dat je het elke keer vertelt.

Architectuurbeslissingen documenteren

Leg vast waarom bepaalde keuzes zijn gemaakt: "We gebruiken Server Components voor SEO, Client Components alleen voor interactiviteit." Claude Code respecteert deze architectuur bij het schrijven van nieuwe code.

Team-breed AI-workflows standaardiseren

Als iedereen in het team hetzelfde CLAUDE.md deelt via git, werkt Claude Code voor iedereen consistent. Geen individuele afspraken meer — één bron van waarheid. In AI als Teamsport leer je hoe je dit organiseert.

Voorbeelden

Minimaal CLAUDE.md-bestand

Een effectief CLAUDE.md hoeft niet lang te zijn. De kern: welke taal en frameworks je gebruikt, de belangrijkste commando's (npm run dev, npm run build, npm test), en een paar codestandaarden. Met die informatie presteert Claude Code al significant beter dan zonder.

Monorepo met meerdere CLAUDE.md-bestanden

In een monorepo met een frontend en backend map zet je een algemeen CLAUDE.md in de root ("TypeScript overal, ESLint configuratie") en specifieke bestanden per map ("frontend: React met Tailwind" en "backend: Node.js met Prisma"). Claude Code laadt automatisch beide niveaus.

Persoonlijk vs. gedeeld

In ~/.claude/CLAUDE.md zet je persoonlijke voorkeuren: "Schrijf commit messages in het Nederlands" of "Gebruik altijd bun in plaats van npm." In het project-CLAUDE.md staan teamafspraken. CLAUDE.local.md is voor jouw lokale overrides die niet in git komen.

Veelgemaakte Fouten

"Ik schrijf alles wat ik weet in CLAUDE.md"

Hoe langer het bestand, hoe minder effectief. Claude moet alles verwerken binnen het context window. Houd het onder 300 regels. Specificiteit is belangrijker dan volledigheid — schrijf alleen wat Claude daadwerkelijk nodig heeft.

"Ik maak het bestand één keer en raak het niet meer aan"

Je project verandert, en je CLAUDE.md moet meeveranderen. Gebruik /init om een startversie te genereren, maar review en update het regelmatig. Een verouderd CLAUDE.md levert verouderde code op.

"Iedereen in het team heeft zijn eigen versie"

Zonder gedeeld CLAUDE.md in git werkt Claude voor iedereen anders. Leg teamafspraken vast in ./CLAUDE.md (gedeeld). Persoonlijke voorkeuren gaan in ~/.claude/CLAUDE.md of .CLAUDE.local.md. Zo combineer je consistentie met flexibiliteit.

Tools Die Dit Gebruiken

Claude Code

Veelgestelde Vragen

Hoe maak ik een CLAUDE.md voor mijn project?
De snelste manier: open Claude Code in je project en typ /init. Claude analyseert je codebase en genereert een startversie. Pas het aan met je specifieke conventies en commando's. Je kunt het ook handmatig schrijven — begin met frameworks, buildcommando's en codestandaarden.
Wordt CLAUDE.md gedeeld met mijn team?
Ja, als je het commit naar git. ./CLAUDE.md is bedoeld om te delen. Voor persoonlijke voorkeuren gebruik je ~/.claude/CLAUDE.md (al je projecten) of ./CLAUDE.local.md (dit project, wordt automatisch ge-gitignored).
Hoe lang moet een CLAUDE.md zijn?
Zo kort mogelijk, maar zo specifiek als nodig. De vuistregel is minder dan 300 regels. Schrijf geen algemene informatie die Claude al weet — focus op projectspecifieke afspraken, commando's en architectuurbeslissingen.
Kan ik meerdere CLAUDE.md-bestanden hebben?
Ja. Claude Code loopt vanaf je werkdirectory omhoog en laadt elk CLAUDE.md-bestand dat het tegenkomt. In een monorepo kun je een algemeen bestand in de root hebben en specifieke bestanden per submap. Ze worden gecombineerd, met de meest specifieke als prioriteit.

Wil je deze term in de praktijk leren toepassen?

Bekijk TrainingenPlan Kennismaking