CLAUDE.md configuratie

Een CLAUDE.md bestand is het krachtigste wapen in je Claude Code toolkit. Het vertelt Claude wie je bent, wat je project doet, en welke regels het moet volgen.

Wat is CLAUDE.md?

CLAUDE.md is een Markdown-bestand in de root van je project. Claude leest het automatisch bij het starten van een sessie. Zie het als een briefing voor Claude — alles wat het moet weten staat erin.

/mijn-project
  CLAUDE.md        <-- Claude leest dit automatisch
  package.json
  src/
    ...

Je kunt er snel eentje aanmaken met:

/init

Project-level vs user-level

Er zijn twee soorten CLAUDE.md:

Project-level (in je project)

/mijn-project/CLAUDE.md

Geldt alleen voor dit project. Check dit in bij Git zodat je team het ook heeft.

User-level (in je home directory)

~/.claude/CLAUDE.md

Geldt voor alle projecten. Handig voor persoonlijke voorkeuren die overal gelden.

Claude combineert beide: eerst de user-level regels, dan de project-level regels.

Wat zet je erin?

1. Projectbeschrijving

## Project
E-commerce webshop gebouwd met Next.js 14, Prisma en PostgreSQL.
Monorepo met apps/web (frontend) en apps/api (backend).

2. Tech stack en conventies

## Tech stack
- Next.js 14 met App Router
- TypeScript (strict mode)
- Tailwind CSS voor styling
- Prisma als ORM
- PostgreSQL database

## Conventies
- Componenten in PascalCase
- Utility functies in camelCase
- Bestanden max 200 regels
- Altijd error handling met try/catch

3. Regels en beperkingen

## Regels
- Schrijf ALTIJD TypeScript, nooit JavaScript
- Gebruik NOOIT any types
- Elke functie heeft JSDoc commentaar
- Tests zijn verplicht voor alle utility functies
- Geen inline styles, altijd Tailwind classes

4. Veelvoorkomende taken

## Commando's
- `npm run dev` — development server
- `npm run build` — productie build
- `npm run test` — tests draaien
- `npm run lint` — code linting

Een echt voorbeeld

Hier is een compleet CLAUDE.md bestand voor een typisch project:

# Mijn Webshop

## Project
Online webshop voor handgemaakte sieraden.
Next.js 14 met Stripe betalingen en Sanity CMS.

## Tech stack
- Next.js 14 (App Router)
- TypeScript strict
- Tailwind CSS
- Stripe voor betalingen
- Sanity.io voor content

## Regels
- Nederlandse UI teksten, Engelse code
- Mobile-first responsive design
- Alle prijzen in centen opslaan, pas in UI formatteren
- Geen console.log in productie code

## Structuur
- src/app/ — pagina's en routes
- src/components/ — herbruikbare componenten
- src/lib/ — utility functies en API helpers
- src/types/ — TypeScript type definities