CLAUDE.md är en vanlig textfil i markdown som Claude Code läser i början av varje session. Där skriver du det du annars hade fått förklara igen: hur projektet byggs, vilka regler som gäller och var saker ligger. Anthropic rekommenderar under 200 rader per fil. Min egen är 450 rader, och den här guiden visar både hur det ska göras och vad jag lärt mig av att inte riktigt göra så.
Varför filen behövs
Varje session i Claude Code börjar med ett tomt minne. Allt Claude ska veta om ditt projekt måste antingen gå att läsa ut ur koden eller stå någonstans där Claude läser det automatiskt. CLAUDE.md är det stället.
Enligt Anthropics dokumentation ska något in i CLAUDE.md när:
- Claude gör samma misstag en andra gång.
- Du skriver samma rättelse i chatten som du skrev förra sessionen.
- En ny medarbetare skulle behöva samma bakgrund för att komma igång.
Ett bra sätt att tänka: skriv filen som introduktionen till en ny kollega som är snabb men aldrig varit på ditt företag.
Var CLAUDE.md ska ligga
Det finns fyra platser, från bredast till smalast. Claude läser dem i den ordningen, så en projektregel hamnar efter en personlig regel.
| Nivå | Var filen ligger | Till vad | Delas med |
|---|---|---|---|
| Organisation | Windows: C:\Program Files\ClaudeCode\CLAUDE.md, macOS och Linux: en systemmapp | Regler som IT bestämmer för alla | Alla i organisationen |
| Personlig | ~/.claude/CLAUDE.md i din hemkatalog | Dina egna vanor i alla projekt | Bara dig |
| Projekt | ./CLAUDE.md eller ./.claude/CLAUDE.md i projektets rot | Hur just det här projektet byggs och fungerar | Alla som har repot |
| Lokal | ./CLAUDE.local.md, som du lägger i .gitignore | Dina egna inställningar för projektet | Bara dig |
Källa: Anthropics dokumentation för Claude Code, sidan How Claude remembers your project, läst 2026-10-14.
För ett soloföretag räcker oftast två: en personlig fil med hur du vill ha det överallt, och en projektfil per repo.
Kom igång på fem minuter
- Öppna terminalen i projektets mapp och starta Claude Code med
claude. - Skriv
/init. Claude går igenom kodbasen och skriver ett första utkast med byggkommandon, tester och konventioner. Finns filen redan föreslår/initförbättringar i stället för att skriva över den. - Läs utkastet och stryk det som är självklart ur koden.
- Lägg till det Claude inte kan räkna ut själv: dina regler, dina beslut och dina ord för saker.
- Skriv
/contexti en ny session och kontrollera att filen står under Memory files.
Skriv regler som går att kontrollera
Claude läser CLAUDE.md som sammanhang, inte som tvingande inställningar. Hur du formulerar dig avgör hur ofta reglerna följs. Den viktigaste tumregeln är att en regel ska gå att kontrollera.
| Vag | Går att kontrollera |
|---|---|
| Testa dina ändringar | Kör npm run build innan du committar |
| Håll ordning på filerna | Verktygen ligger i src/pages/verktyg/ |
| Skriv bra svenska | Använd aldrig tankstreck som skiljetecken |
| Var noggrann med fakta | Varje tal ska ha sin källa i samma meddelande |
Tre saker till från dokumentationen:
- Rubriker och punktlistor. Grupperade regler följs bättre än långa stycken.
- Inga motsägelser. Står två regler emot varandra kan Claude välja vilken som helst.
- Ett stopp kräver en hook. Ska något aldrig få hända, oavsett vad Claude tycker, räcker inte en rad i CLAUDE.md. Då behövs en hook som stoppar verktygsanropet.
Ett exempel för en liten webbplats
Så här kan projektfilen se ut för en Astro-sajt som den du läser nu:
# Solopreneur.se
Statisk Astro-sajt på Cloudflare Pages. Push till main publicerar.
## Bygga och testa
- `npm run dev` startar lokalt på port 4321.
- `npm run build` bygger och kör SEO-kontrollen. Ett fel stoppar publiceringen.
## Innehåll
- Inlägg i `src/data/blog/`, guider i `src/data/guider/`, markdown med frontmatter.
- Titeltaggen högst 60 tecken; använd `seoTitle` när rubriken är längre.
- Ändra `modDatetime` bara vid sakändring.
## Skrivregler
- Svenska med å, ä och ö. Inga tankstreck som skiljetecken.
- Hitta aldrig på fakta. Belopp och regler från Skatteverket anges med källa och datum.Det är 15 rader, och varje rad är något Claude annars hade gissat fel på.
Så ser min egen ut, och varför den är för lång
Min CLAUDE.md, som gäller alla mina repon, är 450 rader och 35 593 byte. Det är mer än dubbelt så långt som Anthropics rekommendation på 200 rader. Flera av reglerna har tillkommit efter ett konkret misstag och bär datum och skäl, så att det går att se varför de finns.
Den är indelad i fem delar:
- Obligatoriska arbetsregler. Till exempel att söka i dokumentationen innan något görs, att använda de kopplingar som redan finns i stället för att bygga egna, och att ett tal som går in i ett beslut ska ha sin källa i samma meddelande.
- Skrivregler. Hur texter ska se ut, bland annat inga tankstreck som skiljetecken.
- Bokföringsregler för redovisningsbyrån, till exempel hur moms på köp från utlandet bokförs.
- En översikt över repona och vad som ligger var.
- Färger och varumärke per produkt.
Det som håller den från att bli ännu längre är att det mesta inte står i den:
- Dokumentationen ligger utanför. Ett register med 769 dokument har ett sökindex med en rad per dokument. CLAUDE.md säger bara att Claude ska söka där först och läsa det dokument som träffar, aldrig hela registret.
- Lärdomarna ligger i minnet. Claude Codes automatiska minne har hos mig ett index på 87 rader och 243 korta anteckningar, en per sak Claude lärt sig om hur jag vill ha det.
- Återkommande flöden är skills. Ett flöde i många steg, som att rapportera rutinläget, är en skill som laddas när den behövs, inte text som läses i varje session.
Anthropics råd för en lång fil är att flytta det som bara gäller en del av kodbasen till regler i .claude/rules/, som bara laddas när Claude arbetar med de filerna, och att låta /doctor prompt-audit leta efter föråldrade och motsägande instruktioner.
CLAUDE.md eller AGENTS.md?
AGENTS.md är ett filnamn som flera AI-verktyg läser. Claude Code kan läsa ett repos AGENTS.md i stället för CLAUDE.md. Använder du bara Claude Code finns ingen anledning att byta; använder du flera verktyg på samma repo kan AGENTS.md spara dig från att hålla två filer i takt.
Vanliga frågor
Vad är CLAUDE.md?
En markdownfil med instruktioner som Claude Code läser i början av varje session. Den ligger i projektets rot, i din hemkatalog eller båda, och innehåller det Claude inte kan räkna ut ur koden.
Hur lång ska CLAUDE.md vara?
Anthropic rekommenderar under 200 rader per fil. Längre filer tar mer av sammanhanget och följs sämre. Det som bara gäller en del av projektet flyttas till regler i .claude/rules/ eller till skills.
Hur skapar jag en CLAUDE.md?
Skriv /init i Claude Code. Claude läser kodbasen och skriver ett utkast som du sedan kortar och kompletterar med dina egna regler.
Följer Claude alltid det som står i CLAUDE.md?
Nej. Filen är sammanhang, inte tvingande inställningar. Konkreta regler som går att kontrollera följs oftare. Det som aldrig får hända stoppas med en hook.