Claude Code en CLAUDE.md: zo geef je jouw AI-assistent een vaste persoonlijkheid en werkstijl

Geen groot nieuws vandaag dat zich goed leent voor een directe how-to koppeling, dus vandaag een tip die je project direct stabieler en sneller maakt: jouw CLAUDE.md-bestand goed inrichten.

Als je regelmatig met Claude Code werkt, merk je dat je steeds dezelfde dingen uitlegt aan het begin van een sessie. "Gebruik Tailwind, geen inline styles." "Schrijf alle teksten in het Nederlands." "Commit message altijd in het Engels." Dat is zonde van je tijd, en het vergroot de kans dat Claude op een slechte dag toch even iets anders doet.

De oplossing heet CLAUDE.md.

Wat is CLAUDE.md?

Een CLAUDE.md is een gewoon tekstbestand dat je in de root van je project zet. Claude Code leest het automatisch aan het begin van elke sessie en gebruikt het als vaste instructieset voor jouw project. Zie het als een memo aan je assistent die altijd op het bureau ligt, ook als je zelf al drie weken niet aan het project hebt gewerkt.

Je hoeft dit bestand niet te activeren of aan te roepen. Zet het neer, en Claude pakt het op.

Hoe pak je het aan met Claude Code?

Stap 1: laat Claude het bestand voor je aanmaken

Open Claude Code in je project en geef deze prompt:

Maak een CLAUDE.md-bestand aan voor dit project. Vraag me eerst welke tech stack we gebruiken, wat de taal is van de interface, wat de codeerstijl is, en wat ik absoluut niet wil dat je doet. Stel me die vragen één voor één.

Clause stelt je dan gerichte vragen. Beantwoord ze eerlijk. Na drie of vier antwoorden schrijft hij het bestand voor je.

Stap 2: vul de juiste secties in

Een goed CLAUDE.md heeft minimaal deze blokken:

# Project: [naam van je SaaS]

## Stack
- Framework: Next.js 14 met App Router
- Styling: Tailwind CSS (geen inline styles, geen CSS modules)
- Database: Supabase
- Betalingen: Stripe

## Taal en toon
- UI-teksten: altijd Nederlands
- Code en variabelenamen: altijd Engels
- Commit messages: Engels, imperatief ("Add feature" niet "Added feature")

## Werkafspraken
- Maak nooit een nieuwe npm-package aan zonder dat ik dat expliciet vraag
- Schrijf altijd TypeScript, geen plain JavaScript
- Voeg na elke wijziging een korte uitleg toe van wat je hebt gedaan en waarom

## Wat ik NIET wil
- Geen `any` types in TypeScript
- Geen grote refactors tenzij ik daar expliciet om vraag
- Geen verwijdering van bestaande functionaliteit zonder overleg

Stap 3: voeg projectcontext toe

Naast technische instructies is een korte beschrijving van wat je bouwt enorm waardevol. Claude begrijpt dan beter waarom je bepaalde keuzes maakt:

## Wat we bouwen
Een facturatie-tool voor Nederlandse ZZP'ers. De gebruiker is niet technisch.
Het product moet simpel aanvoelen: weinig knoppen, duidelijke taal, geen jargon.
De core feature is: een factuur maken in minder dan twee minuten.

Stap 4: test of het werkt

Sluit je Claude Code-sessie en open een nieuwe. Geef dan deze prompt:

Vertel me in je eigen woorden wat je weet over dit project en welke werkafspraken we hebben.

Clause moet dan jouw CLAUDE.md samenvatten. Als hij dat correct doet, werkt het. Als hij er naast zit, pas je het bestand aan en herhaal je de test.

Wat te checken na afloop

• Opent Claude Code een nieuwe sessie en gebruikt hij direct de juiste taal, stack en stijl zonder dat je het vraagt? Dan zit je goed.
• Weigert Claude een package te installeren die je niet gevraagd hebt? Ook goed.
• Schrijft hij nog steeds any in TypeScript terwijl je dat verboden hebt? Dan is de instructie te vaag. Maak hem specifieker: "Gebruik nooit het type any. Gebruik in plaats daarvan unknown plus een type guard."

Een goed CLAUDE.md is een levend document. Elke keer dat je merkt dat je iets herhaalt in je prompts, zet je het in het bestand. Na een week of twee heb je een assistent die echt jouw project kent.