Claude Code on Anthropicu loodud terminali tööriist AIga programmeerimiseks. Selle tööriista üks võimsamaid funktsioone on CLAUDE.md konfiguratsioonifail, mida Claude loeb iga vestluse alguses ja mis annab talle konteksti sinu projekti kohta ja mis peamine, sinu soovide kohte. Hästi kirjutatud CLAUDE.md on nagu kogemustega kolleegi briifing uuele meeskonnaliikmele: lühike, täpne ja keskendub sellele, mida muidu poleks võimalik koodist välja lugeda. Claude.md areneb koos sinuga, sa lisad sinna töö käigus aina uusi nüansse.
Siit leiad, kuidas luua tõhus CLAUDE.md, mida sinna kirjutada, mida vältida ja kuidas seda aja jooksul paremaks muuta.
Misse on ja kusse käib?
CLAUDE.md on Markdown-vormingus fail, mis sisaldab juhiseid Claude Code’ile: käsuridu, koodistiili reegleid, töövoo juhiseid ja arhitektuurilisi otsuseid. Claude laadib selle faili automaatselt iga sessiooni alguses.
Faile saab paigutada kolmele tasemele ja Claude laadib need kõik hierarhiliselt:
Kasutajatase (~/.claude/CLAUDE.md) — isiklikud eelistused, mis kehtivad kõigis projektides. Näiteks sinu eelistatud koodistiil, tööriistad ja isiklikud tööharjumused. See on kõige tähtsam claude.md-dest.
Projektitase (./CLAUDE.md projekti juurkaustas) — meeskonnakokkulepped ja arhitektuurilised otsused. See fail tuleks lisada GITi, et kogu meeskond saaks sellest kasu. Kui ei soovi jgda, siis kasuta CLAUDE.local.md faili ja lisa see .gitignore nimekirja.
Alamkausta tase (alamkaustades olevad CLAUDE.md failid) — need laetakse nõudmisel, kui Claude töötab vastava kausta failidega. See on eriti kasulik monorepode puhul, kus erinevatel pakettidel on erinevad konventsioonid. Mina neid ei kasuta, või kui siis kogemata või erijuhul. Tean, et neid saab teha, aga pole veel vajadust tekkinud, ilmselt on minu projektid veel liiga väikesed.
Kiireim viis alustamiseks on käivitada /init, mis puhul genereerib Claude Code alg-CLAUDE.md sinu projekti struktuuri, testiraamistike ja ehitussüsteemide põhjal.
Mida CLAUDE.md-sse kirjutada
Hea CLAUDE.md sisaldab ainult seda, mida Claude ei suuda koodist ise välja lugeda. Iga rea puhul küsi endalt: “Kas selle rea eemaldamine põhjustaks Claude’il vigu?” Kui vastus on ei, siis kustuta see rida, kuna see võtab kontekstiakna väärtuslikku ruumi. See hoitakse kogu aeg kontekstis ja selle võrra on sul muu töö jaoks vähem ruumi.
Lisa kindlasti:
- Bash käsud, mida Claude ei oska arvata, kohandatud ehitusskriptid, juurutuskäsud, lintimise ja testide käivitamise käsud.
- Koodistiili reeglid, mis erinevad standardist. Kui sinu projektis kasutatakse ebatavalist importimismustrit või nimetamiskonventsiooni, siis kirjelda seda selgelt.
- Testimisjuhised ehk millist testiraamistikku kasutada, kuidas teste käivitada, millised testid peaksid alati läbima enne commiti.
- Repokonventsioonid. Harude nimetamine, commit-sõnumite formaat, PR-ide koostamise reeglid.
- Arhitektuurilised otsused, peamised disainivalikud, projekti struktuur, olulised sõltuvused ja nende vahelised seosed.
- Arenduskeskkonna eripärad, vajalikud keskkonnamuutujad, konfiguratsioonid ja levinud lõksud, millesse uus arendaja võib sattuda.
Ära lisa:
- Kõike, mida Claude suudab koodist ise välja lugeda: standardsed keelekonventsioonid, ilmsed mustrid ja enesestmõistetavad tavad nagu “kirjuta puhast koodi”.
- Pikki seletusi ja õpetusi: viita hoopis dokumentatsioonile. Näiteks kirjuta
Vaata @docs/api-guide.md API juhendi jaoksselle asemel, et kogu juhend CLAUDE.md-sse kopeerida. - Sageli muutuvat infot. Kui midagi muutub iga nädal, siis CLAUDE.md pole sellele õige koht.
- Tundlikku infot. Paroole, API võtmeid ja turvaaukude kirjeldusi EI TOHI CLAUDE.md-sse panna.
Struktuuri soovitused
Kindlat formaati pole ette kirjutatud, aga hea struktuur aitab nii Claude’il kui sinul endal hiljem infot kiiremini leida. Ära heitu, kui fail sisult keeruline tundub, sa ju saad ka claude.md kirjutamisel Claude Code abi kasutada. Siin on näidisstruktuur:
# Koodistiil
- Kasutame TypeScripti range režiimis
- Importimisjärjekord: standardteegid > välised > sisemised
- Nimetame muutujad camelCase, komponendid PascalCase
# Töövoog
- Testid: `bun run test`
- Lint: `bun run lint`
- Ehitamine: `bun run build`
- Käivita alati lint enne commiti
# Repo konventsioonid
- Harud: feature/lühikirjeldus, fix/lühikirjeldus
- Commit-sõnumid: imperatiivis, inglise keeles, max 72 tähemärki
# Arhitektuur
- Monorepo: packages/api, packages/web, packages/shared
- API: FastAPI + SQLAlchemy
- Frontend: Next.js + Tailwind
# Keskkond
- Node 20+, Python 3.11+
- Vajalikud env muutujad: DATABASE_URL, REDIS_URL
Saad kasutada ka failiviiteid, et hoida CLAUDE.md kompaktne:
Vaata @README.md projekti ülevaate jaoks.
Git töövoog: @docs/git-workflow.md
Optimaalne pikkus: lühike
See on kõige olulisem reegel: lühem on parem. Anthropicu enda soovitused:
- Parim: alla 200 rea
- Hea: alla 300 rea
- Aktsepteeritav: alla 500 rea
- Liiga pikk: üle 800 rea
Miks on pikkus nii oluline? Claude’i kontekstiaken on piiratud. Mida pikem on CLAUDE.md, seda vähem ruumi jääb tegeliku töö jaoks. Uuringud näitavad, et 32 000 tokeni juures langeb keelemudelite meenutamisvõime alla 50%. Pikk CLAUDE.md tähendab, et Claude hakkab juhiseid unustama ja ignoreerima.
Praktikas tähendab see, et 100-realine hästi kirjutatud CLAUDE.md annab sageli paremaid tulemusi kui 800-realine fail, mis üritab kõike katta.
Kui CLAUDE.md on paigas, proovi järgmise sammuna AI agendid võistlema panna, kus Claude käivitab kolm konkureerivat agenti ja kohtunik hindab, kelle lahendus on parim.
Monorepo strateegia
Monorepode puhul tasub kasutada mitmetasemelist struktuuri:
minu-monorepo/
├── CLAUDE.md # Jagatud: CI, juurutamine, ühised reeglid
├── packages/
│ ├── api/
│ │ └── CLAUDE.md # API-spetsiifilised konventsioonid
│ ├── web/
│ │ └── CLAUDE.md # Frontendi eripärad
│ └── shared/
│ └── CLAUDE.md # Jagatud teekide reeglid
Oluline teada hierarhia kohta: ülemkaustad laetakse kohe sessiooni alguses (Claude kõnnib kaustapuud ülespoole), naaberkaustad ei laeta (töötades frontend/ kaustas ei laeta backend/CLAUDE.md) ja alamkaustad laetakse nõudmisel. Konfliktide korral on spetsiifilisem (sügavamal asuv) fail prioriteetsem.
Kuidas CLAUDE.md-d aja jooksul parandada
CLAUDE.md pole staatiline dokument — see peaks arenema koos projektiga. Siin on mõned strateegiad pidevaks täiustamiseks.
Regulaarne ülevaatus. Iga paari nädala tagant palu Claude’il endal su CLAUDE.md üle vaadata ja parandusi soovitada. Aja jooksul kogunevad juhised — mõned muutuvad üleliigseks, teised hakkavad omavahel vastuollu minema. Kiire ülevaatus toob need probleemid esile. Tegin seda just täna (üle kahe kuu!) ja see innustas seda lugu kirjutama.
Jälgi mustreid. Kui Claude korduvalt ignoreerib mõnda reeglit, on fail tõenäoliselt liiga pikk ja reegel kaob müra sisse. Kui Claude küsib küsimusi, millele vastus peaks CLAUDE.md-s olema, on sõnastus ilmselt ebaselge.
Kasuta rõhumärkijaid. Kriitiliste reeglite jaoks kasuta märksõnu nagu “OLULINE”, “KOHUSTUSLIK” või “KRIITILINE”. See parandab Claude’i tähelepanu kõrge prioriteediga juhiste suhtes.
Dokumenteeri õppetunnid. Kui Claude teeb vea, mõtle, kas CLAUDE.md-sse oleks tarvis midagi lisada, et sama viga tulevikus vältida. Samamoodi, kui miski töötab hästi, pane see kirja.
Kohanda konteksti kokkupakkimist. Pikkade sessioonide jaoks saad määrata, mida Claude peab konteksti kokkupakkimisel alles hoidma:
# Konteksti haldus
Kokkupakkimisel säilita alati:
- Muudetud failide täielik nimekiri
- Testikäsud ja nende tulemused
- Kriitilised arhitektuurilised otsused
Versioonihaldus. Lisa CLAUDE.md giti, nagu ka eespool mainisin, et meeskond saaks ühiselt panustada ja ajalugu jälgida. Muudatused CLAUDE.md-s väärivad sama tähelepanu nagu muudatused koodis.
Levinumad vead
Liiga pikk fail. Kõige levinum ja kõige kahjulikum viga. Kui CLAUDE.md on üle 500 rea, hakka kohe kärpima. Eemalda kõik, mida Claude saab koodist ise välja lugeda.
Vales kohas olev info. Materjal, mis kuulub koodikommentaaridesse või dokumentatsiooni, ei peaks olema CLAUDE.md-s. Püüdlikud reeglid nagu “me peaksime seda mustrit kasutama” ei aita, kirjuta ainult tegelikke konventsioone.
Ebamäärased või vastuolulised juhised. Kui uued juhised lähevad vastuollu vanemate omadega, tekib segadus. Vaata need perioodiliselt üle (koos Claudega).
Puuduv oluline kontekst. Unustatud ehitussammud, mainimata keskkonnamuutujad ja selgitamata arhitektuurilised eripärad põhjustavad Claude’il tarbetuid küsimusi ja vigu.
Kokkuvõte
Hea CLAUDE.md järgib viit põhimõtet. Lühidus ennekõike, alla 200 rea on ideaalne ja iga lisarida peab oma koha välja teenima. Spetsiifilisus, selged, üheselt mõistetavad juhised koos näidetega töötavad paremini kui udune üldistus. Hierarhia, kasuta mitut taset strateegiliselt, eraldades isiklikud, meeskonna ja pakettide reeglid. Pidev iteratsioon, käsitle CLAUDE.md-d elava dokumendina, mis areneb koos projektiga. Versioonihaldus, lisa giti, et meeskond saaks ühiselt panustada.
Kõige edukamad meeskonnad kohtlevad CLAUDE.md-d kui kriitilist infrastruktuuri faili, mis aja jooksul väärtust kogub, aga ainult siis, kui seda regulaarselt hooldatakse ja optimeeritakse.
