Guide

Så skriver du en CLAUDE.md-fil för Claude Code

Varje session i Claude Code börjar med en tom kontext, så du upprepar samma byggkommandon och husregler om och om igen. En CLAUDE.md-fil löser det. Den här guiden visar var filen ska ligga, vad som hör hemma i den och hur du kontrollerar att Claude faktiskt läser den.

Uppdaterad 30 oktober 2026

Snabbt svar: CLAUDE.md är en vanlig Markdown-fil som Claude Code läser in i början av varje session. Lägg en projektfil i ./CLAUDE.md (eller ./.claude/CLAUDE.md), kör /init så att Claude skriver ett utkast utifrån din kod, och korta sedan ned den till de kommandon, konventioner och regler som Claude inte kan gissa sig till, helst under 200 rader.

Platser och kommandon nedan har kontrollerats mot Anthropics dokumentation för Claude Code i oktober 2026. Saknas något i din version kör du claude update.

Var CLAUDE.md-filerna ligger

Du kan ha flera filer som gäller för olika områden. Claude Code slår ihop dem i stället för att låta en ersätta en annan; de mer specifika läses sist.

Fil	Gäller för	Typiskt innehåll
`~/.claude/CLAUDE.md`	Dig, i alla projekt	Personlig stil och val av verktyg
`./CLAUDE.md` eller `./.claude/CLAUDE.md`	Alla i projektet (committa den)	Bygg- och testkommandon, arkitektur, konventioner
`./CLAUDE.local.md`	Bara dig, i det här projektet	Dina sandbox-URL:er och testdata; lägg till den i `.gitignore`
Hanterad policyfil (sätts av IT)	Alla i organisationen	Företagets standarder och påminnelser om regelefterlevnad

Filer i mappen du startar från och i alla mappar ovanför den läses in vid start. En CLAUDE.md i en undermapp läses in senare, när Claude läser eller redigerar en fil i den undermappen.

Skapa filen med /init

Öppna en terminal i projektets rotmapp och starta claude.
Skriv /init. Claude går igenom kodbasen och skriver en första CLAUDE.md med de byggkommandon, testinstruktioner och konventioner den hittar. Finns det redan en CLAUDE.md föreslår den förbättringar i stället för att skriva över den.
Läs utkastet och stryk allt som är självklart eller fel.
Lägg till det som Claude inte kan upptäcka i koden: beslut, egenheter i miljön och regler av typen ”gör aldrig X”.
Committa filen så att dina kollegor får samma instruktioner.

För att redigera senare kör du /memory. Kommandot listar platserna för CLAUDE.md och CLAUDE.local.md för användare och projekt, även de som inte finns än, och öppnar filen du väljer i din editor. Du kan också helt enkelt säga add this to CLAUDE.md (lägg till det här i CLAUDE.md).

Vad du ska skriva i den

Ett enkelt test: har du behövt säga något till Claude två gånger hör det hemma i filen. Typiska tillfällen att lägga till en rad: Claude upprepar ett misstag, en kodgranskning hittar något som den borde ha vetat, eller du skriver samma rättelse som i förra sessionen.

Kommandon: hur projektet byggs, testas, lintas och körs.
Struktur: var viktig kod ligger, till exempel API-hanterarna ligger i src/api/handlers/.
Konventioner: namngivning, formatering, regler för brancher och commits.
Dyrköpta lärdomar: sådant som skulle sätta krokben för en ny kollega.

Skriv regler som går att kontrollera. Kör npm test innan du committar fungerar bättre än testa dina ändringar. Samla raderna under rubriker och punktlistor, och ta bort instruktioner som motsäger varandra, eftersom Claude kan följa vilken som helst av dem. Procedurer i flera steg eller regler som bara gäller en del av kodbasen hör i stället hemma i en skill eller en regel som är begränsad till vissa sökvägar.

Håll den kort och ordnad

Storlek: sikta på under 200 rader per fil. Längre filer tar mer kontext och följs mindre pålitligt.
Importer: skriv @README eller @docs/git-instructions.md för att dra in en annan fil. Sökvägarna är relativa till CLAUDE.md, och importer kan nästlas upp till fyra nivåer. Importerade filer kostar ändå kontext, så det hjälper ordningen, inte storleken. Första gången ett projekt importerar en fil utanför mappen ber Claude Code dig att godkänna det.
Regelmapp: lägg ämnesfiler som testing.md i .claude/rules/. Lägg till fältet paths överst (till exempel src/api/**/*.ts), så läses regeln bara in när Claude arbetar med matchande filer.
Granskning: i nyare versioner ber /doctor prompt-audit Claude att leta efter inaktuella eller motstridiga instruktioner och föreslå ändringar, utan att ändra något förrän du säger till.

CLAUDE.md jämfört med auto memory

Claude Code för också egna anteckningar, så kallat auto memory. Du skriver CLAUDE.md; Claude skriver auto memory utifrån dina rättelser och preferenser. Det sparas per repository i ~/.claude/projects/<project>/memory/, med ett register i MEMORY.md vars första 200 rader (eller 25 KB) läses in i varje session. Det stannar på din dator och delas inte via git. När du säger remember to always use pnpm (kom ihåg att alltid använda pnpm) hamnar det i auto memory; slå på eller av funktionen med reglaget i /memory. Använd CLAUDE.md för allt som hela teamet ska få.

Bra att veta

Claude Code ingår i Pro- och Max-planerna, i samma prenumeration som Claude-apparna; för medlemmar i Team och Enterprise finns en separat hjälpartikel.
CLAUDE.md styr beteendet men tvingar inte fram det. Blockera kommandon eller filer med behörighetsregler i inställningarna.
CLAUDE.md i projektets rot läses om från disken efter /compact, så regler som står där överlever långa sessioner, medan regler du bara skrev i chatten kan gå förlorade. Filer i undermappar och sökvägsbegränsade regler kommer tillbaka när Claude rör matchande filer igen.
Filer i mappar som lagts till med --add-dir läses inte in om du inte sätter CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1.

Om det inte fungerar

Claude ignorerar en instruktion. Kör /context och titta under Memory files (minnesfiler). Finns filen inte med kan Claude inte se den: kontrollera filnamnet och att du startade Claude i rätt mapp.
Reglerna följs bara ibland. Gör dem mer specifika, ta bort konflikter med andra CLAUDE.md- eller regelfiler och korta ned filen.
En import läses inte in. En sökväg med mellanslag behöver ett omvänt snedstreck före varje mellanslag, en sökväg inom citattecken importeras inte och en sökväg inom backticks tolkas bokstavligt. Importer utanför projektet kräver ditt godkännande en gång.
En undermapps CLAUDE.md verkar saknas. Den läses in först när Claude rör en fil i den undermappen.

Håll beslut och att göra-punkter utanför filen

CLAUDE.md är till för bestående regler, inte för veckans öppna uppgifter. Workbranch-pluginet för Claude Code tar hand om den delen: kör /workbranch:save så sorterar Claude in sessionens uppgifter, beslut och öppna frågor i ett Workbranch-projekt, och när en session startar i en mapp som är kopplad till ett Workbranch-projekt visar pluginet vad som fortfarande är öppet där. Det finns en gratis provperiod på 3 dagar på app.workbranch.ai.

Källor

How Claude remembers your project (Claude Code Docs, kontrollerad 2026-10-30)
Commands (Claude Code Docs, kontrollerad 2026-10-30)
Use Claude Code with your Pro or Max plan (Claude Help Center, kontrollerad 2026-10-30)

Vanliga frågor

Måste Claude följa CLAUDE.md?

Nej. Anthropic beskriver den som kontext, inte som konfiguration som tvingas fram. För något som aldrig får hända, till exempel ett kommando som måste blockeras, använder du i stället en deny-regel för behörigheter eller en PreToolUse-hook.

Kan jag ha anteckningar i CLAUDE.md som Claude inte läser?

Ja. HTML-kommentarer på blocknivå tas bort innan filen skickas till Claude, så du kan lämna anteckningar till dem som underhåller filen utan att de tar plats i kontexten.

Mitt repository har redan en AGENTS.md. Behöver jag båda?

Nej. Om det inte finns någon CLAUDE.md i mappen eller ovanför den läser nyare versioner av Claude Code AGENTS.md i stället. Har du båda läses bara CLAUDE.md, om du inte importerar AGENTS.md från den eller ändrar inställningen Project instructions i /config.