CLAUDE.md

Wat is CLAUDE.md?

CLAUDE.md is een tekstbestand dat je in de root van een project plaatst als permanente instructieset voor Claude Code. Telkens wanneer Claude Code in een project start, leest het het CLAUDE.md-bestand en gebruikt die instructies als context voor de hele sessie — zonder dat je ze telkens opnieuw moet herhalen.

Het bestand werkt als een combinatie van een welkomstbrief, een stijlgids en een lijst van spelregels: het vertelt Claude Code wat het project is, hoe de code is georganiseerd, welke conventies gelden, welke commando’s het mag of niet mag uitvoeren, en hoe het moet omgaan met onzekerheid.

Wat zet je in CLAUDE.md?

Er is geen vaste structuur — het is gewone tekst in Markdown-formaat. Typische inhoud: een beschrijving van het project en zijn doel, de mappenstructuur uitgelegd, codeerstijl en conventies (taal, naamgevingsconventies, formatting), commando’s die Claude Code altijd of nooit mag uitvoeren, instructies voor specifieke workflows (hoe testen draaien, hoe deployen, hoe documenteren), en escalatieregels (wanneer vragen aan de gebruiker in plaats van zelf beslissen).

Voor wie Claude Code gebruikt om een WordPress-site te beheren — zoals bij AIFabriek — bevat CLAUDE.md typisch ook: de URL van de site, authenticatie-aanwijzingen, welke post types bestaan, welke velden verwacht worden, en hoe slugs gecontroleerd moeten worden voor publicatie.

Verschil met Skills

CLAUDE.md en Skills hebben een overlappend doel maar een andere scope. Een CLAUDE.md is projectspecifiek — het beschrijft dit project en geldt alleen wanneer Claude Code in die map werkt. Een Skill is taakspecifiek en werkt platformbreed — het beschrijft hoe een bepaald type taak aan te pakken, ongeacht het project.

In de praktijk combineer je ze: CLAUDE.md geeft de projectcontext, Skills geven de taakinstructies. Samen zorgen ze voor consistente, voorspelbare output van Claude Code over meerdere sessies.

Waarom relevant voor jou als ondernemer?

1. Geen herhaling meer. Alles wat je normaal bij elke Claude Code sessie opnieuw uitlegt — de structuur van je project, de regels, de stijl — zet je één keer in CLAUDE.md. Claude leest het automatisch.

2. Veiligheidsregel voor kritische systemen. In CLAUDE.md kan je expliciete verboden opnemen: “verwijder nooit bestaande posts”, “vraag bevestiging voor publicatie”, “schrijf alleen naar /wiki/, niet naar andere post types”. Dit is de eerste verdedigingslinie tegen onbedoelde acties.

3. Werkt ook voor niet-developers. CLAUDE.md is gewone tekst — je hoeft geen code te kennen om het te schrijven of te lezen. Het is een praktisch gereedschap voor iedereen die Claude Code inzet voor terugkerende taken.