Ohje

Näin kirjoitat CLAUDE.md-tiedoston Claude Codelle

Jokainen Claude Code -istunto alkaa tyhjällä kontekstilla, joten päädyt toistamaan samat build-komennot ja talon säännöt yhä uudelleen. CLAUDE.md-tiedosto ratkaisee tämän. Tämä ohje kertoo, mihin tiedosto kuuluu, mitä siihen kirjoitetaan ja miten tarkistat, että Claude todella lukee sen.

Päivitetty 30. lokakuuta 2026

Lyhyesti: CLAUDE.md on tavallinen Markdown-tiedosto, jonka Claude Code lataa jokaisen istunnon alussa. Laita projektin tiedosto polkuun ./CLAUDE.md (tai ./.claude/CLAUDE.md), aja /init, niin Claude luonnostelee sen koodisi perusteella, ja karsi se sitten komentoihin, käytäntöihin ja sääntöihin, joita Claude ei voi arvata, mieluiten alle 200 riviin.

Alla olevat sijainnit ja komennot tarkistettiin Anthropicin Claude Code -dokumentaatiota vasten lokakuussa 2026. Jos jotain puuttuu omasta versiostasi, aja claude update.

Missä CLAUDE.md-tiedostot sijaitsevat

Tiedostoja voi olla useita, ja kullakin on eri ulottuvuus. Claude Code yhdistää ne kaikki sen sijaan, että yksi korvaisi toisen; tarkemmin rajatut luetaan viimeisinä.

Tiedosto	Koskee	Tyypillinen sisältö
`~/.claude/CLAUDE.md`	Sinua, kaikissa projekteissa	Henkilökohtainen tyyli ja työkalumieltymykset
`./CLAUDE.md` tai `./.claude/CLAUDE.md`	Kaikkia projektissa (commitoi se)	Build- ja testikomennot, arkkitehtuuri, käytännöt
`./CLAUDE.local.md`	Vain sinua, tässä projektissa	Omat sandbox-URL:t ja testidata; lisää se tiedostoon `.gitignore`
Hallinnoitu käytäntötiedosto (IT:n asettama)	Kaikkia organisaatiossa	Yrityksen standardit ja vaatimustenmukaisuusmuistutukset

Kansiossa, josta käynnistät Clauden, ja jokaisessa sen yläpuolisessa kansiossa olevat tiedostot latautuvat käynnistyksessä. Alikansion CLAUDE.md latautuu myöhemmin, kun Claude lukee tai muokkaa tiedostoa siinä alikansiossa.

Luo tiedosto komennolla /init

Avaa pääte projektin juurikansiossa ja käynnistä claude.
Kirjoita /init. Claude käy koodikannan läpi ja kirjoittaa alustavan CLAUDE.md-tiedoston löytämillään build-komennoilla, testiohjeilla ja käytännöillä. Jos CLAUDE.md on jo olemassa, se ehdottaa parannuksia sen sijaan, että kirjoittaisi tiedoston yli.
Lue luonnos ja poista kaikki itsestäänselvä tai väärä.
Lisää se, mitä Claude ei voi päätellä koodista: päätökset, ympäristön erikoisuudet ja ”älä koskaan tee X” -säännöt.
Commitoi tiedosto, jotta tiimikaverit saavat samat ohjeet.

Myöhempiä muokkauksia varten aja /memory. Se listaa käyttäjä- ja projektitason CLAUDE.md- ja CLAUDE.local.md-sijaintisi, myös ne, joita ei vielä ole olemassa, ja avaa valitsemasi tiedoston editorissasi. Voit myös vain sanoa add this to CLAUDE.md (lisää tämä CLAUDE.md-tiedostoon).

Mitä tiedostoon kirjoitetaan

Yksinkertainen testi: jos olet joutunut kertomaan Claudelle jotain kahdesti, se kuuluu tiedostoon. Tyypillisiä hetkiä lisätä rivi: Claude toistaa virheen, koodikatselmointi löytää jotain, mikä sen olisi pitänyt tietää, tai kirjoitat saman korjauksen kuin edellisessä istunnossa.

Komennot: miten projekti buildataan, testataan, lintataan ja ajetaan.
Rakenne: missä keskeinen koodi on, esimerkiksi API-käsittelijät ovat kansiossa src/api/handlers/.
Käytännöt: nimeäminen, muotoilu, haara- ja commit-säännöt.
Kantapään kautta opitut asiat: asiat, jotka kompastuttaisivat uuden tiimikaverin.

Kirjoita sääntöjä, joiden noudattamisen voi tarkistaa. Aja npm test ennen committia toimii paremmin kuin testaa muutoksesi. Ryhmittele rivit otsikoiden ja luettelomerkkien alle ja poista toistensa kanssa ristiriidassa olevat ohjeet, koska Claude saattaa noudattaa kumpaa tahansa. Monivaiheiset menettelyt tai vain yhtä koodikannan osaa koskevat säännöt kuuluvat sen sijaan skilliin tai polkukohtaiseen sääntöön.

Pidä se lyhyenä ja järjestyksessä

Koko: tavoittele alle 200 riviä tiedostoa kohden. Pidemmät tiedostot vievät enemmän kontekstia, ja niitä noudatetaan epäluotettavammin.
Tuonnit: kirjoita @README tai @docs/git-instructions.md tuodaksesi toisen tiedoston mukaan. Polut ovat suhteessa CLAUDE.md-tiedostoon, ja tuonteja voi ketjuttaa enintään neljä tasoa. Tuodut tiedostot kuluttavat silti kontekstia, joten tämä auttaa järjestyksessä, ei koossa. Kun projekti tuo ensimmäistä kertaa tiedoston kansion ulkopuolelta, Claude Code pyytää sinua hyväksymään sen.
Sääntökansio: laita aihekohtaiset tiedostot, kuten testing.md, kansioon .claude/rules/. Lisää alkuun paths-kenttä (esimerkiksi src/api/**/*.ts), niin sääntö latautuu vain, kun Claude työskentelee vastaavien tiedostojen parissa.
Tarkastus: uusissa versioissa /doctor prompt-audit pyytää Claudea etsimään vanhentuneita tai ristiriitaisia ohjeita ja ehdottamaan muutoksia muuttamatta mitään ennen kuin annat luvan.

CLAUDE.md vai automaattinen muisti

Claude Code pitää myös omia muistiinpanojaan, joita kutsutaan automaattiseksi muistiksi (auto memory). Sinä kirjoitat CLAUDE.md-tiedoston; Claude kirjoittaa automaattisen muistin korjaustesi ja mieltymystesi perusteella. Se tallennetaan repositoriokohtaisesti polkuun ~/.claude/projects/<project>/memory/, ja sen MEMORY.md-hakemiston 200 ensimmäistä riviä (tai 25 kt) latautuu jokaiseen istuntoon. Se pysyy koneellasi eikä jakaudu gitin kautta. Kun sanot remember to always use pnpm (muista käyttää aina pnpm:ää), se menee automaattiseen muistiin; ominaisuuden saa päälle tai pois komennon /memory kytkimellä. Käytä CLAUDE.md-tiedostoa kaikkeen, mikä koko tiimin pitää saada.

Hyvä tietää

Claude Code sisältyy Pro- ja Max-paketteihin osana samaa tilausta kuin Claude-sovellukset; Team- ja Enterprise-jäsenille on oma ohjeartikkelinsa.
CLAUDE.md ohjaa toimintaa mutta ei pakota sitä. Estä komentoja tai tiedostoja asetusten käyttöoikeussäännöillä.
Projektin juuren CLAUDE.md luetaan levyltä uudelleen komennon /compact jälkeen, joten siellä olevat säännöt kestävät pitkätkin istunnot, kun taas pelkästään chattiin kirjoitetut säännöt voivat kadota. Alikansioiden tiedostot ja polkukohtaiset säännöt palaavat, kun Claude koskee taas vastaaviin tiedostoihin.
Valitsimella --add-dir lisättyjen kansioiden tiedostoja ei ladata, ellet aseta CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1.

Jos se ei toimi

Claude ei noudata ohjetta. Aja /context ja katso kohtaa Memory files (muistitiedostot). Jos tiedosto ei ole listalla, Claude ei näe sitä: tarkista tiedoston nimi ja että käynnistit Clauden oikeassa kansiossa.
Sääntöjä noudatetaan vain osan ajasta. Tee niistä tarkempia, poista ristiriidat muiden CLAUDE.md- tai sääntötiedostojen kanssa ja lyhennä tiedostoa.
Tuonti ei lataudu. Välilyöntejä sisältävässä polussa jokaisen välilyönnin eteen tarvitaan kenoviiva, lainausmerkeissä olevaa polkua ei tuoda ja gravis-merkkien sisällä oleva polku jää kirjaimelliseksi. Projektin ulkopuolelta tuotavat tiedostot tarvitsevat kertaluonteisen hyväksyntäsi.
Alikansion CLAUDE.md tuntuu puuttuvan. Se latautuu vasta, kun Claude koskee johonkin tiedostoon siinä alikansiossa.

Pidä päätökset ja tehtävät tiedoston ulkopuolella

CLAUDE.md on pysyviä sääntöjä varten, ei tämän viikon avoimia tehtäviä varten. Workbranch-lisäosa Claude Codelle hoitaa sen osan: aja /workbranch:save, niin Claude tallentaa istunnon tehtävät, päätökset ja avoimet kysymykset Workbranch-projektiin, ja kun istunto alkaa Workbranch-projektiin linkitetyssä kansiossa, lisäosa näyttää, mikä siellä on vielä auki. Kokeile 3 päivää ilmaiseksi osoitteessa app.workbranch.ai.

Lähteet

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

Usein kysytyt kysymykset

Onko Clauden pakko totella CLAUDE.md-tiedostoa?

Ei. Anthropic kuvaa sitä kontekstiksi, ei pakottavaksi asetukseksi. Jos jotain ei saa tapahtua koskaan, esimerkiksi komento pitää estää, käytä sen sijaan permission deny -sääntöä tai PreToolUse-hookia.

Voinko kirjoittaa CLAUDE.md-tiedostoon muistiinpanoja, joita Claude ei lue?

Kyllä. Lohkotason HTML-kommentit poistetaan ennen kuin tiedosto lähetetään Claudelle, joten voit jättää ylläpitäjille muistiinpanoja kuluttamatta kontekstia.

Repositoriossani on jo AGENTS.md. Tarvitsenko molemmat?

Et. Jos kansiossa tai sen yläpuolella ei ole CLAUDE.md-tiedostoa, Claude Coden uudet versiot lukevat sen sijaan AGENTS.md-tiedoston. Jos sinulla on molemmat, vain CLAUDE.md luetaan, ellet tuo AGENTS.md-tiedostoa siihen tai muuta Project instructions -asetusta komennolla /config.