Prečo Claude Code znova číta celý projekt a ako to napraviť

Dokumentácia Ailoot: API, kľúče a pripojenie.

Prečo Claude Code zakaždým znova číta projekt od začiatku?#

Mnohí si myslia, že ide o chybu. V skutočnosti je však Claude Code navrhnutý práve takto: nemá vlastný index projektu. Keď ho požiadate, aby niečo opravil, nemá poruke hotovú mapu kódu — projekt znova preskúma: nájde relevantné súbory, vyhľadá potrebné reťazce a načíta súbory do pamäte.

Tento prístup má skutočné výhody. Kód je vždy aktuálny — neexistuje index, ktorý by zastaral. Nič netreba konfigurovať. Váš kód sa neposiela do žiadnej databázy.

Má to však aj nevýhodu: každá nová úloha znamená ďalšie kolo vyhľadávania a čítania súborov. Tokeny sa míňajú na opätovné zisťovanie, kde sa čo nachádza, hoci Claude to už zistilo v predchádzajúcej relácii. Čím väčší projekt, tým viac tento prieskum stojí. Práve preto môže mať človek pocit, že agent „číta všetko“.

Koľko tokenov sa tým naozaj minie?#

Náklady vznikajú ešte pred vašou požiadavkou. Jedno nezávislé meranie to jednoducho ukazuje: Claude Code odošle približne 33 000 tokenov systémovej výzvy a opisov nástrojov ešte pred prečítaním prvého znaku vašej správy. Na porovnanie, OpenCode začína približne na 7 000.

Potom prichádza na rad opätovné čítanie. Každé vyhľadanie súborov a každé čítanie pridávajú tokeny do kontextu. Oficiálna dokumentácia Claude Code to hovorí priamo: čítanie súborov dominuje využitiu kontextu. Analýza súboru auth.ts s 2 400 tokenmi znamená 2 400 tokenov, ktoré vidí iba Claude; to isté platí pre každý súbor, ktorý otvorí počas prieskumu.

Pre naše publikum sa to premieta do peňazí a limitov. Najväčšou obavou ľudí, ktorí začínajú s vibe codingom, je: „Zaplatil som a limity sa mi zbytočne minuli.“ Ak agent pri každej úlohe prehľadáva projekt a znova číta súbory od začiatku, kontext sa míňa dvakrát rýchlejšie: najprv na režijné náklady systému a potom na prieskum. Úplnú mapu toho, kam presne smerujú tokeny Claude Code, som opísal v sprievodcovi „Kam smerujú tokeny Claude Code“ — opätovné čítanie projektu je jedným z deviatich vzorcov.

Čo je trvalá pamäť kódu?#

Pamäť kódu rieši presne tú medzeru, pre ktorú Claude znova číta projekt. Myšlienka je jednoduchá: nechať niečo raz preskenovať celý kód, vytvoriť z neho mapu a mať ju poruke. Agent potom nemusí zakaždým vyhľadávať od začiatku — opýta sa mapy.

Technicky to funguje takto. Samostatný nástroj preskenuje projekt a rozdelí ho na súčasti: aké funkcie a triedy existujú, kto koho volá a ktoré súbory spolu súvisia. Táto štruktúra sa uloží na disk. Keď Claude potrebuje zistiť, kde sa nachádza logika platieb alebo čo sa pokazí po úprave funkcie, odošle jeden cielený dotaz do mapy namiesto čítania desiatok súborov.

Táto mapa sa pripája cez MCP — štandardný spôsob, ako pripojiť externý nástroj k Claude Code (pripájaniu ďalších serverov som sa venoval v sprievodcovi „Servery MCP pre Claude Code“). Nástroj pamäte kódu pridá vlastné príkazy na vyhľadávanie v mape a Claude ich používa samostatne, keď sa potrebuje zorientovať v projekte.

V praxi je rozdiel medzi „prečítaj celý priečinok a nájdi jednu funkciu“ a „spýtaj sa mapy, kde tá funkcia je“. Prvý spôsob stojí desiatky tisíc tokenov, druhý stovky.

Dva prístupy k pamäti kódu: v čom sa líšia?#

Nástroje pamäte kódu sa líšia tým, čo vytvárajú z vášho projektu. Najjednoduchšie si ich predstaviť takto: jeden dá agentovi chirurgicky presné možnosti úprav a druhý vyhľadáva podľa významu.

Počty hviezdičiek na GitHube sú platné k 15. júlu 2026 (podľa GitHub API). Oba nástroje sú bezplatné a s otvoreným zdrojovým kódom, fungujú s Claude Code a pripájajú sa ako servery MCP.

Krátke zhrnutie pre neprogramátorov. Serena sú chirurgicky presné ruky: použite ju, keď upravujete tú istú časť naprieč projektom a záleží na presnosti. claude-context je vyhľadávanie podľa významu: nájde kód podľa opisu, ale vyžaduje nastavenie cloudovej databázy a kľúč.

Kedy si vybrať Serenu alebo claude-context?#

Tieto dva nástroje nesúťažia o jednu jedinú cenu. Každý si pamätá niečo iné, takže výber závisí od úlohy.

Serenu si vyberte, ak často refaktorujete. Agentovi poskytuje navigáciu v kóde ako v inteligentnom vývojovom prostredí: nájde definíciu funkcie a všetky jej skutočné miesta volania a potom funkciu starostlivo premenuje alebo nahradí jej telo naprieč projektom. Autor opisuje výhodu takto.

Serena nezverejňuje presné percento úspory a nebudem jej pripisovať vymyslené číslo. Výhoda je iná: bežné vyhľadávanie vráti štyridsať zhôd vrátane komentárov a reťazcov, po čom Claude prečíta štyri celé súbory; Serena odpovie niekoľkými presnými dotazmi. To znamená menej volaní a menej nesprávnych zhôd, a teda nižšie riziko, že agent upraví nesprávnu vec.

claude-context si vyberte, ak potrebujete vyhľadávanie podľa významu a neodrádza vás nastavovanie. Premieňa kód na vektory (číselné odtlačky významu) a vyhľadáva podľa opisu: „nájdi, kde je naša logika platieb“, aj keď nepoznáte názvy funkcií. Cenou za toto vyhľadávanie je dodatočné nastavovanie.

claude-context vyžaduje externú vektorovú databázu, kľúč poskytovateľa embeddings a aktuálnu verziu Node. Z týchto dvoch nástrojov sa nastavuje zložitejšie, preto odporúčam začiatočníkom začať s niečím iným.

Čo môžete robiť priamo v Claude Code bez nástrojov tretích strán?#

Pred inštaláciou nástrojov tretích strán využite naplno to, čo už Claude Code obsahuje. Tieto príkazy sú bezplatné a fungujú hneď po spustení.

1. /context—zobrazuje aktuálny prehľad toho, čo zaberá okno: systémová výzva, CLAUDE.md, pamäť, nástroje a súbory. Príkaz /mcp zobrazuje náklady každého pripojeného servera a /memory ukazuje, čo sa načítalo pri spustení.
2. /compact—skomprimuje históriu konverzácie do krátkeho súhrnu a pokračuje v tej istej úlohe. Môžete usmerniť, na čo sa má zamerať, tým, že do /compact pridáte, čo sa má zachovať.
3. /clear—zahodí celú históriu. Oficiálne odporúčanie hovorí spustiť ho pri prechode na nesúvisiacu úlohu, aby stará konverzácia nevytláčala súbory, ktoré potrebujete.
4. /doctor (známy aj ako /checkup, predstavený 8. júla 2026)—diagnostikuje konfiguráciu a navrhuje opravy: odstraňuje duplicitné položky v CLAUDE.md, nachádza nepoužívané nástroje a servery a odhaľuje pomalé obslužné rutiny.

Samostatná poznámka k CLAUDE.md. Tento súbor sa načíta do kontextu na začiatku každej relácie a je súčasťou každej správy. Ak je príliš veľký, stále zaň platíte. Oficiálne odporúčanie je udržiavať ho pod 200 riadkami a presunúť referenčné podrobnosti do zručností, ktoré sa načítajú podľa potreby. V samostatnom sprievodcovi „Ako nakonfigurovať CLAUDE.md“ som vysvetlil, ako CLAUDE.md správne zostaviť.

Ďalším vstavaným nástrojom sú subagenti. Majú vlastný samostatný kontext, takže im môžete zveriť rozsiahle čítanie a prieskum bez nafukovania hlavného okna. Anthropic vo svojej technickej analýze formuluje všeobecnú zásadu takto.

Zväčší ďalší server MCP kontext ešte viac?#

Úvaha, že „ďalší server znamená väčšiu režijnú záťaž kontextu“, kedysi platila, no Claude Code sa zmenilo. Opisy nástrojov MCP sa teraz predvolene odkladajú: pri spustení sa do kontextu zahrnú iba názvy serverov a úplné opisy sa načítajú, keď je pre danú úlohu potrebný konkrétny nástroj. Dokumentácia to uvádza priamo.

Výpočet prínosu pamäte kódu je jednoduchý. Malá, pevná réžia za názvy nástrojov oproti tisícom ušetrených tokenov, pretože agent už znova nečíta súbory. Bilancia jednoznačne hovorí v prospech indexu.

Niekoľko úprimných výhrad, aby ste nečakali zázraky. Index treba občas znova zostaviť — mapa odráža kód v stave, v akom bol počas skenovania, a po väčších úpravách ju treba aktualizovať (závisí to od nástroja: niektoré to robia automaticky, iné vyžadujú príkaz). A veľké tvrdenia ako „120-krát menej tokenov“ opisujú najlepší prípad pri vybraných dotazoch, nie to, čo uvidíte pri každej úlohe. Skutočná úspora je skromnejšia, ale stále citeľná. Ak chcete podrobnejšie zistiť, ako sa všeobecne vyhnúť vyčerpaniu limitov, mám samostatnú analýzu „Ako nevyčerpať limity Claude Code“.

Kde začať dnes?#

Ak odfiltrujete všetko nepotrebné, dnešný plán je jednoduchý:

1. Spustite /doctor a odstráňte to, čo navrhne: duplicity v CLAUDE.md a nepoužívané nástroje.
2. Skráťte CLAUDE.md na 200 riadkov a referenčný materiál presuňte do zručností.

Potom si vyberte podľa svojich potrieb: ak často refaktorujete, pridajte Serenu na presné úpravy; ak potrebujete vyhľadávanie podľa významu, nastavte claude-context. Pamäť kódu a čistý kontext už dnes riešia hlavný problém.

Ak potrebujete prístup k modelom AI cez Ailoot, pozrite si Ailoot.