Workbranch › Veiledninger

Slik skriver du en CLAUDE.md-fil for Claude Code

Hver Claude Code-økt starter med tom kontekst, så du ender opp med å gjenta de samme byggekommandoene og husreglene. En CLAUDE.md-fil løser det. Denne veiledningen viser hvor filen skal ligge, hva som hører hjemme i den, og hvordan du sjekker at Claude faktisk leser den.

Oppdatert 30. oktober 2026

Plasseringer og kommandoer nedenfor er sjekket mot Anthropics dokumentasjon for Claude Code per oktober 2026. Mangler noe i versjonen din, kjør claude update.

Hvor CLAUDE.md-filene ligger

Du kan ha flere filer, hver med sin rekkevidde. Claude Code slår dem sammen i stedet for å la én erstatte en annen; de mest spesifikke leses sist.

Filer i mappen du starter fra og i alle mapper over den lastes ved oppstart. En CLAUDE.md i en undermappe lastes senere, når Claude leser eller redigerer en fil i den undermappen.

Lag filen med /init

1. Åpne en terminal i prosjektets rotmappe og start claude.
2. Skriv /init. Claude går gjennom kodebasen og skriver en første CLAUDE.md med byggekommandoene, testinstruksjonene og konvensjonene den finner. Finnes det allerede en CLAUDE.md, foreslår den forbedringer i stedet for å overskrive den.
3. Les utkastet og slett alt som er opplagt eller feil.
4. Legg til det Claude ikke kan finne ut av koden: beslutninger, særheter i miljøet, «gjør aldri X»-regler.
5. Commit filen, så kollegene får de samme instruksjonene.

Vil du redigere senere, kjører du /memory. Den viser plasseringene for CLAUDE.md og CLAUDE.local.md på bruker- og prosjektnivå, også de som ikke finnes ennå, og åpner filen du velger i editoren din. Du kan også bare si legg dette til i CLAUDE.md.

Hva du bør skrive i den

En enkel test: har du måttet si noe til Claude to ganger, hører det hjemme i filen. Typiske øyeblikk for å legge til en linje: Claude gjentar en feil, en kodegjennomgang avdekker noe den burde ha visst, eller du skriver den samme rettelsen som i forrige økt.

• Kommandoer: hvordan prosjektet bygges, testes, lintes og kjøres.
• Struktur: hvor viktig kode ligger, for eksempel API-handlerne ligger i src/api/handlers/.
• Konvensjoner: navngivning, formatering, regler for brancher og commits.
• Dyrekjøpt erfaring: ting som ville felt en ny kollega.

Skriv regler som kan sjekkes. Kjør npm test før du committer fungerer bedre enn test endringene dine. Grupper linjene under overskrifter og punkter, og fjern instruksjoner som motsier hverandre, fordi Claude kan komme til å følge hvilken som helst av dem. Prosedyrer med flere steg eller regler som bare gjelder én del av kodebasen hører heller hjemme i en skill eller en sti-avgrenset regel.

Hold den kort og ryddig

• Størrelse: sikt mot under 200 linjer per fil. Lengre filer tar mer kontekst og følges mindre pålitelig.
• Importer: skriv @README eller @docs/git-instructions.md for å hente inn en annen fil. Stiene er relative til CLAUDE.md-filen, og importer kan nøstes opptil fire nivåer. Importerte filer koster fortsatt kontekst, så dette hjelper på ryddigheten, ikke på størrelsen. Første gang et prosjekt importerer en fil fra utenfor mappen, ber Claude Code deg godkjenne det.
• Regelmappe: legg temafiler som testing.md i .claude/rules/. Legg til et paths-felt øverst (for eksempel src/api/**/*.ts), så lastes regelen bare når Claude jobber med filer som passer.
• Gjennomgang: i nyere versjoner ber /doctor prompt-audit Claude se etter utdaterte eller motstridende instruksjoner og foreslå endringer, uten å endre noe før du sier ja.

CLAUDE.md og auto memory

Claude Code fører også egne notater, kalt auto memory. Du skriver CLAUDE.md; Claude skriver auto memory ut fra rettelsene og preferansene dine. Den ligger per repositorium i ~/.claude/projects/<project>/memory/, med en MEMORY.md-indeks der de første 200 linjene (eller 25 KB) lastes inn i hver økt. Den blir på maskinen din og deles ikke via git. Sier du husk å alltid bruke pnpm, havner det i auto memory; slå funksjonen av eller på med bryteren i /memory. Bruk CLAUDE.md til alt hele teamet skal ha.

Greit å vite

• Claude Code følger med Pro- og Max-planene, som en del av det samme abonnementet som Claude-appene; for medlemmer av Team og Enterprise finnes en egen hjelpeartikkel.
• CLAUDE.md styrer oppførselen, men håndhever den ikke. Blokker kommandoer eller filer med tillatelsesregler i innstillingene.
• CLAUDE.md i prosjektroten leses på nytt fra disk etter /compact, så regler som står der overlever lange økter, mens regler du bare skrev i chatten kan gå tapt. Filer i undermapper og sti-avgrensede regler kommer tilbake når Claude rører filer som passer igjen.
• Filer i mapper lagt til med --add-dir lastes ikke, med mindre du setter CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1.

Hvis det ikke fungerer

• Claude overser en instruksjon. Kjør /context og se under Memory files. Står ikke filen der, ser ikke Claude den: sjekk filnavnet og at du startet Claude i riktig mappe.
• Reglene følges bare noen ganger. Gjør dem mer spesifikke, fjern konflikter med andre CLAUDE.md- eller regelfiler, og gjør filen kortere.
• En import lastes ikke. En sti med mellomrom trenger en omvendt skråstrek foran hvert mellomrom, en sti i anførselstegn importeres ikke, og en sti i backticks blir stående som tekst. Importer fra utenfor prosjektet krever at du godkjenner dem én gang.
• CLAUDE.md i en undermappe ser ut til å mangle. Den lastes først når Claude rører en fil i den undermappen.

Hold beslutninger og gjøremål utenfor filen

CLAUDE.md er for varige regler, ikke for denne ukens åpne oppgaver. Workbranch-pluginen for Claude Code tar seg av den delen: kjør /workbranch:save, så legger Claude øktens oppgaver, beslutninger og åpne spørsmål inn i et Workbranch-prosjekt, og når en økt starter i en mappe som er koblet til et Workbranch-prosjekt, viser pluginen hva som fortsatt er åpent der. Det er en gratis prøveperiode på 3 dager på app.workbranch.ai.

Kilder

• How Claude remembers your project (Claude Code Docs, sjekket 30. oktober 2026)
• Commands (Claude Code Docs, sjekket 30. oktober 2026)
• Use Claude Code with your Pro or Max plan (Claude Help Center, sjekket 30. oktober 2026)

Vanlige spørsmål