Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.md is een markdown-configuratiebestand dat in de root van je project wordt geplaatst en Claude Code persistente, projectspecifieke instructies geeft. Het vertelt de agent over je coderingsconventies, architectuur, veelgebruikte opdrachten en regels — en fungeert als een vorm van langetermijngeheugen dat op elke sessie in dat project van toepassing is.

Hoe CLAUDE.md werkt

Wanneer Claude Code een sessie start, leest het automatisch het CLAUDE.md-bestand in de root van je project (en eventuele CLAUDE.md-bestanden in bovenliggende mappen of submappen). De inhoud wordt onderdeel van de systeemcontext van de agent, zodat het je instructies volgt zonder elke sessie herinnerd te hoeven worden. Dit zorgt ervoor dat de agent consistent handelt volgens de conventies van je team.

Wat je in CLAUDE.md opneemt

  • +Overzicht van de projectarchitectuur en belangrijke bestandslocaties
  • +Coderingsconventies (naamgeving, opmaak, patronen om te gebruiken of te vermijden)
  • +Veelgebruikte opdrachten voor testen, bouwen en deployen
  • +Regels zoals "schrijf altijd tests voor nieuwe functies" of "wijzig nooit direct de auth-module"
  • +Details over de technologiestack waar de agent zich bewust van moet zijn
markdown
# CLAUDE.md

## Project
Next.js 14 app with App Router, TypeScript, Tailwind CSS.

## Commands
- `npm run dev` — start dev server
- `npm test` — run Jest tests
- `npm run lint` — ESLint check

## Conventions
- Use server components by default
- Client components go in `components/client/`
- All API routes must validate input with Zod
- Write tests for every new utility function

## Do NOT
- Modify files in `lib/core/` without explicit approval
- Use `any` type in TypeScript
- Add new dependencies without justification

Houd CLAUDE.md beknopt. De agent leest het elke sessie, dus neem alleen informatie op die relevant is over meerdere taken. Verplaats taakspecifieke details naar je prompts.

Waar moet ik het CLAUDE.md-bestand plaatsen?+
Plaats het in de root van je projectmap. Claude Code ondersteunt ook CLAUDE.md-bestanden in submappen voor modulespecifieke instructies en in bovenliggende mappen voor organisatiebrede regels. Alle van toepassing zijnde bestanden worden samengevoegd.
Werkt CLAUDE.md met andere AI-tools?+
CLAUDE.md is specifiek voor Claude Code. Sommige andere tools hebben echter vergelijkbare concepten overgenomen. Cursor gebruikt .cursorrules en andere agents kunnen aangepaste configuratiebestanden lezen. Het concept van projectniveau AI-instructies wordt een veelvoorkomend patroon.
Hoe lang moet CLAUDE.md zijn?+
Houd het onder de 500 regels. Focus op de belangrijkste conventies en regels. De agent kan altijd individuele bestanden lezen voor details — CLAUDE.md moet de context op hoog niveau bieden die over taken heen van toepassing is.

Related terms

Agentic CodingClaude CodePrompt Engineering voor Code

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS