Hver ny økt starter likt. Du forklarer at prosjektet bruker Prisma, at dere kjører lint før commit, at komponentene ligger under components og ikke skal ha inline styles. Claude gjør en god jobb, og neste morgen har den glemt alt. Ikke fordi noe er galt, men fordi Claude Code ikke har noe minne av seg selv. Den vet bare det som ligger i konteksten akkurat nå.
CLAUDE.md er svaret på det. Det er en fil der du gir Claude faste instruksjoner og kunnskap om prosjektet ditt, og den lastes inn i starten av hver eneste økt. Fra første melding vet Claude hvordan prosjektet er bygget opp, hvilke kommandoer som brukes, hvilke konvensjoner dere følger og hva den skal passe ekstra godt på.
Slik lastes CLAUDE.md inn
Starter du Claude Code fra roten av prosjektet, leses prosjektets CLAUDE.md automatisk, enten den ligger i roten eller inne i mappen .claude. Begge plasseringene er riktige. Innholdet legges i kontekstvinduet sammen med systeminstruksjonene, før du har skrevet et ord.
Et prosjekt kan ha flere CLAUDE.md-filer. En fil som ligger lenger ned, for eksempel i docs/design, lastes ikke ved oppstart. Den kommer inn når Claude begynner å jobbe med filer i den delen av prosjektet. Slik kan du ha generell prosjektkunnskap høyt oppe og spesifikke instruksjoner nær området de gjelder, uten at alt ligger i konteksten hele tiden.
Lag den første med /init
Har du ingen CLAUDE.md, lager Claude Code et utgangspunkt for deg:
- Start en ny økt i prosjektet.
- Skriv en skråstrek, velg /init og send.
- Claude utforsker prosjektet og ser hva som ligger der fra før. Finnes det ingen CLAUDE.md, oppretter den filen. Finnes den, foreslår den endringer.
- Åpne Source Control i Visual Studio Code og klikk på CLAUDE.md. En U betyr at filen er ny, en M at den er endret. Grønt er lagt til, rødt er fjernet.
- Les gjennom, og fjern det du ikke trenger.
Resultatet er typisk noen linjer om kommandoer, arkitektur og konvensjoner. Det er et startpunkt, ikke en ferdig fil. Etter hvert som du blir kjent med hvordan Claude bruker den, endrer du selv, eller ber Claude gjøre det for deg.
Hva som hører hjemme i filen
Målet er ikke mest mulig informasjon. Det er prosjektkunnskap Claude faktisk har nytte av, igjen og igjen. Det som pleier å fortjene plass:
- Hvordan prosjektet er bygget opp, og hvor de viktigste delene ligger.
- Kommandoene dere bruker til å kjøre, teste og bygge.
- Konvensjoner: navngivning, komponentstruktur, hva som aldri skal gjøres.
- Ting Claude har gått feil på før, og som du vil unngå å rette én gang til.
Alt som bare gjelder én mappe, hører hjemme i en CLAUDE.md i den mappen. Alt som er et engangstilfelle, hører hjemme i oppgaven, ikke i filen.
Referer til andre filer med alfakrøll
Noen ganger vil du at en fil nede i prosjektet skal lastes hver gang likevel. I kurset ligger designspråket i docs/design/CLAUDE.md, med palett, typografi og komponentregler. Roten peker til den med en linje som «before building or changing any UI, read @docs/design/CLAUDE.md». Alt som refereres med alfakrøll fra rotfilen, lastes inn sammen med den. Slik holder du rotfilen kort, men får likevel med det som alltid skal være der.
Hold personlige instruksjoner lokalt
Jobber flere på prosjektet, bør CLAUDE.md sjekkes inn i Git, så alle får de samme instruksjonene. Men du har sikkert preferanser som bare gjelder deg. Dem legger du i en fil som heter CLAUDE.local.md, ved siden av den vanlige. Den leses på samme måte, men skal ikke committes.
Tips: Be Claude Code legge CLAUDE.local.md inn i .gitignore med en gang du lager den. Da blir den aldri med i en commit ved et uhell.
Én huskeregel for plassering
Generell kunnskap høyt i prosjektet. Personlig kunnskap lokalt for deg. Spesifikk kunnskap nær området det gjelder. Følger du den regelen, får Claude mer av det den trenger når den trenger det, og mindre av det som ikke er relevant.
Filen blir aldri helt ferdig
En CLAUDE.md er ikke ferdig den dagen du oppretter den. Etter hvert som du jobber, oppdager du nye ting Claude bør vite, og gamle instruksjoner blir utdaterte. Sett av tid til å gå tilbake, og gjør det til en vane å legge inn en linje hver gang Claude gjør samme feil to ganger. Det er den billigste forbedringen du kan gjøre i hele oppsettet.
Neste steg
CLAUDE.md er den faste delen av konteksten. Resten av kontekstvinduet, hva som fyller det og hvordan du holder det ryddig, er tema i Kontekst og minne i Claude Code. Blir instruksjonene mange, kan du dele dem opp i rules og skills, som Slik lager du din egen skill i Claude Code viser. Og skriver du oppgaver som utnytter at Claude allerede kjenner prosjektet, får du mer igjen for hver linje i filen, se Slik skriver du gode oppgaver til Claude Code.
Denne videoen er hentet fra kurset Claude Code – komplett guide på Utdannet.no. I det fulle kurset lager du flere CLAUDE.md-filer for ulike deler av et Next.js-prosjekt, lærer forskjellen på prosjektinstruksjoner og Claudes eget minne, og skriver til slutt din egen prosjektfil i en praktisk oppgave.
