The CLAUDE.md file

Kernconcepten

Doel

• Biedt Claude Code persistent geheugen over uw project
• Elimineert de noodzaak om de codebase bij elke sessiestart opnieuw te verkennen
• Fungeert als een "onboarding script" voor uw codebase

Hoe het werkt

• Markdown-bestand geplaatst in projectroot
• Automatisch gelezen door Claude Code bij sessiestart
• Inhoud wordt toegevoegd aan uw prompt
• Kan automatisch gegenereerd worden met /slash init commando

Wat u moet opnemen

• Tech stack (frameworks, libraries, tools)
• Code style voorkeuren (indentatie, naamgevingsconventies, exporttypes)
• Projectstructuur (waar bestanden/routes horen)
• Commando's (dev server, tests, lint)
• Best practices (server actions verkiezen boven API routes, enz. )

Geheugenhiërarchie

• **Project-level Claude. md** (root directory) - gedeeld met team via versiebeheer
• **User-level Claude. md** (configuratiemap) - persoonlijke voorkeuren voor alle projecten

Best Practices

• Begin zonder Claude. md om te identificeren waar u moet bijsturen
• Houd het bestand compact met alleen essentiële informatie
• Vraag Claude expliciet om correcties in het geheugen op te slaan voor toekomstige sessies
• Verwijs naar projectdocumentatie met @ symbool met bestandspaden
• Bouw incrementeel op terwijl u ontdekt wat Claude moet weten

Voornaamste voordeel

• Transformeert Claude Code van frustrerend (constante correcties) naar productief (juiste context vanaf het begin)

Belangrijkste inzichten

• **Claude. md biedt persistent geheugen** voor uw project, automatisch gelezen bij elke sessiestart om repetitieve codebase-verkenning te elimineren

• Voeg essentiële context toe: tech stack, code style voorkeuren, projectstructuur, commando's en best practices om Claude's werk vanaf het begin te sturen

• Twee-niveau geheugensysteem: project-level Claude. md (gedeeld via versiebeheer) + user-level Claude. md (persoonlijke voorkeuren voor alle projecten)

• Bouw incrementeel en houd het compact—begin zonder, identificeer hiaten, voeg dan alleen kritieke informatie toe; vraag Claude expliciet om correcties voor toekomstige sessies op te slaan

• Transformeert productiviteit: juiste upfront context elimineert constante correcties en maakt Claude Code echt nuttig in plaats van frustrerend