# Kako nastaviti CLAUDE.md v 2026: predloga in 6 pravil > Predloga CLAUDE.md, pripravljena za uporabo, 6 pravil za vzdrževanje datoteke in analiza delujoče datoteke iz aktivnega podjetja. Vključuje uradne citate Anthropic. Source: https://ailoot.ai/blog/sl/claude-md-template/ Canonical: https://ailoot.ai/blog/sl/claude-md-template/ Language: sl Publisher: Ailoot (https://ailoot.ai/) Translation: guide-126 Revision: sha256-b00c7315392848e65dc87c5e5ae5c1aaf4b949326a6dfb9d0181cd221f81f734
Ključna ugotovitev CLAUDE.md je besedilna datoteka v korenski mapi projekta, ki jo Claude Code prebere na začetku vsake seje. Brez nje agent vsakič začne od začetka: 5-10 minut porabite za razlago: »Živjo, delam na tem projektu, to je moje občinstvo in tak je moj slog.« Jedrnata začetna datoteka pogosto meri na 100-200 vrstic; to je smernica za pregled, ne tehnična zgornja meja. Predloga vsebuje 6 razdelkov (opis, orodja, struktura, usmerjanje po datotekah, pravila in jezik) in se posodobi vsakič, ko Claude naredi napako. Ta članek vsebuje predlogo, pripravljeno za uporabo, 6 pravil, analizo delujoče datoteke iz aktivnega podjetja in kontrolni seznam za 12-točkovno preverjanje.
Gradivo o vibe codingu: orodja, študije primerov, napake. [Vodiči Ailoot](https://ailoot.ai/docs/).
[Vodiči Ailoot](https://ailoot.ai/docs/)
## Zakaj potrebujete CLAUDE.md in zakaj Claude brez njega pozabi projekt?
Ključna ugotovitev V Claude Code se vsak nov klepet začne s praznim kontekstom. CLAUDE.md je edina datoteka, ki jo Claude samodejno naloži v vsako novo sejo. Brez nje agent deluje kot pripravnik prvi dan v službi: ničesar ne ve o vašem podjetju, slogu ali pravilih. Z njo pa dela kot zaposleni v drugem letu.
V torek odprete Claude Code in pojasnite: »Delam na tem projektu, to so orodja, tega ne počni.« Deluje. V četrtek je ta klepet že končan, zato vse ponovite. V soboto znova; v ponedeljek še enkrat. Tako je videti delo z agentom brez CLAUDE.md: vsako novo okno je pripravnik brez predznanja, ki mu morate vedno znova povedati iste stvari. Včasih sem za takšno uvodno razlago v vsaki seji porabil 5-10 minut. Pozivi so postajali dolgi, ker sem moral ves kontekst prenašati ročno. Rezultat pa je bil še vedno splošen: agent ni poznal mojega občinstva, ekonomike ali načel.
Opomba To ni težava s pomnilnikom modela, temveč z arhitekturo. Claude Code v vsaki seji namerno začne s čistim kontekstom; sicer bi se različni projekti na istem računalniku pomešali. CLAUDE.md je mehanizem, s katerim agentu poveste, kaj naj naloži.
Z živo datoteko CLAUDE.md uvodna razlaga ni več potrebna. Vsa pravila, ki ste jih prej ponavljali v vsakem klepetu, so v eni datoteki in se samodejno prikažejo na začetku vsake seje. Poziv postane kratek: »naredi X« namesto »delam na projektu Y, orodja so Z, ne počni A ali B, mimogrede pa si zapomni še C«. Potem izginejo ponavljajoče se napake. Vsaka napaka agenta je razlog, da v CLAUDE.md dodate eno vrstico. Po mesecu dni imate živo »ustavo projekta«, Claude pa se neha vedno znova ujeti v iste pasti. In tu je še tretja plast: agent ne piše več v prazno. S pomočjo `CLAUDE.md` usmerim Claudea v mape z vsebino: kam pogledati za informacije o občinstvu, cenah in blagovni znamki. Brez tega usmerjanja agent piše »kakovostne rešitve«, ne da bi poznal mojo ekonomiko, zato so abstraktne, šablonske in »enake kot pri vseh drugih«. ## Kaj je CLAUDE.md in v kakšnem vrstnem redu jo Claude bere?
Ključna ugotovitev CLAUDE.md je besedilna datoteka v formatu Markdown. Claude Code jo išče na štirih mestih hkrati: na sistemski ravni, na uporabniški ravni, v korenski mapi projekta in med lokalnimi opombami. Vse štiri se na začetku vsake seje naložijo v kontekst. Ime datoteke razlikuje med velikimi in malimi črkami: vedno uporabite `CLAUDE.md` z velikimi črkami.
Anthropic v uradni dokumentaciji CLAUDE.md opiše takole:
Datoteke CLAUDE.md so datoteke Markdown, ki Claudeu dajejo trajna navodila za vaš projekt, osebni potek dela ali celotno organizacijo. Zapišete jih v navadnem besedilu, Claude pa jih prebere na začetku vsake seje.
— Anthropic, code.claude.com/docs/en/memory
Štiri mesta, kjer Claude Code išče CLAUDE.md, razvrščena po naraščajoči prednosti: | Raven | Lokacija | Namen | |----|----|----| | **Organizacija** | `/Library/Application Support/ClaudeCode/CLAUDE.md` v Macu, `/etc/claude-code/CLAUDE.md` v Linuxu | Pravila, ki jih skrbnik podjetja prek MDM uvede za celotno ekipo. Kot posameznik tega ne potrebujete. | | **Uporabnik** | `~/.claude/CLAUDE.md` | Osebna pravila, ki veljajo za vse vaše projekte. »Vedno odgovarjaj v jeziku, ki ga ima uporabnik raje«, »ne uporabljaj pomišljajev em«. | | **Projekt** | `./CLAUDE.md` v korenski mapi projekta ali `./.claude/CLAUDE.md` | Pravila za določen projekt: orodja, struktura map, poslovna logika. Ta datoteka se objavi v git. | | **Lokalno** | `./CLAUDE.local.md` | Vaše osebne opombe za ta projekt, ki ne sodijo v git. Na primer začasni poskusi ali osebne preference, ki jih ekipa ne potrebuje. | Vse štiri datoteke se hkrati naložijo v kontekst. Če si pravila nasprotujejo, Anthropic v dokumentaciji neposredno pove, da ni znano, katero bo imelo prednost; Claude lahko poljubno izbere eno od njih. Zato je preprosteje, da vse ključno hranite v projektni datoteki CLAUDE.md in se izognete podvajanju.
Nasvet Ime datoteke strogo razlikuje med velikimi in malimi črkami. Uporabite velike črke v `CLAUDE.md` in Claude jo bo prebral. Datotek `claude.md` ali `Claude.md` ne bo prebral. Enako velja za `CLAUDE.local.md`. To je pogosta napaka ljudi, ki Claude Code nastavljajo prvič: ustvarijo datoteko, napišejo navodila, se sprašujejo, zakaj ne deluje, nato pa ugotovijo, da je ime datoteke zapisano z malimi črkami.
Obstaja ena tehnična podrobnost, o kateri skoraj nihče ne piše, a pojasni veliko nenavadnega vedenja.
Vsebina CLAUDE.md se pošlje kot uporabniško sporočilo za sistemskim pozivom, ne kot del sistemskega poziva. Claude jo prebere in jo poskuša upoštevati, vendar ni zagotovila, da jo bo dosledno upošteval.
— Anthropic, code.claude.com/docs/en/memory
Z drugimi besedami, CLAUDE.md v strogem pomenu ni »sistemski poziv«. Je prvo uporabniško sporočilo, ki ga Claude vidi. Njena pravila so zato močna priporočila, ne zakoni. Če je treba pravilo uveljaviti, uporabite preizkušen hook za dogodek, ki ga pokriva, ter dovoljenja ali izolacijo okolja za širšo mejo dostopa. Samodejni zagon hooka ne pomeni, da so njegova preverjanja popolna. Mejo med `hooks` in `CLAUDE.md` bom pojasnil spodaj. ## Kako v 5 minutah napisati minimalno datoteko CLAUDE.md (predloga za takojšnjo uporabo)?
Ključna ugotovitev Kopirajte predlogo, zamenjajte polja v oglatih oklepajih in jo shranite v korenski mapi projekta kot `CLAUDE.md`. To zadostuje, da Claude v vsaki seji ne začne več od začetka. Predlogo lahko sproti razširjate po pravilu: »po vsaki napaki agenta dodaj vrstico«.
Spodaj je predloga, ki sem jo preizkusil v več deset svojih projektih. Datoteka ostane dolga približno 80-120 vrstic, v okviru priporočila Anthropic, naj ima manj kot 200 vrstic. S to predlogo agent daje najbolj smiselne rezultate. ```markdown # [PROJECT NAME] - project navigation This document is the project map. Read it at the start of every session to understand where things are and how to work with them. ## What this project is **[NAME]** - [one sentence: what it is and who it’s for]. [1-2 sentences: what problem it solves and how]. Details are in `business/INDEX.md`. ## Reading order at the start of every session 1. `about-me/INDEX.md` - who I am and how I think 2. `business/INDEX.md` - what we do (product, audience, economics) 3. `CLAUDE.md` (this file) - repo rules, tools, navigation 4. Task area: the relevant file from `business/`, `plans/`, `mastery/` or the feature folder in the code Principle: layer 1 (about me) comes before layer 2 (business) for a reason. First, **who** is thinking, then **about what**. ## Repository structure [NAME]/ ├── CLAUDE.md ← this file, navigation ├── about-me/ ← digital projection of you (how you think, what you value) │ └── INDEX.md ├── business/ ← the business’s second brain │ ├── INDEX.md │ ├── audience/ ← customer profile │ ├── products/ ← products, prices │ ├── goals/ ← goals, metrics │ └── economics/ ← unit economics, revenue ├── plans/ ← technical plans (one plan = one feature) ├── retrospectives/ ← reflections after each session └── (project code) ### Where to find things | What you need | Where to look | |---|---| | Why we’re building the project, and for whom | `business/INDEX.md` | | Target customer, pains, desires | `business/audience/` | | Product, plans, prices | `business/products/` | | Goals and metrics | `business/goals/` | | Economics | `business/economics/` | | Technical plans | `plans/` | ## Tools [INSERT TOOLS - for example: Next.js 14, TypeScript, Tailwind CSS, Prisma + PostgreSQL]. ## Repo rules 1. Never hardcode dynamic data (prices, dates, figures) - get everything from files in `business/` and the LIVE marker. 2. Don’t publish without my explicit command. 3. Before `git push`, run `npm run build` and check that it builds without errors or warnings. 4. Add files by name with `git add`. Never use `git add .` or `git add -A`. 5. Don’t read `.env` in full. To check a variable, use `grep "^VAR=" .env`. ## Big features = a plan in `plans/` Any task lasting more than an hour must be written up as a plan in the `plans/` folder: 1. Filename: `YYYY-MM-DD-feature-name.md`. 2. Divide the plan into phases. Mark each phase `[ ]` or `[x]`. 3. At the end of the plan, add a summary: whether it was fully implemented and what remains. ## End-of-feature cycle After each feature is complete, go through these 5 steps: 1. Find errors → prove them with an example → fix them. 2. What was missed (edge cases, input validation, error handling). 3. Is this a real problem in our project? Check `business/` and `plans/`. 4. Take a fresh look: reread the diff as if you’re seeing it for the first time. 5. Security review. Especially: personal data and third-party materials. ## End-of-session reflection In `retrospectives/YYYY-MM-DD_short-name.md`, record: 1. What the task was. 2. How it was solved. 3. Whether it was solved - yes / no / partially. 4. What could have been done better. 5. What was learned about the user or project. ## Language Always respond in the user’s preferred language. Use hyphens only, not em dashes. ``` Da bi Claude samodejno izpolnil to predlogo za vaš projekt, mu dajte ta poziv. Prebral bo kontekst in izpolnil polja v oglatih oklepajih:
Poziv: Izpolni CLAUDE.md za moj projekt ``` Create a CLAUDE.md file at the project root using this template: [INSERT THE ENTIRE TEMPLATE FROM ABOVE] Proceed as follows: Read about-me/INDEX.md and business/INDEX.md to understand the project context and me as the author. Fill in all the square-bracketed fields in the template based on what you find in those folders. If some information is missing, ask me clarifying questions one at a time, with 3-4 answer options. Aim to keep the resulting CLAUDE.md under 200 lines. If it is longer, review duplication and move detailed procedures to linked files. Preserve essential planning, reflection, and repo rules, then test them on representative tasks. Show me the final file and ask what should be revised. Always respond in the user’s preferred language. ```
Če še nimate map `about-me/` in `business/`, nič hudega. Claude bo postavil dodatna vprašanja in sestavil minimalno datoteko CLAUDE.md na podlagi razpoložljivih informacij. Mape lahko ustvarite pozneje, ko boste vedeli, kaj vanje sodi. ## Katerih 6 pravil spremeni CLAUDE.md v živ dokument?
Ključna ugotovitev Teh 6 pravil je strnjenih iz izkušenj z več deset projekti. CLAUDE.md spremenijo iz »datoteke, ki smo jo ustvarili in pozabili« v delovni dokument, ki ga Claude pregleda v vsaki seji.
### Pravilo 1. Prizadevajte si za manj kot 200 vrstic Anthropic to v uradni dokumentaciji pove jedrnato:
Prizadevajte si, da ima CLAUDE.md manj kot 200 vrstic. Daljše datoteke porabijo več konteksta in zmanjšajo upoštevanje navodil.
— Anthropic, code.claude.com/docs/en/memory
Dolga datoteka CLAUDE.md deluje proti sebi na dva načina. Prvič, porablja žetone. Datoteka z navodili, dolga 800 vrstic, se naloži v vsako okno in v vsaki seji porabi več tisoč žetonov vašega proračuna. Pri naročnini Pro z dnevno omejitvijo to opazno zmanjša število razpoložljivih sej. Drugič, model začne ignorirati pravila. Dokumentacija priporoča manj kot 200 vrstic za manjšo porabo konteksta in boljše upoštevanje navodil. Ne določa ostre meje odpovedi pri vrstici 201. Pred odločitvijo, kaj prestaviti drugam, preglejte ustreznost, nasprotja, količino naloženih žetonov in dejanske rezultate nalog.
Opozorilo Če ste že pri 300-500 vrsticah, brez panike - vsebino razdelite med mape. Podrobna pravila, na primer o oblikovalskem sistemu, dajte v `business/assets/brand-guidelines.md`. CLAUDE.md se lahko nanj sklicuje z eno vrstico: »Ko delate na uporabniškem vmesniku, si oglejte `business/assets/brand-guidelines.md`.« Načelo usmerjanja: CLAUDE.md je kazalo vsebine, ne knjiga.
### Pravilo 2. Vsako sejo končajte z razmislekom V CLAUDE.md napišite: »Ob koncu vsake seje zabeleži, kaj si naredil in se naučil, v `retrospectives/YYYY-MM-DD_*.md`.« Ko dodate to vrstico, Claude vsako sejo začne samostojno zaključevati z razmislekom; tega vam ni treba zahtevati. Zakaj razmišljati o delu: - Čez dva tedna lahko odprete staro retrospektivo in se spomnite, zakaj ste izbrali to pot. - Ko se po mesecu dni vrnete k projektu, imate pripravljen pregled nedavnih odločitev. - Če delate v ekipi, lahko sodelavec prebere retrospektivo in v 2 minutah razume trenutno stanje, brez klica. ### Pravilo 3. Po vsaki dokončani nalogi ustvarite objavo V moji datoteki CLAUDE.md piše: »Po vsaki dokončani nalogi ustvari objavo git s smiselnim sporočilom.« Claude začne sam razbijati delo na majhne, samostojne objave. To vam prinese dvoje. Prvič, če se kaj pokvari, lahko povrnete eno operacijo, ne pa »vsega, kar sem danes naredil«. Drugič, zgodovina objav postane dnevnik dela, ki pokaže, kaj se je spremenilo in v kakšnem vrstnem redu. ### Pravilo 4. Vedno preglejte mapo `business/` Pri vsaki nalogi, ki vključuje stranke, izdelke ali besedila, naj agent najprej odpre `business/INDEX.md` in ustrezno datoteko, na katero se sklicuje. V moji datoteki CLAUDE.md izrecno piše: »Ko delate na uporabniškem vmesniku ali besedilu, najprej preglejte `business/audience/avatar.md` in `business/assets/brand-guidelines.md`.« Brez tega pravila Claude piše besedila v »splošnem slogu kakovostne spletne strani«. Z njim pa piše v vašem slogu, za vaše stranke in brez prepovedanih besed. ### Pravilo 5. Po vsaki napaki agenta dodajte pravilo To je glavno pravilo, ki ohranja CLAUDE.md živo. Primeri iz moje datoteke CLAUDE.md, dodani po konkretnih napakah: - »Nikoli ne objavljaj datotek WIP nekoga drugega z ukazom `git add .` - dodaj datoteke v pripravo po imenu.« - »Pred objavo v `main` preveri `git log origin/main..main --oneline` - če izpis ni prazen, ne objavljaj.« - »Ne izmišljaj si vrednosti - pridobi jih iz `.env` ali kode. Zlasti URL-je, uporabniška imena in žetone.« Vsaka od teh vrstic je sled konkretnega dogodka. Enkrat je agent objavil nedokončano vejo sodelavca. Enkrat sem vključil tuje objave, ki še niso bile poslane. Enkrat si je agent izmislil URL, ki ne obstaja. Vsaka napaka postane pravilo in ista samopovzročena škoda se ne ponovi. ### Pravilo 6. Varnost shranite v `.claude/settings.json`, ne v CLAUDE.md V CLAUDE.md lahko napišete »ne dotikaj se `.env`«, a to je le prošnja; Claude jo lahko krši, ker se CLAUDE.md naloži kot uporabniško sporočilo, ne kot zakon. Za kritično varnost uporabite `.claude/settings.json`, kjer lahko strogo blokirate določene ukaze. Seznam blokiranih ukazov, ki ga dodam vsakemu novemu projektu: - `rm -rf` (rekurzivno brisanje poljubnih datotek). - Branje celotne datoteke `.env` (`Read .env`). - `export` in `curl` v istem ukazu (vzorec za zunanje razkritje skrivnosti). - `git push --force` brez izrecne odobritve.
Opozorilo Razlika je preprosta: pravilo v CLAUDE.md je nasvet, ki ga agent lahko prekrši. Ujemajoče se pravilo deny blokira zajeto dejanje v veljavnem poteku dovoljenj. Ne dokazuje zaščite pred vsakim enakovrednim ukazom, drugim orodjem ali drugačnim načinom dovoljenj. Ključna varnostna pravila hranite v `settings.json`, vse drugo pa v CLAUDE.md.
Druge vodiče najdete pri [Ailoot](https://ailoot.ai/docs/).
[Vodiči Ailoot](https://ailoot.ai/docs/)
## Kako je strukturirana datoteka CLAUDE.md v aktivnem podjetju (anatomija datoteke z 280 vrsticami)?
Ključna ugotovitev Razčlenjujem strukturo datoteke CLAUDE.md, ki jo uporablja delujoča spletna storitev. Datoteka ima približno 280 vrstic in 11 razdelkov. Pokazal bom vsebino vsakega razdelka in razlog zanjo. Dejanskega besedila ne bom objavil, saj vsebuje operativne podrobnosti. Okvir pa je mogoče uporabiti v vsakem podjetju.
Večina primerov CLAUDE.md na spletu so tehnične predloge za razvijalce: »Uporabljaj TypeScript«, »Ne piši testov, daljših od 50 vrstic.« Za podjetnika je takšna datoteka CLAUDE.md neuporabna - ne obravnava poslovne plati. Spodaj je struktura moje delujoče datoteke CLAUDE.md. Odstranil sem konkretna pravila in poti, ker odražajo moje notranje delovanje. Strukturo in logiko razdelkov pa je mogoče uporabiti pri vsakem projektu: dodajte svoje okoliščine in dobili boste delujočo datoteko. **1. Kratek opis projekta (15 vrstic).** Kaj počnemo, kdo je občinstvo in katere izdelke ponujamo. Ne povzetek za tržno spletno stran, temveč pregled za agenta, da razume, »kam gremo«. **2. O meni (10 vrstic).** Sklic na mapo `about-me/` - digitalni odsev mojega načina razmišljanja. Ton, vrednote, načela, prepovedane besede. Ko Claude piše besedilo »kot jaz«, najprej prebere to mapo, da se ujame z mojim glasom. **3. Struktura repozitorija (20 vrstic).** Drevo s komentarji: kje je koda, kje poslovni kontekst, kje načrti in refleksije. Brez tega zemljevida Claude vsakič slepo išče datoteke. **4. Tabela »Kje najti stvari« (25 vrstic).** Usmerjanje od »vprašanja → datoteke«. Za nepremičninsko agencijo bi lahko na primer pisalo »potrebujem pogoje hipoteke → `business/products/mortgage.md`« ali »potrebujem ton za objave → `business/assets/voice.md`«. Nadomestite to s svojimi datotekami. Ta tabela je srce datoteke CLAUDE.md. Brez nje agent ugiba, katera datoteka vsebuje odgovor. Z njo gre naravnost k viru. **5. Ključna načela projekta (40 vrstic, 10-15 postavk).** Ta razdelek se počasi nabira in zahteva največ truda. Vsaka postavka je sled določene napake. Za spletno trgovino bi pravila lahko bila na primer »nikoli ne zapiši cen in dobavnih rokov neposredno v kodo«, »ne objavi izdelka brez izrecnega ukaza« in »pred objavo izdelka preveri slog glede na glosar blagovne znamke«. Ta razdelek je »ustava projekta«. **6. Operativno načrtovanje (20 vrstic).** Tabela sprožilcev, ki povezuje »izraz uporabnika → dejanje«. Na primer: »Ko rečem ‘načrtuj teden’, odpri `ops/monthly.md` in ustvari datoteko za ta teden.« Tako Claude postane operativni pomočnik, ki razume kontekst ukazov. **7. Orodja (5 vrstic).** Tehnologije. Na kratko, brez odvečnega besedila. **8. Objavljanje (15 vrstic).** Postopek po korakih za objavo sprememb v produkciji: katere ukaze zagnati, v kakšnem vrstnem redu in kaj preveriti. Včasih sem to razlagal vsakič. Zdaj Claude ve. **9-12. Varnost (35 vrstic).** Štirje ločeni podrazdelki: pravila za delo z `.env`, dostop do produkcijske podatkovne zbirke, varni ukazi za predstavitve (snemanja zaslona, pretočni prenosi, posnetki zaslona, da žetoni ne bi bili po nesreči razkriti) ter pravila za menjavo skrivnosti. **13. Mapa `plans/` (10 vrstic).** Standard za načrte: ime datoteke, struktura faz in vsebina povzetka. **14. Mapa `retrospectives/` (5 vrstic).** Standard za refleksijo: predloga, ime datoteke in kaj mora vsebovati. **15. Podatki iz žive podatkovne zbirke (15 vrstic).** Pravilo za označevanje »svežih podatkov«: kadar datoteka zahteva aktualne številke, jih agent pridobi iz vira namesto uporabe starih. Tako Claude ne more uporabiti včerajšnjih številk. **16. Jezik (3 vrstice).** »Vedno odgovarjaj v jeziku, ki ga ima uporabnik raje. Uporabljaj samo vezaje, ne pomišljajev em.« Skupaj približno 280 vrstic. To presega cilj jedrnatosti, vendar datoteka zato ni neveljavna. V tem primeru je ostala koristna; ohranitev naj temelji na izmerjeni porabi konteksta in preizkusih značilnih nalog. Tabele niso samodejno cenejše v žetonih kot običajno besedilo.
Nasvet Struktura, ki sem jo razvil v enem letu dela, ni dogma. Okvir je naslednji: opis (1-2 razdelka), struktura in usmerjanje (2-3 razdelki), pravila/načela (1 velik razdelek), operativni postopki (2-3 razdelki, prilagojeni vašemu podjetju) in drobne podrobnosti (jezik, stiki). Izpolnite ga s podrobnostmi svojega podjetja. Glavno pravilo: vsak razdelek mora odgovoriti na vprašanje: »Bi Claude brez tega naredil napako?« Če ne, ga odstranite.
## Kaj naredi ukaz `/init` in zakaj ni dovolj?
Ključna ugotovitev Ukaz `/init` v Claude Code samodejno ustvari osnovno datoteko CLAUDE.md tako, da pregleda projekt ter navede orodja in ukaze za gradnjo. Je dobro izhodišče, toda brez poslovnega konteksta in načel je datoteka tehnična in splošna. Uporabite `/init` kot prvi korak, nato pa jo ročno dopolnite.
Anthropic v dokumentaciji ukaz opiše takole:
Zaženite /init, da samodejno ustvarite začetno datoteko CLAUDE.md. Claude bo analiziral vašo kodo in ustvaril datoteko z ukazi za gradnjo, navodili za testiranje in zaznanimi konvencijami projekta.
— Anthropic, code.claude.com/docs/en/memory
Kaj `/init` naredi dobro: - Prepozna orodja iz `package.json`, `Cargo.toml` in `pyproject.toml`. - Navede ukaze za gradnjo in testiranje. - Zazna konvencije v obstoječih datotekah (`.eslintrc`, `.prettierrc`). - Opazi obstoječa pravila Cursor (`.cursorrules`, `.cursor/rules/`) in pravila Copilot ter vključi ustrezne dele. V načinu `CLAUDE_CODE_NEW_INIT=1` zazna tudi `AGENTS.md`. Česa `/init` ne bo naredil: - Ne bo vedel, kdo so vaše stranke. - Ne bo dodal prepovedanih besed za besedila. - Ne bo dodal pravil o napakah agentov (ker se te še niso zgodile). - Ne bo ustvaril tabele »kje najti stvari« za vašo poslovno strukturo. Pravilen potek dela je torej: 1. ### Zaženite /init v Claude Code Dobili boste začetno datoteko CLAUDE.md s 30-50 vrsticami, orodji in ukazi. To je tehnični temelj. 2. ### Dodajte predlogo iz tega članka Uporabite razdelek »Minimalna datoteka CLAUDE.md v 5 minutah«. Dodajte razdelke za navigacijo, usmerjanje in načela. 3. ### Izpolnite polja v oglatih oklepajih Dajte Claudeu poziv »preberi moj projekt in izpolni predlogo«. Če mapi `business/` in `about-me/` še ne obstajata, bo Claude postavil dodatna vprašanja. 4. ### Izvedite stresni preizkus Claudeu recite: »Preberi moj CLAUDE.md in poišči 10 nejasnosti, zaradi katerih bi lahko kot agent kaj razumel narobe.« Dobili boste seznam popravkov. 5. ### Nato datoteko uporabljajte Po vsaki napaki agenta dodajte vrstico. Čez mesec dni boste imeli živo datoteko CLAUDE.md, prilagojeno svojemu podjetju. Poziv za četrti korak:
Poziv: Preizkusi CLAUDE.md pod obremenitvijo ``` I have a CLAUDE.md. Tomorrow I’ll be building a feature based on it. Your task is to stress-test it. Find 10 reasons we could potentially fail: where CLAUDE.md is ambiguous and you, as an agent, might misunderstand it where there are gaps that would force you to make things up where rules contradict one another where I overestimate how much can be done in one day where I underestimate things (this is even worse) Don’t hold back. Criticize it harshly. I want to find these issues now, not in production. At the end, give me a list of specific changes: what to change and how, so these problems don’t happen. ```
## CLAUDE.md v primerjavi z AGENTS.md in MEMORY.md: kdo kaj bere v 2026?
Ključna ugotovitev Tri podobne datoteke se pogosto zamenjujejo. CLAUDE.md vsebuje projektna pravila, ki jih napišete sami in jih Claude Code prebere v vsaki seji. AGENTS.md je univerzalni standard za druge agente (Codex, Cursor, Copilot), od septembra 2026 pa jo Claude Code bere tudi, če projekt nima datoteke CLAUDE.md. MEMORY.md vsebuje samodejne opombe, ki si jih Claude piše o vaših navadah. Vse tri lahko obstajajo hkrati brez nasprotij.
| Datoteka | Kdo jo napiše | Kdo jo bere | Kdaj se naloži | |----|----|----|----| | **CLAUDE.md** | Vi, ročno | Claude Code (izvorno) | Na začetku vsake seje | | **AGENTS.md** | Vi, ročno | Codex CLI, Cursor, GitHub Copilot CLI, Gemini CLI in od različice 2.1.277 tudi Claude Code, če projekt nima datoteke CLAUDE.md | Na začetku vsake seje | | **MEMORY.md** | Claude Code sam | Claude Code (izvorno) | Na začetku vsake seje, prvih 200 vrstic (ali 25 KB, kar je manjše) | Glavno vprašanje, ki bega začetnike, je: **ali Claude Code bere `AGENTS.md`?** Pred septembrom 2026 je bil odgovor »ne«: Anthropicova dokumentacija je svetovala, naj ustvarite datoteko CLAUDE.md, ki uvozi AGENTS.md. Od različice 2.1.277, izdane 18. septembra 2026, Claude Code bere AGENTS.md sam, vendar le, če v delovni mapi ali nad njo ni datoteke CLAUDE.md, `.claude/CLAUDE.md` ali `CLAUDE.local.md`.

Claude Code lahko bere AGENTS.md kot projektna navodila, zato repozitorij, ki je že nastavljen za druge agente, deluje brez datoteke CLAUDE.md, uvoza ali konfiguracije.

— Anthropic, https://code.claude.com/docs/en/memory#agents-md
Če projekt vsebuje datoteko CLAUDE.md, Claude Code privzeto bere samo to datoteko in preskoči AGENTS.md. To lahko spremenite v `/config`, v razdelku Project instructions: na primer nastavitev `claude-md-and-agents-md` mu omogoči branje obeh datotek. Deluje tudi drug način, in sicer v vseh različicah: v datoteko CLAUDE.md dodajte uvoz: ```markdown @AGENTS.md ## Claude Code Additional rules for Claude Code that other agents don’t need. ``` Skladnja `@filename` uvozi drugo datoteko. Claude jo prebere in naloži v kontekst skupaj z datoteko CLAUDE.md. Uvoz ne povzroči, da bi bila datoteka prebrana dvakrat, tudi če Claude Code lahko AGENTS.md bere samostojno. **Kdaj potrebujete AGENTS.md.** Če vzporedno uporabljate Claude Code, Codex CLI, Cursor ali Copilot, ustvarite AGENTS.md kot edini vir resnice, v CLAUDE.md dodajte `@AGENTS.md`, nato pa dopišite morebitna pravila, značilna za Claude. Če takšnih pravil nimate, CLAUDE.md ni treba ustvariti: od različice 2.1.277 Claude Code sam bere AGENTS.md. Če uporabljate samo Claude Code, AGENTS.md ne potrebujete; uporabite samo eno datoteko CLAUDE.md. Za vse možnosti po korakih si oglejte [vodič za sočasno uporabo AGENTS.md in CLAUDE.md v enem projektu](https://ailoot.ai/blog/sl/agents-md-claude-md-one-instruction-file/). **Kaj je MEMORY.md?** Po nedavni posodobitvi Claude Code samodejno shranjuje opombe o vas v `~/.claude/projects//memory/MEMORY.md`. Med njimi so pogovorne navade (»uporabnik ima raje kratke odgovore«), ponavljajoče se fraze (»prepovedal je emojije v kodi«) in vedenjska opažanja (»uporablja macOS in zsh«). To je ločen pomnilniški sistem, ne CLAUDE.md. Ne pišete je sami; Claude jo ustvarja na podlagi pogovorov. Če MEMORY.md vsebuje kaj, kar bi moralo postati pravilo, to prenesite v CLAUDE.md. Če vsebuje kaj nepotrebnega ali napačnega, lahko to ročno izbrišete; gre za besedilno datoteko.
Opomba Če želite videti, kaj se naloži na začetku seje, v Claude Code vnesite `/memory`. Prikaže vsebino datotek CLAUDE.md, MEMORY.md in drugih naloženih datotek. To je uporabno, ko se Claude vede nenavadno: odprite `/memory` in poiščite pravilo, ki bi lahko povzročilo takšno vedenje.
## Kako dolga datoteka CLAUDE.md je uporabna in kako pregledati dolgo datoteko?
Ključna ugotovitev Daljša navodila porabijo več konteksta in lahko otežijo upoštevanje ustreznih pravil, zlasti če vsebujejo podvajanja ali nasprotja. Anthropic priporoča manj kot 200 vrstic. To priporočilo ni tehnična zgornja meja ali splošna napoved, koliko pravil bo agent upošteval.
V vsakem oknu Claude Code se v kontekst naloži več plasti: Anthropicov sistemski poziv (po ocenah več deset tisoč žetonov), vaša datoteka CLAUDE.md, datoteke, uvožene z `@`, MEMORY.md, zgodovina trenutnega klepeta in vsebina datotek, ki jih Claude odpre. Vse to se mora prilegati kontekstu modela (200K žetonov za Sonnet, 1M za Opus). Večja ko je datoteka CLAUDE.md, manj prostora ostane za trenutno delo. Datoteka z 1,000 vrsticami obsega približno 8,000 žetonov in se ponovi v vsaki seji. Pri naročnini Pro (po mojih izkušnjah približno 10-12 »zahtevnih« pozivov na dan) to zmanjša zmogljivost za četrtino. Strošek je le ena od težav. Upoštevanje navodil se lahko poslabša, kadar so dolga, nepomembna ali nasprotujoča; splošno veljavnega števila zanesljivo upoštevanih navodil ni. Preizkusite nekaj značilnih nalog, ki vključujejo ključna pravila, zabeležite napake ter primerjajte vedenje po ciljno usmerjeni spremembi.
Napihnjene datoteke CLAUDE.md povzročijo, da Claude ignorira vaša dejanska navodila.
— Anthropic, code.claude.com/docs/en/best-practices
Za velikost torej velja naslednje praktično pravilo: - **80-120 vrstic** - priročen začetni razpon za jedrnato karto projekta, ne zagotovljen rezultat upoštevanja pravil. - **150-200 vrstic** - koristna spodbuda za pregled ustreznosti in prestavitev podrobnih postopkov v povezane datoteke. - **200-300 vrstic** - preverite količino žetonov, podvajanje in rezultate nalog; zgornji poslovni primer z 280 vrsticami lahko še vedno dobro deluje. - **400+ vrstic** - močan razlog za ciljno usmerjen pregled, ne dokaz neuporabnosti datoteke. Ohranite bistvene omejitve, podrobnosti pa prestavite šele po preverjanju delovanja povezav in pravil. Samo število vrstic ne dokazuje uspeha ali neuspeha. Po spremembi ponovite iste značilne naloge in preverite pomembna pravila, namesto da jim pripisujete izmišljen odstotek upoštevanja.
Opozorilo Če je vaša datoteka CLAUDE.md postala prevelika, je ne preurejajte ročno. Claudeu dajte ta poziv: »Preberi CLAUDE.md in vsako vrstico oceni z vprašanjem: ‘Če bi to vrstico odstranili, ali bi agent naredil napako?’ Vrni seznam vrstic, ki jih je mogoče odstraniti brez izgube, ter utemeljitev.« Odstranil bo, kar očitno ne deluje.
Anthropic v dokumentaciji ponuja neposreden preizkus:
Za vsako vrstico se vprašajte: »Če jo odstranim, bo Claude začel delati napake?« Če ne, jo izbrišite.
— Anthropic, code.claude.com/docs/en/best-practices
To uporabite za vsako vrstico. Če je odgovor »še vedno bi naredil prav«, vrstico odstranite. CLAUDE.md ni mesto za dokumentacijo, zgodovino odločitev ali filozofijo. Namenjena je samo pravilom, ki jih agent potrebuje, da ne dela napak. ## Katereh 7 napak naredi CLAUDE.md neuporabno?
Ključna ugotovitev To je sedem pogostih napak, ki jih redno opažam v datotekah CLAUDE.md drugih ljudi. Vsaka je razlog, da datoteko sistematično uredite. Večina napak je različica ene težave: poskus, da bi CLAUDE.md postal univerzalni »projektni dokument«, namesto da bi ostal delovno orodje za agenta.
### Napaka 1. »Bodi dober inženir« Najpogostejša napaka. Ljudje v CLAUDE.md zapišejo splošne želje: »piši čisto kodo«, »uporabljaj dobre prakse«, »razmišljaj kot višji inženir«. Te besede ne pomenijo ničesar. Claude že na splošno piše »čisto kodo«. Te vrstice zavzamejo kontekst, ne da bi vplivale na katero koli odločitev. »Piši čisto kodo« zamenjajte z »uporabljaj 2 presledka za zamik«, »v TypeScriptu ne uporabljaj `any`« ali »funkcije naj ne bodo daljše od 30 vrstic«. Konkretno in preverljivo. ### Napaka 2. Podvajanje tega, kar Claude že ve Opisi standardnih jezikovnih konvencij (»v JavaScriptu so funkcije objekti prvega razreda«, »TypeScript ima statične tipe«). Razlage delovanja npm, git ali docker. Claude se je vsega tega naučil med učenjem. Podvajanje v CLAUDE.md ničesar ne doda, le zmanjša prostor v kontekstu. ### Napaka 3. Dolga navodila po korakih v datoteki CLAUDE.md Dolga navodila o tem, »kako uvesti projekt«, »kako ustvariti migracijo podatkovne zbirke« ali »kako nastaviti novo komponento«. Na desetine vrstic po korakih. To ni mesto za dolga navodila po korakih. Namenjeno je enovrstičnim pravilom. Dolga navodila dajte v `skills/` (ločen mehanizem Claude Code, ki se naloži po potrebi) ali v `docs/`. V CLAUDE.md uporabite enovrstično povezavo: »Pri ustvarjanju nove migracije odpri `docs/migrations.md`.« ### Napaka 4. Pravila, ki jih že preverja samodejni analizator kode »Uporabljaj podpičja«, »ne puščaj neuporabljenih uvozov«, »ne uporabljaj `var`«. ESLint, Prettier in Biome vse to zaznajo - to so orodja za lintanje (samodejno preverjanje kode). Linter je determinističen: zažene se, najde napako in jo popravi. Pravilo v CLAUDE.md je verjetnostno; agent ga lahko pozabi. Ni razloga za podvajanje - lažje je nastaviti linter. ### Napaka 5. Skrivnosti v datoteki CLAUDE.md Videl sem gesla testnih računov, žetone API za peskovnik in povezave do prijavljenih skrbniških plošč. Vse je bilo v datoteki, objavljeni v git, in naloženo v kontekst modela Anthropic. Nikoli. Skrivnosti sodijo v `.env`, ki je v `.gitignore`. CLAUDE.md lahko kvečjemu pove: »Ne beri celotne datoteke `.env`; za posamezno spremenljivko uporabi `grep`.« ### Napaka 6. Odlagališče z več kot 500 vrsticami, ki ga šest mesecev ni nihče uredil Datoteka CLAUDE.md je zrasla, podvaja polovico `docs/`, si na več mestih nasprotuje in nihče se več ne spomni, kaj je v njej. Agent začne večino pravil ignorirati. Ekipa se pritožuje, da »Claude ne upošteva navodil«, in doda še več pravil, zato je še slabše. Znaki zanemarjene datoteke CLAUDE.md: več kot 300 vrstic, ponovljena pravila v različnih razdelkih, zastarele povezave do neobstoječih datotek ter »zgodovinske« opombe, kot je »leta 2024 smo se odločili tako, potem pa smo si premislili«. Rešitev: vsaka dva tedna prosite Claudea, naj jo pregleda po Anthropicovem preizkusu: »Če bi to vrstico odstranili, ali bi agent naredil napako?« Izbrišite vse, pri čemer je odgovor »ne«. ### Napaka 7. Ustvarite datoteko CLAUDE.md in nanjo pozabite To je nasprotje prejšnje napake. Datoteko ste sestavili enkrat, pred dvema mesecema, in se je od takrat niste dotaknili. Medtem so se orodja spremenila, dodane so bile nove mape in pojavile so se nove napake agentov. CLAUDE.md tega ne ve, ker je nihče ni posodobil. Značilen znak: isto navodilo ponavljate v vsaki seji. »Ne počni X«, »ne dotikaj se Y«, »zapomni si Z«. Če ste ga ponovili več kot dvakrat, sodi pravilo v CLAUDE.md, ne v vašo glavo.
[Vodiči Ailoot](https://ailoot.ai/docs/)
## Kako CLAUDE.md omogočite samoučenje s pravilom »posodobi ob koncu seje«?
Ključna ugotovitev Glavna tehnika, ki je CLAUDE.md spremenila iz dokumenta v živo orodje, je bila dodati eno pravilo: »Ob koncu vsake seje preveri, ali si izvedel kaj novega o uporabniku ali delu z njim, česar v CLAUDE.md še ni, in dodaj vrstico.« V dveh mesecih so se v datoteki začela nabirati individualna pravila brez ločenega postopka.
Moja datoteka CLAUDE.md ima kratek razdelek: ```markdown ## Self-learning At the end of every session, check: - Have I learned anything new about the user or how to work with them? - Did I break any rule that should now be recorded? If so, create or update a file in `about-me/feedback/` in this format: Rule (one-line rule) → Why (why it was added) → How to apply (when it applies). I don’t write the rules by hand - I say, “not like that, because this is how,” and you put it into a file. ``` Po dodajanju tega razdelka v CLAUDE.md je Claude ob koncu vsake seje začel spraševati: »Je bilo kaj novega, kar bi bilo vredno zabeležiti?« Če je bilo, je predlagal osnutek pravila, jaz sem ga pojasnil in ustvarili smo datoteko. Po dveh mesecih takšnega dela imam v `about-me/feedback/` več kot dva ducata datotek - pravil, naučenih iz konkretnih napak. Vsaka datoteka je ena stran v obliki Pravilo → Zakaj → Kako. Mapa je postala »drugi spomin«, v katerem so zabeležene moje osebne preference in tabuji. Napake ne ponavljamo, ker postanejo pravila, pravila pa se kopičijo in krepijo. Po šestih mesecih Claude pozna moj projekt bolje, kot se ga spomnim po mesecu odmora. ## Kako v CLAUDE.md dodate pravila za pravo, trženje in operacije?
Ključna ugotovitev Tehnična navodila v CLAUDE.md so le polovica slike. Drugo polovico sestavljajo poslovna pravila: prepovedano besedilo zaradi pravnih zahtev, zunanje oblikovanje besedil za blagovno znamko in operativne navade za tedensko delo ekipe. Ko CLAUDE.md pokriva obe plati, Claude postane ne le programer, temveč tudi urednik in operativni pomočnik.
Za večino ekip je CLAUDE.md izključno tehnični dokument: orodja, ukazi za gradnjo, konvencije programiranja. To je koristno, vendar predstavlja le tretjino vrednosti. Ko podjetnik vzdržuje CLAUDE.md, je smiselno dodati poslovne razdelke. Najpomembnejši so trije: ### Pravila za področje prava (za regulirane trge) Če objavljate besedila v regulirani panogi (finance, medicina, oglaševanje zdravil, izdelki za otroke), imajo prepovedane besede pravno težo in sodijo v CLAUDE.md kot izrecna pravila. Ne v glavo nekoga, ne na posnetek zaslona urednika - v datoteko, ki jo agent vidi v vsaki seji. Primer za fintech projekt brez bančne licence: Uredniška opomba: V nadaljevanju je prikazana oblika notranjega pravila za določen projekt. To ni splošno dovoljenje za uporabo navedenih izrazov: sprejemljivost trditve je odvisna od veljavne zakonodaje in statusa podjetja. > 🚨 KRITIČNO - finančno besedišče je prepovedano. V gradivih za stranke ne uporabljajte besed »depozit«, »zajamčen donos« ali »naložbeni produkt«. Uporabljajte »varčevalni račun«, »pričakovani donos« in »produkt s spremenljivo obrestno mero«. Razlog so pravne zahteve, ki veljajo za oglaševanje finančnih storitev v tem projektu. Ta blok v CLAUDE.md naredi nekaj preprostega: vsakič, ko Claudea prosite, naj napiše besedilo za stranke, ga agent preveri glede na te prepovedi. Brez pravila se prepovedane besede pojavijo v vsaki tretji kampanji. Z njim pozabite, da sploh obstajajo. Enak pristop deluje za: - Medicinske projekte (brez trditev, da nekaj »zdravi« ali »pozdravi«). - Oglaševanje zdravil (brez trditev, da je nekaj »najučinkovitejše«; obvezna opozorila). - Vsako regulirano panogo z lastnimi oglaševalskimi pravili. ### Slog trženja in oblika besedil Če redno objavljate besedila (družbena omrežja, novice, spletna mesta), je vredno obliko opisati v enem odstavku datoteke CLAUDE.md. Tukaj je primer, kaj bi lahko napisal vplivnež ali agencija, ki vodi kanal za sporočanje: > Pri pisanju objav za kanal si oglej `style/posts.md`. Uporabljaj dovoljene oblikovne oznake kanala in se izogibaj »nevarnim« posebnim znakom. Zaključi s pozivom k dejanju z oznako UTM po tej konvenciji: `utm_source=&utm_medium=&utm_campaign=`. Claude je prej pisal objave v »splošnem slogu trženjske spletne strani«. Zdaj upošteva vašo obliko, uporablja vaše oznake UTM in ne razkrije, da jih je napisala UI. ### Operativne navade Tabele sprožilcev. Ko izrečete določeno frazo, agent ve, katere datoteke odpreti in kaj storiti. Tukaj je primer za ekipo, ki načrtuje po tednih: > »Načrtuj teden« → odpri `ops/monthly.md`, ustvari `YYYY-WNN.md` v isti mapi in prestavi naloge iz `ops/backlog.md` pod ustrezne dneve. »Kaj je v seznamu opravil?« → preberi `ops/backlog.md` in prikaži ga kot seznam. »Zaključi teden« → izpolni razdelek »Povzetek tedna« v datoteki za ta teden. S takšnimi tabelami Claude iz »pomočnika za pisanje kode« postane »operater«, ki pozna poslovno rutino. Vsak ponedeljek rečem: »Načrtujmo teden«, Claude pa odpre ustrezne datoteke, prebere mesečne cilje in predlaga, kako razdeliti naloge.
Opomba Poslovna navodila v CLAUDE.md so smiselna, ko že imate mapo `business/` z dejanskim kontekstom o občinstvu, izdelkih in ciljih. Če je še nimate, jo najprej ustvarite, nato pa v CLAUDE.md dodajte povezave do nje. Sicer boste imeli navodila, ki kažejo v prazno.
## Kako v 5 minutah preverite datoteko CLAUDE.md po kontrolnem seznamu z 12 točkami?
Ključna ugotovitev S tem kontrolnim seznamom preverite svojo trenutno datoteko CLAUDE.md. Vsaka točka vzame 30 sekund. Če imate pet ali več odgovorov »ne«, je treba datoteko urediti.
1. **Velikost.** Je jedrnata, s približno 200 vrsticami kot ciljem za pregled in ne mejo uspeha ali neuspeha? 2. **Ime.** Se imenuje natanko `CLAUDE.md`, z velikimi črkami, ne `claude.md`? 3. **Lokacija.** Je v korenski mapi projekta ali v `./.claude/CLAUDE.md`? 4. **Opis projekta.** Ali je iz prvih 5 vrstic jasno, kaj je projekt in komu je namenjen? 5. **Orodja.** Ali so tehnologije navedene izrecno in brez odvečnega besedila? 6. **Struktura.** Je diagram repozitorija opremljen z razlagami? 7. **Usmerjanje.** Je vključena tabela »vprašanje → datoteka«, ki pokaže, kje najti odgovore? 8. **Načela.** Ali razdelek vsebuje pravila, ki se začnejo z »nikoli« in »vedno«? 9. **Konkretna pravila.** Je vsako pravilo preverljivo? (»Uporabi 2 presledka«, ne »piši lepo«.) 10. **Posodabljanje.** Ali obstaja pravilo »ob koncu seje preveri, kaj dodati«? 11. **Refleksija.** Ali obstaja pravilo »zabeleži povzetek seje v `retrospectives/`«? 12. **Varnost.** So ključne prepovedi (`.env`, `rm -rf`) vključene tudi v `.claude/settings.json`? Če imate več kot pet odgovorov »ne«, odprite Claude in mu dajte ta poziv:
Poziv: Preveri CLAUDE.md glede na kontrolni seznam ``` Read my CLAUDE.md and compare it with the checklist below. For each item, say: yes / no / partly, and what specifically to fix. Checklist: Compact enough for the task; review around 200 lines without treating it as a hard ceiling Project description in the first 5 lines Tools listed explicitly Repository structure diagram included “Question → file” table included Principles section with rules included Every rule is specific and verifiable “Update at the end of the session” rule included “Reflect at the end of the session” rule included Critical prohibitions included in .claude/settings.json No duplicates of the same rule in different sections No dangling links to files that no longer exist After the audit, give me a list of specific changes that will make the file living. ```
## Kaj uporabiti po datoteki CLAUDE.md: Plan Mode, Skills ali podagente?
Ključna ugotovitev CLAUDE.md je temelj. Ko deluje, so na voljo naslednje ravni: Plan Mode (Claude naj najprej načrtuje, nato ukrepa), Skills (redko uporabljeno znanje premaknite iz CLAUDE.md v ločene datoteke) in podagenti (izolirane naloge v lastnih kontekstih).
CLAUDE.md je temelj. Ko deluje, lahko dodate tri mehanizme Claude Code, ki se medsebojno krepijo. **Način Plan Mode.** Način, v katerem Claude najprej pripravi načrt sprememb, počaka na vašo odobritev in šele nato začne delati. Vklopite ga s Shift+Tab ali ukazom `/plan`. Odpravlja glavno težavo vibe codinga: »Prosil sem Claudea, naj popravi eno stvar, on pa je prepisal polovico projekta.« V načinu Plan Mode se to ne zgodi - načrt vidite, preden se agent dotakne katere koli datoteke. **Veščine.** Ločene datoteke `.md` v mapi `.claude/skills/`, ki vsebujejo znanje za določeno vrsto naloge. Na primer veščina »kako ustvariti migracijo podatkovne zbirke« vsebuje konkreten postopek, predlogo in primere. To znanje ni v CLAUDE.md, ker je preobsežno. Ko Claude naleti na nalogo, kot je »ustvari migracijo«, naloži ustrezno veščino in ji sledi. **Podagenti.** Če naloga potrebuje veliko konteksta (na primer pregled obsežne funkcionalnosti), lahko Claude zažene ločenega podagenta v njegovem lastnem čistem kontekstu. Podagent opravi delo in vrne rezultat, ne da bi obremenil kontekst glavnega klepeta. Vsi trije mehanizmi uporabljajo CLAUDE.md kot vstopno točko: na začetku dela jo preberejo, da razumejo kontekst projekta. Zato tudi te funkcije brez žive datoteke CLAUDE.md delujejo slabo. Najprej temelj, nato dodatne plasti. **Naslednji korak.** V korenski mapi projekta ustvarite datoteko `CLAUDE.md`, kopirajte predlogo z začetka tega članka in izpolnite polja v oglatih oklepajih s pomočjo poziva. Nato datoteko uporabljajte: vsako napako agenta spremenite v novo vrstico. Po dveh ali treh tednih CLAUDE.md ne bo več »dokument, ki smo ga napisali in pozabili«, temveč nekaj, kar Claude dejansko pregleda v vsaki seji. Če želite zgraditi celovit okvir okoli `CLAUDE.md` - mapo `business/` za drugi um, mapo `about-me/` za digitalni odsev sebe, osnovne veščine in nastavljen način Plan Mode - uporabite korake in primere v tem članku. [Vodiči Ailoot](https://ailoot.ai/docs/).
### Viri - [Anthropic - Claude Code Memory](https://code.claude.com/docs/en/memory) - uradna dokumentacija o CLAUDE.md, MEMORY.md in hierarhiji nalaganja - [Anthropic - Best Practices](https://code.claude.com/docs/en/best-practices) - pravila za pisanje učinkovite datoteke CLAUDE.md in preizkus »ali bi odstranitev tega povzročila, da bi Claude naredil napako?« - [Anthropic Support - Give Claude Context](https://support.claude.com/en/articles/14553240-give-claude-context-claude-md-and-better-prompts) - vodič za delo s kontekstom - [Vodiči Ailoot](https://ailoot.ai/docs/) - dokumentacija.
[Nadaljujte z Ailoot](https://ailoot.ai/).
[Nadaljujte z Ailoot](https://ailoot.ai/)
[Nadaljujte z Ailoot](https://ailoot.ai/)
## Vprašanja in odgovori: Kako nastaviti CLAUDE.md v 2026: predloga in 6 pravil ### Ali datoteka CLAUDE.md po 200 vrsticah postane neveljavna? Ne. Priporočilo je cilj jedrnatosti, ne meja razčlenjevanja ali zagotovljena točka odpovedi. Preglejte podvajanja, nasprotja in naloženi kontekst, nato pomembna pravila preverite na značilnih nalogah. Enako je treba oceniti primer z 280 vrsticami iz članka. ### Kaj naj prestavim iz rastoče datoteke CLAUDE.md? Podrobne postopke, dolgo referenčno gradivo in zgodovino odločitev prestavite v ustrezne dokumente ali spretnosti. V vstopni datoteki ohranite jedrnata dejstva o projektu, bistvene omejitve in jasne povezave. Po urejanju ponovite resnične naloge ter preverite usmerjanje in ključna pravila. ## Ailoot · Podjetje in njegov portfelj projektov Ailoot temelji na pridobljenih operativnih izkušnjah, široki bazi strank, stabilni storitvi in stalnem spremljanju KPI. Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah. Ailoot te operativne izkušnje uporablja za dostop prek API do funkcij umetne inteligence v izdelkih strank, agentih, aplikacijah in avtomatizacijah.