Zakaj Claude Code znova prebere celoten projekt in kako to odpraviti

Dokumentacija Ailoot: API, ključi in povezovanje.

Zakaj Claude Code vsakič znova bere projekt od začetka?#

Mnogi mislijo, da gre za napako. V resnici je Claude Code zasnovan tako: lastnega indeksa projekta nima. Ko ga prosite, naj nekaj popravi, nima pri roki pripravljenega zemljevida kode — projekt razišče znova: poišče ustrezne datoteke, išče potrebne nize in datoteke prebere v pomnilnik.

Ta pristop ima resnične prednosti. Koda je vedno posodobljena — ni indeksa, ki bi zastarel. Ničesar ni treba konfigurirati. Vaša koda se ne pošilja v nobeno podatkovno zbirko.

Ima pa tudi slabost: vsaka nova naloga pomeni novo iskanje in branje datotek. Žetoni se porabljajo za ponovno ugotavljanje, kje je kaj, čeprav je Claude to že ugotovil v prejšnji seji. Večji kot je projekt, več stane to izvidovanje. Prav zaradi tega mehanizma se lahko zdi, da agent »bere vse«.

Koliko žetonov to v resnici porabi?#

Stroški nastanejo še pred vašo zahtevo. Neodvisna meritev to preprosto pokaže: Claude Code pošlje približno 33,000 žetonov sistemskega poziva in opisov orodij, še preden prebere prvi znak vašega sporočila. Za primerjavo: OpenCode začne pri približno 7,000.

Nato nastopi ponovno branje. Vsako iskanje datotek in vsako branje dodata žetone v kontekst. Uradna dokumentacija Claude Code to pove neposredno: branje datotek prevladuje pri porabi konteksta. Analiza datoteke auth.ts, ki vsebuje 2,400 žetonov, pomeni 2,400 žetonov, ki jih vidi samo Claude; enako velja za vsako datoteko, ki jo odpre med izvidovanjem.

Za naše bralce se to pozna pri denarju in omejitvah. Ljudje, ki se lotijo vibe codinga, se najbolj bojijo: »Plačal sem, pa so mi omejitve po nepotrebnem pošle.« Če agent pri vsaki nalogi pregleda projekt in znova prebere datoteke od začetka, se kontekst porablja dvakrat hitreje: najprej za sistemsko režijo, nato še za izvidovanje. V vodniku »Kam gredo žetoni Claude Code« sem predstavil celoten pregled tega, za kaj Claude Code porablja žetone — ponovno branje projekta je eden od devetih vzorcev.

Kaj je trajni spomin na kodo?#

Spomin na kodo odpravi prav tisto vrzel, zaradi katere Claude znova bere projekt. Zamisel je preprosta: naj nekaj enkrat pregleda vso kodo, iz nje izdela zemljevid in ga ohranja pri roki. Agentu potem ni treba vsakič iskati od začetka — vpraša zemljevid.

Tehnično deluje takole. Ločeno orodje pregleda projekt in ga razdeli na sestavne dele: katere funkcije in razredi obstajajo, kdo koga kliče in katere datoteke so povezane. Ta struktura se shrani na disk. Ko mora Claude razumeti, kje je logika za plačila ali kaj se bo pokvarilo, če uredite funkcijo, zemljevidu pošlje eno ciljno usmerjeno poizvedbo, namesto da bi prebral več deset datotek.

Zemljevid se poveže prek MCP — standardnega načina za priklop zunanjega orodja v Claude Code (povezovanje drugih strežnikov sem obravnaval v vodniku »MCP-strežniki za Claude Code«). Orodje za spomin na kodo doda svoje ukaze za iskanje po zemljevidu, Claude pa jih po potrebi sam uporablja za orientacijo v projektu.

V praksi je razlika med »preberi celotno mapo, da najdeš eno funkcijo« in »vprašaj zemljevid, kje je ta funkcija«. Prvi način stane več deset tisoč žetonov, drugi pa nekaj sto.

Dva pristopa k spominu na kodo: v čem se razlikujejo?#

Orodja za spomin na kodo se razlikujejo po tem, kaj zgradijo iz vašega projekta. Najlažje si jih predstavljate tako: eno vam da kirurško natančnost pri urejanju, drugo pa išče po pomenu.

Število zvezdic na GitHubu je stanje na 15. julij 2026 (po podatkih API-ja GitHub). Obe orodji sta brezplačni in odprtokodni, obe delujeta s Claude Code in obe se povežeta kot strežnika MCP.

Kratek povzetek za neprogramerje. Serena je kirurško orodje: uporabite jo, kadar urejate isti del projekta na več mestih in je natančnost pomembna. claude-context je iskanje po pomenu: kodo najde na podlagi opisa, vendar zahteva nastavitev podatkovne zbirke v oblaku in ključ.

Kdaj izbrati Sereno ali claude-context?#

Ti dve orodji ne tekmujeta za eno samo nagrado. Zapomnita si različne stvari, zato je izbira odvisna od naloge.

Sereno izberite, če veliko refaktorirate. Agentu omogoča navigacijo po kodi kot v inteligentnem razvojnem okolju: najde definicijo funkcije in vsa njena dejanska mesta klicev, nato pa funkcijo skrbno preimenuje ali zamenja njeno telo po celotnem projektu. Avtor prednost opiše takole.

Serena ne objavlja natančnega odstotka prihranka, zato ji ne bom pripisoval izmišljene številke. Njena prednost je drugačna: običajno iskanje vrne štirideset zadetkov, skupaj s komentarji in nizi, nato pa Claude prebere štiri celotne datoteke; Serena odgovori z nekaj natančnimi poizvedbami. To pomeni manj klicev in manj napačnih zadetkov, zato je manj verjetno, da bo agent uredil napačno stvar.

claude-context izberite, če potrebujete iskanje po pomenu in vas nastavitev ne odvrne. Kodo pretvori v vektorje (številske prstne odtise pomena) in išče po opisu: »poišči, kje je naša logika za plačila«, tudi če ne poznate imen funkcij. Cena takega iskanja je dodatna nastavitev.

claude-context potrebuje zunanjo vektorsko podatkovno zbirko, ključ ponudnika vektorskih vložitev in novejšo različico Node. Od obeh je zahtevnejši za nastavitev, zato priporočam začetnikom, da začnejo z drugim orodjem.

Kaj lahko počnete neposredno v Claude Code brez orodij drugih ponudnikov?#

Pred namestitvijo orodij drugih ponudnikov čim bolje izkoristite to, kar Claude Code že vključuje. Ti ukazi so brezplačni in delujejo takoj.

1. /context—prikaže sprotno razčlenitev tega, kar zaseda kontekstno okno: sistemski poziv, CLAUDE.md, pomnilnik, orodja in datoteke. Ukaz /mcp prikaže strošek vsakega povezanega strežnika, /memory pa pokaže, kaj se je naložilo ob zagonu.
2. /compact—stisne zgodovino pogovora v kratek povzetek in nadaljuje isto nalogo. Fokus lahko usmerite tako, da ukazu /compact dodate, kaj naj ohrani.
3. /clear—zavrže celotno zgodovino. Uradno priporočilo je, da ga zaženete ob prehodu na nepovezano nalogo, da stari pogovor ne izrine datotek, ki jih potrebujete.
4. /doctor (znan tudi kot /checkup, uveden 8. julija 2026)—diagnosticira nastavitev in predlaga popravke: odstrani podvojene vnose v CLAUDE.md, poišče neuporabljena orodja in strežnike ter zazna počasne obdelovalnike.

Posebna opomba o CLAUDE.md. Ta datoteka se naloži v kontekst na začetku vsake seje in je vključena v vsako sporočilo. Če je preobsežna, zanjo plačujete znova in znova. Uradno priporočilo je, da ostane krajša od 200 vrstic, podrobnosti za referenco pa premaknete v veščine, ki se naložijo po potrebi. O pravilni pripravi datoteke CLAUDE.md sem pisal v ločenem vodniku »Kako konfigurirati CLAUDE.md«.

Še ena vgrajena možnost so podagenti. Imajo ločen kontekst, zato jim lahko dodelite zahtevno branje in izvidovanje, ne da bi napihnili glavno okno. Anthropic splošno načelo v svoji inženirski analizi opiše takole.

Bo dodaten strežnik MCP še povečal kontekst?#

Nekoč je veljalo, da »en strežnik več pomeni več kontekstne režije«, vendar se je Claude Code spremenil. Opisi orodij MCP se zdaj privzeto nalagajo odloženo: ob zagonu so v kontekst vključena samo imena strežnikov, celotni opisi pa se naložijo, ko je za nalogo potrebno določeno orodje. Dokumentacija to pove neposredno.

Računica spomina na kodo je preprosta. Majhna, nespremenljiva režija zaradi imen orodij v primerjavi s tisoči prihranjenih žetonov, ker agentu ni več treba znova brati datotek. Razmerje je očitno v prid indeksu.

Nekaj poštenih opozoril, da ne bi pričakovali čudežev. Indeks je treba občasno znova zgraditi — zemljevid odraža kodo v času pregledovanja, po večjih spremembah pa ga je treba posodobiti (to je odvisno od orodja: nekatera to naredijo samodejno, pri drugih je potreben ukaz). Velike trditve, kot je »120-krat manj žetonov«, opisujejo najboljši primer pri izbranih poizvedbah, ne pa tega, kar boste dosegli pri vsaki nalogi. Dejanski prihranki so skromnejši, a še vedno opazni. Če vas zanima podrobnejši pregled, kako se na splošno izogniti porabi omejitev, sem pripravil ločeno analizo »Kako se izogniti porabi omejitev Claude Code«.

Kje začeti danes?#

Če odmislite vse nepotrebno, je današnji načrt preprost:

1. Zaženite /doctor in počistite predlagane stvari: podvojene vnose v CLAUDE.md in neuporabljena orodja.
2. Skrajšajte CLAUDE.md na 200 vrstic, gradivo za referenco pa premaknite v veščine.

Nato izberite glede na svoje potrebe: če veliko refaktorirate, dodajte Sereno za natančne popravke; če potrebujete iskanje po pomenu, nastavite claude-context. Spomin na kodo in urejen kontekst že danes rešita glavno težavo.

Če potrebujete dostop do modelov AI prek Ailoota, obiščite Ailoot.