CLAUDE.md po Opusu 5: zakaj dolga navodila zdaj ovirajo Claude

Informacije o delu z Ailootom so na voljo v dokumentaciji.

Kaj se je pri Claude spremenilo po izidu Opusa 5?#

Opus 5 je izšel 24. julija 2026 in takoj postal privzeti model v Claude Code. Sam model – njegova cena, primerjalni preizkusi in načini effort – je podrobno predstavljen v ločenem vodniku »Ali bi morali preklopiti na Claude Opus 5?«. Ta članek govori o nečem drugem: izid modela je spremenil tudi način učinkovitega pogovora z njim.

Podjetje Anthropic je na blogu Claude objavilo analizo. Njeno glavno sporočilo je takšno:

Ključni izraz je »preveč omejevali«. Ko so bili modeli šibkejši, so potrebovali oporo: naredi to, ne naredi onega, tukaj je primer, ponovi še enkrat. Opus 5 te opore ne potrebuje več, še več, lahko mu začne biti v napoto. Anthropic novo načelo izrazi preprosto: dovolite Claudu, da uporabi lastno presojo.

Kaj to v praksi pomeni za vas?

• Vaš CLAUDE.md je enaka vrsta sistemskega poziva, vendar za vaš projekt. Če je Anthropic svojega skrajšal za 80 odstotkov, je verjetno tudi vaš preobsežen.
• Dolgi seznami pravil ne zagotavljajo več upoštevanja navodil. Nasprotno: več kot je vrstic, manj dosledno jim model sledi (več o tem spodaj, skupaj s podatki iz dokumentacije).
• Pojavili so se novi mehanizmi – samodejni spomin in skills –, ki prevzamejo del dela, ki ste ga prej morali ročno zapisati v CLAUDE.md.

Bistveno delo poteka pred pozivom – v tem, kaj vključite v kontekst modela pred prvo zahtevo. Posodobitev Opusa 5 je v bistvu uradna potrditev Anthropicovega istega spoznanja. Tokrat pa jo spremljajo konkretni podatki in nova orodja. Poglejmo jih po vrsti.

Zakaj je dolg CLAUDE.md zdaj v napoto?#

Tako deluje. CLAUDE.md je datoteka s pravili, ki jo Claude prebere na začetku vsake seje. Ločen vodnik »Kako nastaviti CLAUDE.md« pojasnjuje, kako ga sestaviti od začetka; ta članek pa govori o nasprotnem: kaj zdaj odstraniti. Vse, kar zapišete vanj, vstopi v kontekst pred vašo prvo zahtevo in ostane tam ves čas pogovora. Kontekst ni neskončen – vsaka dodatna vrstica pravil zavzame prostor, ki bi ga lahko namenili vaši nalogi.

Dokumentacija Claude Code je neposredna:

Druga točka je pomembnejša od prve: dolge datoteke zmanjšajo upoštevanje navodil. Model začne manj pozorno poslušati. V to past se ujame skoraj vsak začetnik. Logika je videti neizpodbitna: želim, da me Claude posluša, zato bom napisal več pravil. V praksi se zgodi ravno nasprotno. Daljši kot je seznam, bolj razpršena je pozornost modela in pogosteje spregleda kakšno pravilo.

Tako se je pristop spremenil:

Obstaja še druga težava: protislovja. Ko se datoteka veča, se v njej skoraj neizogibno naberejo nasprotujoča si pravila. Na enem mestu piše »vedno napiši teste«, na drugem pa »ne spreminjaj mape tests«. Dokumentacija opozarja, da lahko Claude ob nasprotujočih si pravilih naključno izbere katero koli od njih. Z drugimi besedami, preobsežna datoteka naredi vedenje modela manj predvidljivo.

Preprosto pravilo: CLAUDE.md je kratka opomba o tem, česar Claude ne more sam razbrati. Vse drugo zgolj zaseda njegovo pozornost.

Kaj ohraniti v CLAUDE.md in kaj odstraniti?#

Dokumentacija ponuja jasna merila za odločitev, ali si pravilo zasluži mesto v CLAUDE.md. Dodajte ga, če:

1. Je Claude isto napako naredil že drugič.
2. Je preverjanje kode odkrilo nekaj, kar bi model moral vedeti o tem projektu.
3. V klepet že drugič vnašate isti popravek.
4. Bi novi član ekipe potreboval enak kontekst, da ne bi pokvaril projekta.

Splošno načelo je ohraniti pasti, značilne za projekt, in odstraniti očitno. Claude Code ima celo vgrajeno preverjanje claude doctor, ki predlaga čiščenje preobsežnega CLAUDE.md. Izloči podrobnosti, ki jih model lahko razbere iz kodne zbirke – strukturo map, seznam odvisnosti, pregled arhitekture – ter ohrani pasti, razloge in konvencije, ki se razlikujejo od privzetih.

Drugo pomembno pravilo je konkretnost. Nejasno besedilo ne deluje. Primerjajte:

Razlika je preprosta. Model si lahko »pravilno oblikuj« razlaga po svoje. »Uporabi zamik z 2 presledkoma« je mogoče nedvoumno preveriti. Vsako pravilo v CLAUDE.md mora biti nekaj, kar lahko preverite in vidite – ali je bilo upoštevano ali ne.

Tretjič, odstranite očitno. Če v CLAUDE.md zapišete »piši čisto kodo« ali »upoštevaj najboljše prakse«, je to šum. Model to že ve, vrstica pa zaseda prostor in razprši njegovo pozornost. Anthropic izrecno odsvetuje porabo konteksta za očitne stvari.

Kam prestaviti pravila, ki ne sodijo v CLAUDE.md?#

Tukaj nastopi najbolj podcenjeno orodje. Če so morala biti nekoč vsa navodila v CLAUDE.md, imajo dolgi postopki zdaj svoj prostor: skills. Ločen vodnik »Kako izbrati Claude Code skills« pojasnjuje, kako izbrati prave, ne da bi jih dodali preveč.

Razlika je temeljna. CLAUDE.md se na začetku vsake seje naloži v celoti. Skill pa ne. Dokumentacija to opiše takole:

Temu pravimo postopno razkrivanje – nalaganje informacij po potrebi. Zamisel je, da model dobi kontekst po delih in ob pravem trenutku. Anthropic je podrobna navodila, na primer navodila za pregled kode, prestavil v skills in jih odstranil iz sistemskega poziva.

Merilo za prestavitev v skill je preprosto: razdelek v CLAUDE.md je iz dejstva prerasel v postopek. Enovrstična opomba »Gradnje se izvajajo z npm run build« je dejstvo in sodi v CLAUDE.md. Deset korakov za »objavo projekta« je postopek in sodi v skill.

Praktično načelo: predajte naprej vse, kar naredite več kot nekajkrat. Enkrat razložite, kako sestavite, denimo, tedensko poročilo za stranko, razlago spremenite v skill in tega vam ne bo treba znova pojasnjevati. Skill je tam, ne da bi zasedal kontekst, prikličete pa ga lahko po imenu z ukazom, kot je /otchet.

V skills je koristno prestaviti:

• Večstopenjske postopke (objava, priprava poročila, preverjanja pred izdajo).
• Dolga navodila, ki jih redko potrebujete, vendar v celoti.
• Vse, kar drugič ali tretjič kopirate iz enega klepeta v drugega.

Obstaja tudi vmesna možnost: pravila, vezana na posamezno mapo. Če je navodilo pomembno samo za en del projekta, ga lahko shranite v .claude/rules/ in povežete z ustreznimi datotekami. Nato se naloži samo takrat, ko Claude dela s temi datotekami, namesto da bi bilo ves čas v kontekstu.

Kaj je samodejni spomin in zakaj ga uporabljati leta 2026?#

Drugi novi mehanizem, ki razbremeni CLAUDE.md, je samodejni spomin. Zamisel je, da si Claude zdaj zapomni ne le tisto, kar ste zapisali, temveč tudi tisto, kar je opazil sam. Ločen vodnik »Claude Memory ali CLAUDE.md« pojasnjuje, v čem se njegovo delovanje razlikuje od CLAUDE.md.

Razlika med obema vrstama spomina:

Tako deluje: med delom na vaši nalogi Claude opazi koristne podrobnosti – kateri ukaz zažene gradnjo, kje se je razhroščevanje zataknilo, kaj ste ga prosili, naj naredi drugače – in jih shrani v svoje zapiske. V naslednji seji jih znova uporabi. Pomembno: shranjuje selektivno in obdrži samo tisto, kar se mu zdi koristno za prihodnost.

Zapiski so v ločeni mapi za vsak projekt, skupaj z indeksno datoteko MEMORY.md. Ogledate in uredite jih lahko z ukazom /memory. Gre za navadne besedilne datoteke, zato jih lahko kadar koli preberete, uredite ali izbrišete.

Kaj se v praksi spremeni za vas: Claude zdaj zabeleži del stvari, ki ste jih prej po vsaki napaki sami dodali v CLAUDE.md. Tako je vaša datoteka s pravili še krajša – in to je dobro.

Zakaj Opus 5 ugovarja vašim navodilom?#

To ima tudi drugo plat.

Model, ki lahko uporablja lastno presojo, se bo po definiciji včasih ne strinjal s togim ukazom, če v kontekstu vidi boljšo možnost.

Kaj to pomeni za vas, če ste prešli na Opus 5 in gre kaj narobe:

1. Znova preverite svoje stare skills in vtičnike. Nastavitve, ustvarjene za prejšnje modele, so lahko v nasprotju z novo logiko. Nekaj, kar je prej delovalo kot ura, je zdaj vredno ponovno preizkusiti.
2. Odstranite najbolj toge formulacije. Modeli pete generacije slabše obravnavajo ukaze, kot sta »nikoli ne naredi X« in »vedno naredi samo Y«, kot pa prilagodljivo besedilo, ki pojasni razlog.
3. Bodite pozorni na primere, ko se model ustavi prezgodaj. Včasih to pomeni, da si navodilo nasprotuje ali naleti na pravilo v preobsežnem CLAUDE.md.

Kako prepisati CLAUDE.md za Opus 5: korak za korakom#

Tako se lotite datoteke CLAUDE.md, podedovane od prejšnjih modelov.

1. Zaženite vgrajeno preverjanje

   V projektu vnesite claude doctor. Predlagal bo, kaj odstraniti iz preobsežne datoteke in kaj ohraniti.

2. Odstranite očitno

   Izbrišite vsako vrstico, ki jo Claude lahko razbere iz same kode: strukturo map, seznam knjižnic in splošne fraze, kot je »piši čisto kodo«.

3. Odstranite protislovja

   Preglejte datoteko od začetka do konca in poiščite nasprotujoča si pravila. Eno obdržite, drugo pa izbrišite.

4. Postopke prestavite v skills

   Vse, kar je iz dejstva preraslo v navodilo po korakih, prestavite v ločen skill. V CLAUDE.md pustite enovrstično povezavo.

5. Preostala pravila naredite konkretna

   Vsako pravilo preoblikujte tako, da ga bo mogoče preveriti: »pravilno oblikuj« naj postane »uporabi zamik z 2 presledkoma«.

6. Vklopite samodejni spomin in preverite dolžino

   Prepričajte se, da samodejni spomin deluje (/memory) in da ima datoteka manj kot 200 vrstic. Če ne, je treba še nekaj prestaviti.

Če se želite izogniti ročnemu prvemu pregledu, naj to opravi Claude. Tukaj je poziv, ki ga lahko uporabite kot izhodišče – kopirajte ga in prilepite v sejo, odprto v projektu:

Preberi moj CLAUDE.md in mojo kodo. Tvoja naloga je, da CLAUDE.md skrajšaš in ga narediš uporabnejšega za model pete generacije.

Preglej datoteko in vsa pravila razdeli v tri skupine:

KEEP - pasti, značilne za projekt, in konvencije, ki jih iz kode ne moreš razbrati sam.

DELETE - očitne stvari, ki jih že poznaš, in vse, kar je mogoče razbrati iz kode.

MOVE TO A SKILL - večstopenjski postopki, ki so trenutno zapisani v CLAUDE.md.

Pravila iz prve skupine preoblikuj tako, da bodo konkretna in preverljiva.
Poišči pravila, ki si med seboj nasprotujejo, in jih prikaži ločeno.
Vrni novo različico CLAUDE.md z manj kot 200 vrsticami ter seznam predlogov za prestavitev v skills.
Ne spreminjaj nobene datoteke, dokler tega ne potrdim.

Bodite pozorni na zadnjo vrstico: »Ne spreminjaj ničesar, dokler tega ne potrdim.« Pri modelu, ki zdaj uporablja lastno presojo, je to pomembno: naj vam najprej pokaže načrt, odločitev pa prepustite sebi.

Zakaj je kontekst pomembnejši od poziva?#

Če odmislimo podrobnosti o Opusu 5 in pogledamo širšo sliko, celotna analiza govori o eni zamisli: kontekst je pomembnejši od poziva. Najpomembnejše delo se zgodi pred zahtevo – ko sestavljate okolje, v katerem bo model deloval.

CLAUDE.md, skills in samodejni spomin so deli iste celote: vsega, kar Claude vidi pred vašim prvim sporočilom. Besedilo svoje zahteve lahko neskončno prilagajate, vendar bodo rezultati še vedno nedosledni, če je kontekst slabo sestavljen – preobsežen CLAUDE.md, nasprotujoča si pravila, pomanjkanje strukture.

Preprost preizkus: brez prvega možganov drugi možgani ne pomagajo. »Drugi možgani« v tem članku pomenijo strukturo znanja o projektu, ki jo model prebere ob vsaki zahtevi. To deluje samo, če temelji na vašem jasnem razumevanju naloge. Orodje okrepi vaše razmišljanje in tu se njegova vloga konča.

Posodobitev Opusa 5 je to logiko izostrila. Anthropic je z lastnim delom pokazal, da dodatna pravila škodijo, ko je model dovolj pameten, prednost pa ima tisti, ki je skrbno sestavil kontekst. Ta veščina vam bo koristila pri vsakem naslednjem modelu, najsi bo Opus 6 ali kateri koli drugi.

Kje začeti zdaj?#

Ne odlašajte na »enkrat pozneje«. Najpreprostejši prvi korak je, da zdaj odprete CLAUDE.md in se pri vsaki vrstici iskreno vprašate: gre za past, ki je Claude ne more razbrati sam, ali za očitno stvar, ki sem jo dodal za vsak primer? Vse iz druge skupine je kandidat za izbris.

Nato uporabite poziv iz prejšnjega razdelka, dolge postopke prestavite v skills in preverite, ali je samodejni spomin omogočen. En večer dela in vaš kontekst bo postal jedrnata, natančna podlaga za model.

To lahko uporabite na lastnem resničnem projektu: CLAUDE.md, drugi možgani in skills za svoje naloge.

Spoznajte Ailoot.