CLAUDE.md: skriv den perfekte projektinstruktionsfil

CLAUDE.md er den vigtigste fil, du kan oprette i dit projekt, når du arbejder med Claude Code. Det er en Markdown-fil, som Claude Code automatisk indlæser ved opstart — og den definerer, hvem Claude er i netop dit projekt, hvad den skal gøre, og hvad den ikke må gøre.

Hvad er CLAUDE.md?

Når du kører claude i en mappe, leder Claude Code automatisk efter en CLAUDE.md i roden af projektet. Hvis filen findes, indlæses dens indhold som en slags vedvarende kontekst — Claude vil følge de instruktioner, der er beskrevet der, gennem hele sessionen.

Tænk på det som en systemprompt for dit projekt: den sætter scenen en gang for alle, så du ikke skal forklare projektets kontekst i hver eneste samtale.

Placering og hierarki

hooks og automatisering af CLAUDE.md:

1. Global: ~/.claude/CLAUDE.md — gælder for alle dine projekter
2. Projekt: /dit-projekt/CLAUDE.md — gælder for dette projekt
3. Mappe: /dit-projekt/src/CLAUDE.md — gælder kun for denne undermappe

Claude Skills instruktioner, og mappe-instruktioner overskriver projekt-instruktioner.

Hvad skal der stå i den?

En god CLAUDE.md indeholder typisk disse sektioner:

1. Projektbeskrivelse

Hvad er projektet? Hvad gør det? Hvem er det til? Claude skal have denne kontekst for at tage gode beslutninger.

2. Teknisk stack

Hvilke sprog, frameworks og biblioteker bruger projektet? Hvilken version af Node.js, Python, osv.?

3. Konventioner og kodestil

Navngivning (camelCase vs snake_case), filstruktur, importrækkefølge, testframework og linting-regler.

4. Must-do og must-not-do

Eksplicitte regler for hvad Claude altid eller aldrig må gøre i projektet.

5. Nyttige ressourcer

ID’er, URL’er, filstier og andre konkrete references Claude kan have brug for.

Konkret eksempel

# Mit E-handelsprojekt

## Hvad projektet er
Next.js webshop med Stripe-integration og Sanity CMS.
Backend API: /api/v2/*
Produkter: Sanity document type 'product'

## Tech stack
- Next.js 15, React 19, TypeScript strict
- Tailwind CSS 4
- Prisma + PostgreSQL
- Vitest til tests

## Konventioner
- Komponenter: PascalCase, én fil per komponent
- API-routes: kebab-case
- Brug altid 'const' frem for 'let' hvor muligt
- Imports: biblioteker først, interne bagefter

## Must-do
- Skriv altid TypeScript types, aldrig 'any'
- Tilføj tests til nye utility-funktioner
- Kør 'npm run lint' efter større ændringer

## Must-NOT-do
- Redigér aldrig /prisma/migrations direkte
- Commit aldrig .env-filer
- Brug ikke deprecated React class components

## Nyttige referencer
- Stripe webhook secret: se .env.local (STRIPE_WEBHOOK_SECRET)
- Sanity project ID: abc123xyz
- Staging URL: https://staging.mitprojekt.dk

Tips til at holde den opdateret

• Behandl CLAUDE.md som en del af kodebasen — commit den til Git
• Opdater den, når projektets stack eller konventioner ændrer sig
• Tilføj løbende de ting, du opdager at Claude gentagne gange gør forkert
• Bed Claude om at opdatere CLAUDE.md når du etablerer en ny konvention

En velvedligeholdt CLAUDE.md er den hurtigste måde at forbedre kvaliteten af Claudes output i dit specifikke projekt.