Workbranch › Handleidingen

Een CLAUDE.md-bestand schrijven voor Claude Code

Elke sessie in Claude Code begint met een lege context, dus je herhaalt steeds dezelfde buildcommando's en huisregels. Een CLAUDE.md-bestand lost dat op. Deze handleiding laat zien waar het staat, wat erin hoort en hoe je controleert of Claude het echt leest.

Bijgewerkt 30 oktober 2026

De locaties en commando's hieronder zijn in oktober 2026 gecontroleerd aan de hand van de documentatie van Anthropic over Claude Code. Ontbreekt er iets in jouw versie, voer dan claude update uit.

Waar CLAUDE.md-bestanden staan

Je kunt meerdere bestanden hebben, elk met een ander bereik. Claude Code combineert ze allemaal in plaats van het ene door het andere te laten vervangen; de specifiekere worden als laatste gelezen.

Bestanden in de map waarin je start en in elke map daarboven worden bij het opstarten geladen. Een CLAUDE.md in een submap wordt later geladen, zodra Claude een bestand in die submap leest of bewerkt.

Het bestand maken met /init

1. Open een terminal in de hoofdmap van het project en start claude.
2. Typ /init. Claude bekijkt de codebase en schrijft een eerste CLAUDE.md met de buildcommando's, testinstructies en conventies die het vindt. Bestaat er al een CLAUDE.md, dan stelt het verbeteringen voor in plaats van het bestand te overschrijven.
3. Lees het concept en verwijder alles wat vanzelfsprekend of onjuist is.
4. Voeg toe wat Claude niet uit de code kan halen: beslissingen, eigenaardigheden van de omgeving, regels als "doe nooit X".
5. Commit het bestand, zodat je teamgenoten dezelfde instructies krijgen.

Wil je het later aanpassen, voer dan /memory uit. Dat toont de locaties van je CLAUDE.md en CLAUDE.local.md voor gebruiker en project, ook als ze nog niet bestaan, en opent het bestand dat je kiest in je editor. Je kunt ook gewoon zeggen zet dit in CLAUDE.md.

Wat erin hoort

Een simpele toets: heb je Claude iets twee keer moeten vertellen, dan hoort het in het bestand. Typische momenten om een regel toe te voegen: Claude maakt een fout opnieuw, een code review vangt iets wat het had moeten weten, of je typt dezelfde correctie als in de vorige sessie.

• Commando's: hoe je het project buildt, test, lint en draait.
• Indeling: waar belangrijke code staat, zoals API-handlers staan in src/api/handlers/.
• Conventies: naamgeving, opmaak, regels voor branches en commits.
• Lastig verworven kennis: dingen waar een nieuwe teamgenoot over zou struikelen.

Schrijf regels die je kunt controleren. Voer npm test uit voor je commit werkt beter dan test je wijzigingen. Groepeer regels onder kopjes en opsommingstekens, en verwijder instructies die elkaar tegenspreken, want Claude kan elk van beide volgen. Procedures met meerdere stappen of regels die maar voor één deel van de codebase gelden, horen in een skill of een regel met een pad-bereik.

Houd het kort en overzichtelijk

• Omvang: mik op minder dan 200 regels per bestand. Langere bestanden kosten meer context en worden minder betrouwbaar gevolgd.
• Imports: schrijf @README of @docs/git-instructions.md om een ander bestand in te voegen. Paden zijn relatief ten opzichte van de CLAUDE.md, en imports kunnen tot vier niveaus diep genest zijn. Geïmporteerde bestanden kosten nog steeds context, dus dit helpt bij de ordening, niet bij de omvang. De eerste keer dat een project een bestand van buiten de map importeert, vraagt Claude Code je om toestemming.
• Map met regels: zet onderwerpbestanden zoals testing.md in .claude/rules/. Voeg bovenaan een veld paths toe (bijvoorbeeld src/api/**/*.ts) en de regel wordt alleen geladen als Claude aan overeenkomende bestanden werkt.
• Controle: in recente versies vraagt /doctor prompt-audit Claude om verouderde of tegenstrijdige instructies op te sporen en wijzigingen voor te stellen, zonder iets aan te passen tot jij dat zegt.

CLAUDE.md vs. auto memory

Claude Code houdt ook eigen notities bij, auto memory genoemd. CLAUDE.md schrijf jij; auto memory schrijft Claude op basis van je correcties en voorkeuren. Het staat per repository in ~/.claude/projects/<project>/memory/, met een index MEMORY.md waarvan de eerste 200 regels (of 25KB) in elke sessie worden geladen. Het blijft op je eigen computer en wordt niet via git gedeeld. Zeg je onthoud dat je altijd pnpm gebruikt, dan gaat dat naar auto memory; zet de functie aan of uit met de schakelaar in /memory. Gebruik CLAUDE.md voor alles wat het hele team moet krijgen.

Goed om te weten

• Claude Code zit bij de Pro- en Max-abonnementen, als onderdeel van hetzelfde abonnement als de Claude-apps; voor leden van Team en Enterprise is er een apart helpartikel.
• CLAUDE.md stuurt het gedrag, maar dwingt niets af. Blokkeer commando's of bestanden met permissieregels in de instellingen.
• De CLAUDE.md in de hoofdmap van het project wordt na /compact opnieuw van schijf gelezen, dus regels die daar staan overleven lange sessies, terwijl regels die je alleen in de chat hebt getypt verloren kunnen gaan. Bestanden in submappen en regels met een pad-bereik komen terug zodra Claude weer overeenkomende bestanden aanraakt.
• Bestanden in mappen die met --add-dir zijn toegevoegd worden niet geladen, tenzij je CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 instelt.

Als het niet werkt

• Claude negeert een instructie. Voer /context uit en kijk onder Memory files. Staat het bestand er niet bij, dan kan Claude het niet zien: controleer de bestandsnaam en of je Claude in de juiste map hebt gestart.
• Regels worden maar soms gevolgd. Maak ze specifieker, haal tegenstrijdigheden met andere CLAUDE.md- of regelbestanden weg en maak het bestand korter.
• Een import wordt niet geladen. In een pad met spaties moet voor elke spatie een backslash staan, een pad tussen aanhalingstekens wordt niet geïmporteerd en een pad tussen backticks blijft letterlijke tekst. Imports van buiten het project hebben eenmalig je toestemming nodig.
• De CLAUDE.md van een submap lijkt te ontbreken. Die wordt pas geladen als Claude een bestand in die submap aanraakt.

Houd beslissingen en taken buiten het bestand

CLAUDE.md is voor blijvende regels, niet voor de openstaande taken van deze week. De Workbranch-plugin voor Claude Code neemt dat deel voor zijn rekening: voer /workbranch:save uit en Claude legt de taken, beslissingen en open vragen van de sessie vast in een Workbranch-project, en als een sessie start in een map die aan een Workbranch-project is gekoppeld, laat de plugin zien wat daar nog openstaat. Er is een gratis proefperiode van 3 dagen op app.workbranch.ai.

Bronnen

• How Claude remembers your project (Claude Code Docs, gecontroleerd op 2026-10-30)
• Commands (Claude Code Docs, gecontroleerd op 2026-10-30)
• Use Claude Code with your Pro or Max plan (Claude Help Center, gecontroleerd op 2026-10-30)

Veelgestelde vragen