CLAUDE.md Gids

Schrijf de Perfecte CLAUDE.md

CLAUDE.md is het enige bestand dat bepaalt hoe Claude je project begrijpt. Een goed geschreven bestand betekent minder correcties, betere code en agenten die daadwerkelijk weten waar ze aan werken.

Deze gids leidt je door elke sectie van een CLAUDE.md-bestand, van tech stack-verklaringen tot agent-specifieke hints. Volg mee en bouw de jouwe stap voor stap.

Wat is CLAUDE.md?

CLAUDE.md is een markdown-bestand dat je in de hoofdmap van je project plaatst. Wanneer Claude Code een sessie start, leest het dit bestand eerst. Alles erin wordt onderdeel van Claude's context: je tech stack, je bestandsstructuur, de conventies van je team en specifieke instructies die je wilt dat elke agent volgt.

Zie het als een briefingdocument. Zonder dit moet Claude raden hoe je project is georganiseerd. Met een goed bestand weet Claude al waar dingen zich bevinden, welke patronen te volgen en wat te vermijden. Het verschil in outputkwaliteit is aanzienlijk.

“Een investering van 10 minuten in CLAUDE.md bespaart uren aan het corrigeren van AI-gegenereerde code die niet overeenkomt met de patronen van je project.”

Waargenomen in honderden Claude Code-projecten

Slechte vs. Goede CLAUDE.md

De structuur en specificiteit van je CLAUDE.md hebben direct invloed op hoe goed Claude presteert in je codebase.

Zwakke CLAUDE.md

✗Vage instructies zoals "gebruik best practices" zonder specificaties
✗Geen bestandsstructuurkaart, dus Claude raadt waar nieuwe code moet komen
✗Ontbrekende codeerconventies; outputstijl varieert tussen sessies
✗Geen build- of testcommando's vermeld, wat leidt tot gebroken suggesties

Sterke CLAUDE.md

✓Expliciete tech stack met versies: React 19, Vite 6, Zustand 5, Tailwind 4
✓Duidelijke bestandskaart die belangrijke mappen en hun doel toont
✓Gedocumenteerde naamgevingspatronen, foutafhandeling en stijlvoorkeuren
✓Build-, test- en dev-commando's klaar om te kopiëren en uit te voeren

6 Essentiële Secties

Een goed gestructureerde CLAUDE.md behandelt deze zes gebieden. Elk geeft Claude concrete informatie waarop het onmiddellijk kan handelen.

Tech Stack Verklaring

Lijst je frameworks, bibliotheken en hun versies expliciet. Voeg je pakketbeheerder, Node-versie en eventuele runtimevereisten toe. Claude gebruikt dit om compatibele code te genereren zonder te raden.

Bestandsstructuurkaart

Beschrijf je belangrijkste directories en wat er in elke zit. Componenten, stores, services, API-routes, types. Een korte boomdiagram met éénregelige beschrijvingen per map werkt goed.

Codeerconventies

Documenteer je naamgevingspatronen (camelCase voor bestanden, PascalCase voor componenten), foutafhandelingsaanpak, importvolgorde en eventuele project-specifieke regels. Dit houdt Claude's output consistent met je bestaande code.

Bouw- en testcommando's

Voeg je ontwikkel-, bouw-, test- en lintcommando's toe. Wanneer Claude iets moet verifiëren of een script moet voorstellen, zal het de exacte commando's gebruiken die je project verwacht.

Agentrolaanwijzingen

Als je meerdere agents gebruikt (QA, frontend, backend, DevOps), voeg dan een sectie toe die beschrijft waarop elke rol zich moet concentreren. Dit is vooral nuttig met de multi-agent setup van AgentsRoom.

Te vermijden gebieden

Vertel Claude wat hij NIET moet doen. Wijzig geen configuratiebestanden, verander het auth-systeem niet, refactor de databaselaag niet. Expliciete grenzen voorkomen dat agents ongewenste wijzigingen aanbrengen.

Bouw je CLAUDE.md in 4 stappen

Je hoeft niet alles in één keer te schrijven. Begin met de basis en breid uit naarmate je ontdekt wat Claude moet weten.

Controleer je project

Open je package.json en lijst elke framework, bibliotheek en tool op die je project gebruikt. Noteer de versies. Controleer je runtimevereisten (Node-versie, Python-versie, database). Dit wordt je tech stack-sectie.

package.json + runtimeversies + database

Kaart je bestandstructuur in kaart

Voer een snelle boom van je src-directory uit. Identificeer de top-level mappen en schrijf een éénregelige beschrijving van elke. Focus op waar componenten, stores, services, types en API-routes zich bevinden.

src/ boom met doelannotaties

Documenteer je conventies

Kijk naar je bestaande code en noteer de patronen: hoe je bestanden benoemt, hoe je fouten afhandelt, hoe je imports structureert, of je standaard of benoemde exports gebruikt. Schrijf deze op als korte regels.

Naamgeving, imports, foutafhandeling, exports

Voeg agent-specifieke secties toe

Als je met gespecialiseerde agents werkt, voeg dan focusgebieden toe voor elke rol. De frontend-agent moet je componentenbibliotheek kennen. De DevOps-agent moet je implementatiepijplijn kennen. De QA-agent moet je testframework kennen.

Per-rol focusgebieden + te vermijden gebieden

Waarom AgentsRoom voor CLAUDE.md?

AgentsRoom is gebouwd rond CLAUDE.md als een eersteklas concept, niet als een bijzaak.

Ingebouwde CLAUDE.md-editor

Bewerk je CLAUDE.md direct binnen AgentsRoom met syntaxiskleuring en live opslaan. Geen wisselen naar je teksteditor of IDE.

Live preview per agent

Zie hoe elke agent je CLAUDE.md in realtime interpreteert. Bekijk terminaloutput om te verifiëren dat agents je conventies volgen en je te vermijden gebieden respecteren.

Per-projectcontext

Elk project in AgentsRoom heeft zijn eigen CLAUDE.md. Wissel tussen projecten en elke agent laadt automatisch het juiste contextbestand voor die codebase.

Agentrol Integratie

De 14 agentrollen van AgentsRoom koppelen direct aan CLAUDE.md-secties. Definieer focusgebieden en vermijd gebieden per rol, en elke agent pikt precies de instructies op die voor hem bedoeld zijn.

Watch what your CLAUDE.md does to Claude Code token usage

CLAUDE.md is prepended to every Claude turn. A bloated CLAUDE.md silently inflates Claude Code token usage on every message. AgentsRoom puts a per-session token meter on each agent so you can see exactly how much your CLAUDE.md is costing you, with a live cache hit rate to confirm it stays cached.

See the Claude Code token usage tracker

CLAUDE.md FAQ

Waar moet ik mijn CLAUDE.md-bestand plaatsen?+

Plaats het in de hoofdmap van je projectdirectory, naast je package.json of een gelijkwaardig configuratiebestand. Claude Code leest het automatisch wanneer je een sessie in die directory start. Je kunt ook geneste CLAUDE.md-bestanden in subdirectories hebben voor specifiekere context.

Hoe lang moet een CLAUDE.md-bestand zijn?+

Er is geen strikte limiet, maar streef naar 50 tot 300 regels. Behandel de essentie: tech stack, bestandsstructuur, conventies en commando's. Te kort en Claude mist context. Te lang en je loopt het risico de belangrijke delen te verdunnen met ruis.

Werkt CLAUDE.md met alle Claude-modellen?+

Ja. CLAUDE.md wordt gelezen door Claude Code, ongeacht welk model je selecteert (Opus, Sonnet of Haiku). Alle modellen profiteren van expliciete projectcontext, hoewel grotere modellen zoals Opus meer gedetailleerde instructies kunnen absorberen en toepassen.

Moet ik CLAUDE.md aan versiebeheer toevertrouwen?+

Ja, voor gedeelde projectinstructies. Je team profiteert van consistent AI-gedrag bij alle ontwikkelaars. Voor persoonlijke voorkeuren ondersteunt AgentsRoom persoonlijke agentconfiguraties die automatisch worden genegeerd door git.

Kan ik CLAUDE.md gebruiken met multi-agent opstellingen?+

Absoluut. In AgentsRoom leest elke agent in je project dezelfde CLAUDE.md. Je kunt rol-specifieke secties toevoegen (bijv. notities voor de QA-agent versus de frontend-agent) zodat elke specialist gerichte instructies krijgt.

Hoe vaak moet ik mijn CLAUDE.md bijwerken?+

Werk het bij wanneer de structuur of conventies van je project veranderen. Een nieuw framework toegevoegd? Werk de tech stack bij. Overgestapt naar een nieuwe directory-indeling? Werk de bestandskaart bij. Een verouderde CLAUDE.md leidt tot verouderde suggesties.