Hva er CLAUDE.md?

I En agent i en mappe sa vi at gjør du bare en ting, bør det være å gi mappen instruksjoner. I Claude Code gjør du det med en CLAUDE.md i roten av mappen. Spørsmålet vi da får på kursene, er hva som skal stå i den og hvor mye. Her svarer vi på begge delene.

Hva filen gjør

Hver økt i Claude Code starter med blanke ark, uten det du sa i forrige økt. Alt Claude bør vite om arbeidet ditt, og som den ikke ser ved å lese mappen, hører hjemme i CLAUDE.md.

Tenk på det som lappen du ville lagt igjen til en flink ny kollega på første arbeidsdag.

Hvor filen ligger

Det kan finnes flere CLAUDE.md-filer, og Claude Code leser alle (Anthropic, How Claude remembers your project).

Prosjektfilen i roten av mappen er den teamet deler, og det er den guiden handler mest om. Din egen fil i ~/.claude/ gjelder alle prosjektene dine, og IT kan legge inn en fil for hele organisasjonen på hver maskin.

En CLAUDE.md i en undermappe leses når Claude jobber i den mappen. Personlige notater om ett prosjekt legger du i CLAUDE.local.md. Den er bare for deg, så du må be Claude holde den utenfor filene teamet deler.

Code-fanen i desktopappen leser de samme filene. Jobber du i en lokal mappe i Claude Cowork, leser Claude også en CLAUDE.md der, og mappeinstruksjonene i Customize gjør den samme jobben.

Hva du skriver i den

Her er en CLAUDE.md for en mappe der Claude hjelper deg med en månedsrapport til investeringskomiteen.

Skriv hver linje så den kan sjekkes. «Prosent med en desimal» kan sjekkes, mens «Hold tallene ryddige» ikke kan det. Du trenger ikke skrive filen selv. /init lager et raskt første utkast, og denne prompten gir deg de fem overskriftene våre.

DuKopier

Skriv en CLAUDE.md for denne mappen med fem overskrifter, hva mappen er til, kilder, konvensjoner, sjekker og grenser, og hvor ting ligger. Spør meg om det du ikke ser i filene.

Hvor lang den bør være

Anthropic anbefaler å holde hver CLAUDE.md under 200 linjer. En lengre fil tar mer av det Claude kan holde i hodet i en økt, og da følger Claude den dårligere. Ignorerer Claude en regel gang på gang, er det ofte fordi filen er for lang. Det hjelper sjelden å skrive IMPORTANT eller bruke store bokstaver.

Den beste måten å forbedre filen på er å be Claude gjøre det. Claude kan lese hele filen opp mot mappen og peke på linjer som er uklare, utdaterte eller motsier hverandre, og linjer om ting den ser selv.

DuKopier

Sjekk om CLAUDE.md er satt opp optimalt for det vi jobber med i denne mappen.

Les forslagene før du godtar dem. En linje Claude vil kutte, kan være en som bare du vet er riktig.

Legg detaljene i andre filer

CLAUDE.md trenger ikke å romme alt. Den kan fungere som et kart, med en linje for hver lengre instruksjon i mappen som sier når Claude skal lese den.

En linje kan også vise til et script, et lite program Claude kjører for å sjekke sitt eget arbeid, for eksempel at summene i tabellene stemmer. Et script gir samme svar hver gang. Det skriver vi mer om i Deterministisk og ikke-deterministisk AI.

Setter du @ foran et filnavn, som i @docs/rapportstil.md, leser Claude dokumentet i hver økt, så det teller med i lengden. Uten @ er filen ikke med i økten før Claude leser den til en oppgave.

Vår egen fil for denne nettsiden ble for lang før vi lærte dette. Nå har den noen harde regler og en tabell over hvor alt annet ligger.

DuKopier

Flytt de detaljerte instruksjonene i CLAUDE.md til egne filer. La det stå igjen en linje i CLAUDE.md for hver av dem, som sier når filen skal leses.

CLAUDE.md, minne, skills og hooks

CLAUDE.md er ett av fire steder der du kan legge det Claude Code skal vite.

Automatisk minne er det Claude noterer for seg selv, bare på din maskin. Sier du «husk at jeg foretrekker tabeller fremfor kulepunkter», havner notatet der. Sier du «legg dette inn i CLAUDE.md», havner det i filen teamet deler.

Skills inneholder fremgangsmåter for bestemte oppgaver, for eksempel kvartalsversjonen av rapporten. En hook er en sjekk som kjører hver gang, enten Claude husker regelen eller ikke. Du kan be Claude Code skrive en for deg.

DuKopier

Skriv en hook som stopper endringer i mappen data/exports.

CLAUDE.md og AGENTS.md

Andre AI-verktøy for koding, som OpenAIs Codex, Cursor og de fleste agentfunksjonene i GitHub Copilot, henter instruksjonene sine fra en fil som heter AGENTS.md. Bruker dere mer enn ett verktøy, skriver dere de felles instruksjonene en gang, i AGENTS.md.

Legg linjen @AGENTS.md inn i CLAUDE.md, så leser Claude Code den felles filen også. Det som bare gjelder Claude, skriver du under den linjen. Har en mappe en AGENTS.md og verken CLAUDE.md eller CLAUDE.local.md, leser Claude Code AGENTS.md automatisk.

Hva som endret seg med Opus 5.5

Noen av rådene om CLAUDE.md som ble skrevet for eldre modeller, gjelder ikke lenger. I Getting the most out of Opus 5.5, skrevet av Addy Osmani og publisert av Anthropic, gjelder tre av tipsene CLAUDE.md.

Opus 5.5 tenker alltid før den svarer og bestemmer selv hvor grundig, så linjer som ber den tenke, kan du stryke. På en lang oppgave stopper den av og til for å rapportere i stedet for å fortsette. Si når den skal stoppe og hvordan oppsummeringen til slutt skal se ut.

DuKopier

Legg til en regel i CLAUDE.md. Når et steg ikke trenger meg, fortsett. Stopp og spør bare når du ikke kommer videre uten meg, eller før du sletter eller overskriver noe.

Vi går gjennom alle tipsene i Anthropics tips for å jobbe med Claude Opus 5.5.

Hvordan filen blir bedre over tid

Tommelfingerregelen fra Anthropic er å legge til en linje når Claude gjør samme feil to ganger eller du skriver samme rettelse som i forrige økt.

De første linjene er enkle. I januar minner du Claude på at avkastningen er etter kostnader, i februar at tallene skal komme fra fondssystemet, ikke fra e-post, og i mars at Fond C har gått over til andelsklassen i EUR.

Senere linjer handler om hvordan du tenker. I april lærer Claude å begynne med hva som har endret seg, og hvorfor. I mai lærer den å bruke beholdningen til å forklare avvik på mer enn to prosentpoeng fra referanseindeksen. I juni trenger utkastet få rettelser.

Del filen gjennom git, så får hele teamet nytte av hver rettelse. Sett dato på hver beslutning, så ser den som leser senere, hvilken regel som er nyest.

Dette kaller vi AI-kapital, kunnskap et team skriver ned en gang og bruker om igjen. Den engelske guiden How to build AI capital forklarer mer.

Kom i gang

Åpne en mappe du jobber i, og skriv /init i Claude Code. Claude skriver da et første utkast eller foreslår forbedringer hvis filen finnes fra før.

Legg så til de to eller tre tingene du merker at du gjentar.

Avslutt hver arbeidsøkt med denne prompten, og les linjene Claude legger inn. En linje som er feil, følger med i hver økt etterpå.

DuKopier

Legg det vi lærte i dag inn i CLAUDE.md.

Når en del av filen blir til en fremgangsmåte, flytter du den til en skill. Det skriver vi om i Claude skills for deg, teamet og hele selskapet.