Štirje pozivi za omejevanje pritrjevanja v Claude Code

Kaj je pritrjevanje umetne inteligence v Claude Code?#

Psihologija za to že dolgo pozna izraz: prilizovanje. Prilizovalec pove, kar želite slišati, samo da pogovor teče naprej. S prihodom velikih jezikovnih modelov se je izraz preselil v raziskave umetne inteligence, Anthropic pa je v eni od uradnih analiz odkrito priznal, da model pogosto žrtvuje točnost za hitro strinjanje.

Pri programiranju je videti takole. Claude Code napišete: »Odpravi to napako v authMiddleware; čarobne povezave so prenehale delovati.« Prilizovalec ne postavlja pojasnjevalnih vprašanj. Ne zahteva dnevnikov. Ne vpraša, katero različico knjižnice uporabljate. Takoj ponudi rešitev, ker je bil naučen, da mora biti hitro koristen. Rešitev bo videti pravilna: uvozi, obravnava napak, komentarji. Toda šlo bo za rešitev tujega problema, izmišljeno na podlagi konteksta, ki ga je Claude sestavil iz drobcev.

Vzrok ni Claude. Vzrok je način, kako je zahteva oblikovana. Ko vprašate »Kako naj to popravim?«, ste že predpostavili, da se da popraviti. Prilizovalec bo prevzel takšno izhodišče in pripravil »popravek«, tudi če je resnična težava v arhitekturi, različici knjižnice ali pa je opisani simptom le posledica povsem drugega osnovnega vzroka.

Preprost preizkus, ali zahteva spodbuja prilizovanje: če na vprašanje »Kaj točno je pokvarjeno?« ne morem odgovoriti v treh stavkih, še nisem pripravljen na reševanje. Potrebujem diagnozo. Šele nato pride popravek. Prav tu se začne štiristopenjski cikel.

Študija primera: 8 povrnjenih commitov v eni uri#

Konkreten primer iz aprila 2026. Delal sem na preverjanju pristnosti s čarobno povezavo v src/lib/auth/. Simptom: žetoni so bili preverjeni, seja pa se ni shranila. Uporabnik klikne povezavo v e-poštnem sporočilu, pristane na spletnem mestu in čez pet sekund je preusmerjen nazaj na /login.

Odprl sem Claude Code in vpisal: »Seja se po čarobni povezavi ne shrani; poglej v src/lib/auth/ in to popravi.« Claude je postavil tri pojasnjevalna vprašanja, nato pa takoj pripravil načrt. Rekel je: »Posodobil bom obravnavo povratnega klica, na novo napisal serializator JWT, dodal izrecno shranjevanje v Redis in odpravil race condition v vmesni plasti.« Zvenelo je verjetno. Načrt sem odobril.

Osemnajst minut pozneje sem imel diff v 14 datotekah. Čarobna povezava še vedno ni delovala. Zdaj pa ni deloval niti žeton za osvežitev, prijava z geslom je bila pokvarjena, na poti za plačila pa se je pojavila nenavadna napaka 500. Testi so bili neuspešni. Začel sem razveljavljati spremembe.

Povrnil sem 8 commitov z ukazom git reset --hard origin/main. Ura dela je šla v nič. Če želite izvedeti, kako pravilno razveljaviti spremembe, ne da bi izgubili kaj uporabnega, sem to ločeno opisal v vodniku za razveljavljanje sprememb v Claude Code.

Usedel sem se in zadevo ustrezno raziskal. Odprl sem src/lib/auth/magic-link.ts:42, ga sam prebral, odprl dnevnike in preveril Redis. Dvajset minut pozneje sem našel težavo. Šlo je za eno vrstico: v glavi set-cookie je manjkal atribut SameSite=lax, Safari pa je zavrnil piškotek pri preusmeritvi z e-poštne domene nazaj na spletno mesto. Ne JWT, ne Redis, ne vmesna plast. Ena vrstica.

Ko sem prosil Clauda, naj odpravi težavo, sploh ni pogledal dnevnikov brskalnika. Ni imel konteksta o Safariju. Ustvaril je hipotezo na podlagi vzorca »seja se ne shrani = težava s serializacijo«, ker je to najpogostejši odgovor v podatkih za učenje. Prilizovalec je ponudil statistično verjetno rešitev, ki ni imela nobene zveze z mojo nalogo.

Nauk sem zapisal kot pravilo: nikoli ne vprašajte »Kako naj to popravim?« Vedno recite »Ugotovi dejstva.« Ostalo je le še to, da to formaliziram kot delujoč cikel.

Od kod izvira prilizovanje: Opus 4.8 ob izidu in maj 2026#

Aprila je Anthropic v inženirskem poročilu o incidentu ločeno preučil, kako je napaka pri predpomnjenju v Claude Code povzročila, da je model med zaporednimi obrati »pozabil« svoje sklepanje.

Ko model pozabi svojo verigo sklepanja, lažje »ugane« odgovor na podlagi vzorca — z drugimi besedami, postane še bolj prilizovalen.

Kaj storiti po izdaji različice 4.8? Ne izberite »lažjega« modela. Ne vrnite se na 4.7. Pozive prilagodite dejstvom: model je bolj nagnjen k strinjanju, zato še odločneje poudarite »ugotavljanje dejstev«. Če še niste natančno ugotovili, kaj se spreminja v Opusu 4.8, sem ga podrobno primerjal v pregledu Opusa 4.8 v Claude Code.

Kdaj so potrebni 4 koraki — in kdaj so izguba časa#

Konkretni primeri. Popravljanje besedila v pozdravnem e-poštnem sporočilu: opravite neposredno. Dodajanje novega gumba CTA na spletno mesto: Plan Mode brez cikla. Migracija projekta z MySQL na Postgres: štiristopenjski cikel je potreben. Nenavadna napaka 500 v produkciji, ki je lokalno ni mogoče ponoviti: štiristopenjski cikel z dodatnim »ničtim« korakom: »najprej pripravimo najmanjši primer za reprodukcijo«.

Pogosta napaka pri uporabi cikla je, da ga uporabite pri nepomembnih nalogah. To ubije hitrost in ljudi hitro odvrne od metodologije. Cikel je potreben natanko takrat, ko so stroški napake večji od stroškov 15 minut načrtovanja.

Preden uvedete cikel, upoštevajte, da vsi štirje pozivi delujejo znotraj ene same seje Plan Mode. Če tega načina še niste uporabljali, najprej preberite vodnik po Plan Mode v Claude Code, nato pa se vrnite.

1. korak: prepovejte rešitve — Claude naj ugotovi dejstva#

Najpomembnejši korak. Tu blokiramo prvi vzgib — »tukaj je rešitev«. Poziv:

Zaznal sem naslednje: [simptom].

Vaša naloga je zdaj ugotoviti dejstva. Kakršne koli
rešitve, zamisli ali nasveti so prepovedani. Samo:
- kaj opažam (natančno besedilo simptoma)
- ponovljivi koraki (najmanjši scenarij)
- kateri podatki so na voljo (dnevniki, različice, okolje)
- kateri podatki manjkajo (kaj je treba zbrati)

Strogi pogoj za ustavitev: ne predlagajte rešitev; samo
zabeležite diagnozo. Če želite kaj predlagati,
mi raje zastavite vprašanje.

Kaj to naredi? Ob izrecni prepovedi rešitev Claude ne more ubrati bližnjice. Izpolniti mora štiri polja: kaj vidim, kako to ponoviti, kaj vem in česa ne vem. Zadnje je najdragocenejše. Pogosto se izkaže, da gre za naslednje: »Ne vem, katera je različica knjižnice, kaj je v dnevnikih ali ali se simptom pojavlja v produkciji.« To je izhodišče za naslednji korak.

Past pri 1. koraku. Če je simptom opisan preveč nejasno (»preverjanje pristnosti ne deluje«), bo Claude še vedno posegel po ugibanju. Rešitev je že v samem pozivu: natančen simptom opišite v enem stavku in navedite najmanjši trikorakni scenarij. Če tega ne zmorete, pomeni, da še ne razumete natančno, kaj je pokvarjeno, in Claudov odgovor tako ali tako ne bo uporaben.

2. korak: primeri iz prakse z interneta namesto halucinacij iz spomina#

S tem blokiramo drugi vzgib: »izmisli si rešitev iz spomina«. Poziv:

Zdaj, ko je diagnoza postavljena, poiščite primere iz prakse
za reševanje podobnih težav na internetu.

Vsaj 3 različne pristope. Za vsakega navedite:
- povezavo do primarnega vira (issue, članek, dokumentacija)
- kratek opis pristopa
- prednosti in slabosti za naš položaj
- znane pasti

Prepovedane so povezave, ki temeljijo na vašem lastnem znanju,
ne da bi jih potrdila povezava. Če ne najdete primera iz prakse,
to izrecno povejte.

Učinek v praksi. Claude poišče informacije v zunanjem svetu in prinese nazaj preverljive pristope. Pojavijo se povezave do GitHubovih issuejev in dokumentacije. Če Claude ne najde primerov iz prakse, je to znak, da je naloga neobičajna ali pa je simptom napačno opisan. Vrnite se na 1. korak.

Kje se to zalomi. Claude lahko navede neobstoječo povezavo. To je halucinacija v slogu »tukaj je issue številka 4291 v repozitoriju X«, čeprav se issue 4291 v resnici nanaša na nekaj drugega. To rešite z izrecnim pravilom v CLAUDE.md: »pred navajanjem vedno odprite povezavo z WebFetch«. Podrobnosti najdete v vodniku za pravilno nastavitev CLAUDE.md.

3. korak: podroben načrt v plans/ s predvidenimi tveganji#

Plan Mode zdaj deluje, kot je predvideno. Poziv:

Izberite najboljšo možnost iz 2. koraka in napišite podroben
načrt v datoteko plans/YYYY-MM-DD-fix-[name].md:

- katerih konkretnih datotek se bomo dotaknili (polne poti in številke vrstic)
- kaj bomo dodali in kaj odstranili
- katere teste bomo napisali in kateri obstoječi morajo biti uspešni
- tveganja dva do tri korake vnaprej (kaj bi lahko šlo narobe za uporabnike)
- načrt za povrnitev sprememb, če gre kaj narobe

Vsak korak naj bo potrditveno polje [ ]. Datoteka se mora prilegati na en zaslon.
Če je načrt daljši od 200 vrstic, ga razdelite na faze.

Rezultat. Načrt postane artefakt namesto začasnega zapisa v klepetu. Čez dva tedna ga lahko preberete, predate drugemu agentu ali uporabite kot pogoj za ukaz /goal. Datoteka z načrtom v Claude Code traja dlje kot pogovor.

Ključni del so tveganja dva do tri korake vnaprej. To blokira še en prilizovalski vzorec: optimističen načrt brez stranskih učinkov. Ko od Clauda izrecno zahtevate, naj navede tveganja, odkrije stvari, ki bi jih v običajnem načrtu tiho spregledal.

4. korak: sami preverite načrt — ujemite prilizovalske predpostavke#

Zadnji filter. Poziv:

Zdaj obvezno opravite samopreverjanje. Iskreno znova preberite svoj načrt.

Ali so v njem mesta, ki ste si jih izmislili in jih niste potrdili z:
- kodo, ki ste jo prebrali;
- dokumentacijo, ki ste jo navedli v 2. koraku;
- primerom iz prakse iz 2. koraka?

Če so, jih izrecno označite, popravite ali odstranite.

Preverite tudi:
- ali omenja knjižnice, ki še niso nameščene
  v package.json;
- ali omenja spremenljivke okolja, ki jih nisem navedel;
- ali so koraki načrta opisani splošno
  namesto konkretno.

Kaj to naredi? Claude mora znova preveriti svoje sklepanje. V avtorjevem vzorcu s približno 50 cikli se v 4. koraku izrecno spremeni vsaj dve ali tri točke načrta. To so mesta, kjer je prilizovalec skušal neopazno zdrsniti skozi 3. korak, 4. korak pa ga ujame.

Po štirih korakih je načrt pripravljen za odobritev. Lahko nadaljujete z izvedbo, ne da bi vas skrbelo: »Kaj pa, če bom moral povrniti 8 commitov?«

Zakaj natanko 4 koraki, ne 2 ali 7?#

Tukaj je razlaga po metodi, ki jo Anthropic uporablja za vodenje Clauda v uradni dokumentaciji.

Dokumentacija priporoča štirifazni potek dela: Explore, Plan, Implement, Commit.

Moj štiristopenjski cikel je prilagoditev faze Plan za boj proti prilizovanju. Od štirih Anthropicovih faz eno razširim v štiri mikro korake: prepoved rešitev, iskanje primerov iz prakse, zapis načrta in samopreverjanje. Podroben načrt se nato uporabi v fazah Implement in Commit.

Poglejmo, kaj se zalomi, če preskočite katerega od štirih korakov:

Iz tabele je jasno: vsak korak blokira svoj razred napak. Potrebujete vse štiri, ker vsak ujame drugo kategorijo. Če se zdi naloga tako majhna, da bi zadostovala dva koraka, je naloga res majhna — in Plan Mode sploh ne potrebujete.

Kako se povezujejo plans/, ukaz /goal in naslednji koraki#

Cikel deluje v sistemu, v katerem imate:

1. Vklopljen Plan Mode (v Claude Code dvakrat pritisnite Shift+Tab).
2. Mapo plans/ v repozitoriju za shranjevanje načrtov.
3. Po želji ukaz /goal za samostojno izvedbo dolgih načrtov.

Nekaj posebej o mapi plans/. Po 3. koraku dobite datoteko plans/2026-05-27-fix-magic-link.md s fazami in potrditvenimi polji. To je artefakt. Odprite ga čez teden dni in spomnili se boste, zakaj ste izbrali ta pristop. Čez tri mesece boste našli podobno nalogo in načrt znova uporabili. Čez šest mesecev ga boste pokazali kolegu in mu prihranili dva tedna privajanja. Mapa plans/ je del koncepta »drugega možgana« v Claude Code.

Nekaj posebej o ukazu /goal. Ko dokončate štiri korake in odobrite načrt, zapustite Plan Mode in vnesite:

/goal complete all phases from plans/2026-05-27-fix-magic-link.md,
all tests in test/auth pass, or stop after 30 turns

Pri lokalni seji Claude Code naj terminal ostane zagnan, računalnik buden in omrežna povezava na voljo. Prenosnika ne zapirajte, razen če ste izrecno uredili podprto delovanje brez spanja. Ob vrnitvi preverite zgodovino seje: lahko pokaže dokončanje, omejitev obratov, zahtevo za dovoljenje ali napako. Cilj ne zagotavlja napredka, ko gostitelj spi. Brez štiristopenjskega cikla /goal porablja žetone za nekoristne ponovitve. Z njim pa /goal pripelje dokončan načrt do uspešno opravljenih testov.

Kaj storiti zdaj? Če šele začenjate uporabljati Claude Code, preizkusite cikel pri naslednji zahtevnejši nalogi. Ne pri tipkarski napaki. Pri nečem, kar zadeva 3+ datotek ali vključuje vedenje, ki ga ne razumete povsem. Vzemite zgornje pozive, jih kopirajte in dopolnite s svojimi podrobnostmi. Opazili boste, kako se spremeni delež povrnjenih sprememb.

Če že uporabljate Plan Mode, v repozitorij dodajte mapo plans/. Določite si obliko imena datotek: YYYY-MM-DD-feature-name.md. Čez mesec boste imeli 20–30 datotek, čez šest mesecev pa več kot sto. Tako nastaja drugi možgan projekta — živa zgodovina odločitev. Če se želite poglobiti, sem context engineering v Claude Code obravnaval kot ločeno disciplino.

Če že uporabljate Plan Mode in imate mapo plans/, preizkusite /goal pri eni samostojni nalogi. Izberite nalogo, ki bi jo običajno ročno opravili v 30–40 minutah. Izvedite jo skozi štiri korake, shranite načrt, zaženite /goal ter pustite lokalni terminal zagnan in računalnik buden. Za delo med izklopom tega računalnika najprej uporabite izrecno nastavljeno oddaljeno ali oblačno okolje izvajanja in preverite, da naloga teče tam.