CLAUDE.md Beste praktijken: Claude-code instellen voor elk project
CLAUDE.md is de meest impactvolle configuratie voor Claude Code. Een goed geschrevene verandert generieke AI-hulp in projectspecifieke expertise.
CLAUDE.md is een markdown bestand aan de root van uw project. Claude Code leest het aan het begin van elke sessie voordat je iets typt. Een goede claude. md transformeert generieke AI in een tool die de conventies van uw project, tech stack en rode lijnen begrijpt.
Wat moet u opnemen in CLAUDE.md?
Focus op informatie die een slimme ontwikkelaar nodig heeft bij uw team op dag één. Houd het praktisch: tech stack, commando's, conventies, en dingen om te vermijden.
Minimale CLAUDE.md template
# Project Context
Next.js 14 app with TypeScript, Tailwind CSS, and Prisma.
Database: PostgreSQL. Auth: NextAuth.js.
## Commands
- `npm run dev` — start dev server (port 3000)
- `npm run test` — run Jest tests
- `npm run lint` — run ESLint
- `npm run db:migrate` — run Prisma migrations
## Architecture
- Server components by default, client components in /components/client/
- API routes in /app/api/ with Zod validation
- Database queries in /lib/db/ (never in components)
## Conventions
- TypeScript strict mode, never use `any`
- Tailwind for styling, no CSS modules
- Conventional commits: feat:, fix:, chore:
## Do NOT
- Modify files in /legacy/ or /vendor/
- Change auth configuration without explicit approval
- Add new dependencies without asking firstWat zijn de meest voorkomende CLAUDE. Md fouten?
| Fouten | Waarom doet het pijn | Repareren |
|---|---|---|
| Te lang (500+ lijnen) | Verspilt contextvenster op elke sessie | Blijf onder de 200 regels, link naar documenten voor details |
| Te vaag ("schrijf schone code") | Geeft geen uitvoerbare begeleiding | Wees specifiek: "Servercomponenten standaard gebruiken" |
| Ontbrekende opdrachten | Claude raadt hoe te draaien/test/bouwen | Alle relevante npm-scripts tonen |
| Geen beperkingen | Claude kan gevoelige bestanden wijzigen | Een duidelijke "niet doen" sectie toevoegen |
| Dupliceren van README | README is voor mensen, CLAUDE.md is voor AI | Focus op conventies en regels, geen projectbeschrijving |
Hoe structureer je CLAUDE.md voor grote projecten?
Voor grote codebases, gebruik de @import syntax om configuratie te splitsen over mappen. Claude Code volgt import en bouwt een compleet beeld op.
# Root CLAUDE.md
## Global conventions
- TypeScript strict, no `any`
- All API routes validate input with Zod
@import packages/api/CLAUDE.md
@import packages/web/CLAUDE.md
@import packages/shared/CLAUDE.mdElke sub-CLAUDE.md bevat specifieke regels voor dat pakket. Dit houdt het root bestand kort terwijl het Claude Code diepe context geeft over elk gebied van de codebase.
Hoe genereert u CLAUDE.md automatisch?
Claude Code kan een beginnende CLAUDE genereren. md door uw project te analyseren:
# Auto-generate CLAUDE.md
claude /init
# This creates a CLAUDE.md based on:
# - package.json scripts
# - Project structure
# - Existing config files
# - Git history patternsHoe zit het met CLAUDE.md geheugenhiërarchie?
Claude Code leest CLAUDE.md bestanden van meerdere locaties, in volgorde van prioriteit:
- +Project root CLAUDE.md (iedereen in het team deelt dit)
- +Subdirectory CLAUDE.md bestanden (via @import)
- +~/.claude/CLAUDE.md (uw persoonlijke globale voorkeuren)
- +Auto Geheugen (MEMORY.md, beheerd door /memory commando)
Instellingen op projectniveau overschrijven persoonlijke instellingen. Dit betekent dat teamconventies altijd winnen van individuele voorkeuren.