CLAUDE.md

CLAUDE.md är den enskilt viktigaste filen i ett Claude Code-projekt. Det är en Markdown-fil i projektets rot som Claude läser VARJE gång den startar. Tänk på den som en briefing till en ny teammedlem – fast den här teammedlemmen läser den på 0,1 sekunder och följer instruktionerna till punkt och pricka.

Tre nivåer av CLAUDE.md

Det som många inte vet är att det finns tre separata platser för CLAUDE.md, och alla tre läses och kombineras:

1. Projekt-CLAUDE.md (mest använd)

Placera i projektets rot: ./CLAUDE.md

Denna committas till git och delas med hela teamet. Innehåller projektspecifika instruktioner.

2. Användare-CLAUDE.md (personlig)

Placera i: ~/.claude/CLAUDE.md

Gäller för ALLA dina projekt. Perfekt för personliga preferenser:

- Svara alltid på svenska
- Använd funktionell programmeringsstil
- Preferera explicit typning över inferens

3. Företags-CLAUDE.md

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

För projekt-specifika personliga anteckningar som du INTE vill committa.

Vad ska stå i CLAUDE.md?

En bra CLAUDE.md har fyra sektioner:

Projektbeskrivning

# Projektnamn
En SaaS-plattform för fastighetsförvaltning 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`: öppna databas-UI

Regler och begränsningar

## Regler
- Ändra ALDRIG filer i /generated/
- Kör alltid `npm run lint` efter kodändringar
- Alla nya API-routes MÅSTE ha autentisering
- Använd INTE any-typen

AGENTS.md: för sub-agenter

En relaterad fil är AGENTS.md, som specificerar regler just för sub-agenter. Om du använder Claude Codes sub-agent-system (mer om detta i en senare lektion) kan du ha separata instruktioner för dem.

Du kan även använda @AGENTS.md som en referens inifrån CLAUDE.md för att dela upp innehållet.

Dynamiskt innehåll

Ett kraftfullt trick: CLAUDE.md kan referera till andra filer med relativa sökvägar. Claude kommer att läsa dem:

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

Pro-tips

1. Håll den kort: Under 500 rader. Claude läser allt varje gång, så onödigt innehåll slösar kontext-tokens.

2. Var specifik: "Använd TypeScript" är för vagt. "Använd TypeScript strict mode med explicita returtyper på alla publika funktioner" är 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. När teamet fattar nya beslut, uppdatera filen.

5. Använd /memory: Claude Code har ett inbyggt minnessystem. När du säger "kom ihåg att vi bestämde att använda Zod för validering", sparar Claude detta i sin projektminnesfil. Dessa minnen laddas även vid start.