CLAUDE.md

CLAUDE.md ar den enskilt viktigaste filen i ett Claude Code-projekt. Det ar en Markdown-fil i projektets rot som Claude laser VARJE gang den startar. Tank pa den som en briefing till en ny teammedlem: fast den har teammedlemmen laser den pa 0.1 sekunder och foljer instruktionerna till punkt och pricka.

Tre nivaer av CLAUDE.md

Det som manga inte vet ar att det finns tre separata platser for CLAUDE.md, och alla tre lases och kombineras:

1. Projekt-CLAUDE.md (mest anvand)

Placera i projektets rot: ./CLAUDE.md

Denna committas till git och delas med hela teamet. Innehaller projektspecifika instruktioner.

2. Anvandare-CLAUDE.md (personlig)

Placera i: ~/.claude/CLAUDE.md

Galler for ALLA dina projekt. Perfekt for personliga preferenser:

- Svara alltid pa svenska
- Anvand funktionell programmeringsstil
- Preferera explicit typning over inferens

3. Foretags-CLAUDE.md

Placera i: ~/.claude/projects/{projekt-hash}/CLAUDE.md

For projekt-specifika personliga anteckningar som du INTE vill committa.

Vad ska sta i CLAUDE.md?

En bra CLAUDE.md har fyra sektioner:

Projektbeskrivning

# Projektnamn
En SaaS-plattform for fastighetsforvaltning byggd med Next.js 15, 
Supabase och Stripe. Monorepo med Turborepo.

Teknisk stack och konventioner

## Stack
- Next.js 15 App Router
- TypeScript strict mode
- Tailwind CSS + Shadcn/ui
- Supabase (auth, database, storage)
- Prisma ORM

## Konventioner
- Alla API-routes i app/api/
- Server Actions i lib/actions/
- Komponentnamn: PascalCase
- Filnamn: kebab-case
- Tester brevid filen: component.test.tsx

Kommandon

## Kommandon
- `npm run dev`: starta utvecklingsserver
- `npm run test`: kör alla tester
- `npm run lint`: kör linting
- `npx prisma studio`: oppna databas-UI

Regler och begransningar

## Regler
- Andra ALDRIG filer i /generated/
- Kör alltid `npm run lint` efter kodandringar
- Alla nya API-routes MASTE ha autentisering
- Anvand INTE any-typen

AGENTS.md: for sub-agenter

En relaterad fil ar AGENTS.md, som specificerar regler just for sub-agenter. Om du anvander Claude Codes sub-agent-system (mer om detta i en senare lektion) kan du ha separata instruktioner for dem.

Du kan aven anvanda @AGENTS.md som en referens inifran CLAUDE.md for att dela upp innehallet.

Dynamiskt innehall

Ett kraftfullt trick: CLAUDE.md kan referera till andra filer med relativa sokvagar. Claude kommer att lasa dem:

Se arkitektur-dokumentation: ./docs/architecture.md
Se API-specifikation: ./docs/api-spec.yaml

Pro-tips

1. Hall den kort: Under 500 rader. Claude laser allt varje gang, sa onodigt innehall slösar kontext-tokens.

2. Var specifik: "Anvand TypeScript" ar for vagt. "Anvand TypeScript strict mode med explicit returtyper pa alla publika funktioner" ar bra.

3. Inkludera exempel: Visa hur en typisk komponent eller API-route ser ut i ditt projekt.

4. Uppdatera regelbundet: CLAUDE.md ska vara ett levande dokument. Nar teamet fattar nya beslut, uppdatera filen.

5. Anvand /memory: Claude Code har ett inbyggt minnessystem. Nar du sager "kom ihag att vi bestamde att anvanda Zod for validering", sparar Claude detta i sin projektminnesfil. Dessa minnen laddas aven vid start.