Proč Claude Code znovu pročítá celý projekt a jak to napravit

Dokumentace Ailoot: API, klíče a připojení.

Proč Claude Code pokaždé znovu pročítá projekt od začátku?#

Mnoho lidí si myslí, že jde o chybu. Ve skutečnosti je Claude Code takto navržen: nemá vlastní index projektu. Když ho požádáte, aby něco opravil, nemá po ruce hotovou mapu kódu — projekt znovu prozkoumává: hledá relevantní soubory, vyhledává potřebné řetězce a načítá soubory do paměti.

Tento přístup má skutečné výhody. Kód je vždy aktuální — neexistuje index, který by zastaral. Není třeba nic nastavovat. Váš kód se neposílá do žádné databáze.

Má to ale i nevýhodu: každý nový úkol znamená další hledání a čtení souborů. Tokeny se utrácejí za opětovné zjišťování, kde co je, přestože to Claude zjistil už v předchozí relaci. Čím větší projekt, tím více tento průzkum stojí. Právě proto může mít člověk pocit, že agent „čte všechno“.

Kolik tokenů spotřebuje opakované čtení projektu v Claude Code?#

Náklady vznikají ještě před vaším požadavkem. Jedno nezávislé měření ukázalo, že Claude Code odešle přibližně 33 000 tokenů systémového promptu a popisů nástrojů ještě před načtením prvního znaku vaší zprávy. Pro srovnání, OpenCode začíná přibližně na 7 000.

Pak přichází na řadu opětovné čtení. Každé hledání souborů a každé jejich načtení přidává tokeny do kontextu. Oficiální dokumentace Claude Code to říká přímo: využití kontextu převažujícím způsobem tvoří čtení souborů. Analýza souboru auth.ts o rozsahu 2 400 tokenů znamená 2 400 tokenů, které viděl pouze Claude. Totéž platí pro každý soubor, který otevře při průzkumu.

Pro naše publikum se to promítá do peněz a limitů. Největší obavou lidí, kteří začínají s vibe codingem, je: „Zaplatil jsem a limity se vyčerpaly úplně zbytečně.“ Pokud agent při každém úkolu prohledává projekt a znovu čte soubory od začátku, kontext se spotřebovává dvakrát rychleji: nejprve na systémovou režii a pak na průzkum. Celý přehled, kam přesně mizí tokeny Claude Code, jsem popsal v návodu „Kam mizí tokeny Claude Code“ — opětovné čtení projektu je jedním z devíti vzorců, které tam najdete.

Co je trvalá paměť kódu?#

Paměť kódu řeší přesně tu mezeru, kvůli které Claude znovu pročítá projekt. Myšlenka je jednoduchá: nechat něco jednou prohledat všechen kód, vytvořit z něj mapu a mít ji připravenou k použití. Agent pak nemusí pokaždé hledat od začátku — zeptá se mapy.

Technicky to funguje takto. Samostatný nástroj prohledá projekt a rozdělí ho na součásti: jaké funkce a třídy existují, kdo koho volá a které soubory spolu souvisejí. Tato struktura se uloží na disk. Když Claude potřebuje zjistit, kde je logika plateb nebo co se rozbije po úpravě funkce, odešle jeden cílený dotaz mapě místo čtení desítek souborů.

Tato mapa se připojuje přes MCP — standardní způsob, jak ke Claude Code připojit externí nástroj. Připojování dalších serverů jsem popsal v návodu „MCP servery pro Claude Code“. Nástroj paměti kódu přidává vlastní příkazy pro hledání v mapě a Claude je sám použije, když se potřebuje v projektu zorientovat.

V praxi jde o rozdíl mezi „přečíst celou složku a najít jednu funkci“ a „zeptat se mapy, kde tato funkce je“. První možnost stojí desítky tisíc tokenů, druhá stovky.

Dva přístupy k paměti kódu: v čem se liší?#

Nástroje paměti kódu se liší tím, co z vašeho projektu vytvářejí. Nejjednodušší je představit si to takto: jeden vám při úpravách propůjčuje ruce chirurga a druhý hledá podle významu.

Počty hvězdiček na GitHubu jsou k 15. červenci 2026 (podle GitHub API). Oba nástroje jsou zdarma a mají otevřený zdrojový kód, oba fungují s Claude Code a oba se připojují jako servery MCP.

Stručně pro neprogramátory: Serena je chirurgova ruka: použijte ji, když upravujete stejnou část napříč projektem a záleží na přesnosti. claude-context vyhledává podle významu: najde kód podle popisu, ale je třeba nastavit cloudovou databázi a klíč.

Kdy zvolit Serenu nebo claude-context?#

Tyto dva nástroje nesoupeří o jedinou cenu. Každý si pamatuje něco jiného, takže výběr závisí na úkolu.

Serenu zvolte, pokud často refaktorujete. Poskytuje agentovi navigaci v kódu jako v inteligentním vývojovém prostředí: najde definici funkce a všechna skutečná místa, odkud se volá, a pak funkci pečlivě přejmenuje nebo napříč projektem nahradí její tělo. Autor popisuje její přínos takto.

Serena neuvádí přesné procento úspory a já jí nebudu připisovat vymyšlené číslo. Její přínos je jiný: běžné vyhledávání vrátí čtyřicet shod včetně komentářů a řetězců a Claude pak přečte čtyři celé soubory, zatímco Serena odpoví několika přesnými dotazy. To znamená méně volání a méně chybných shod, a tedy menší riziko, že agent upraví nesprávnou věc.

claude-context zvolte, pokud potřebujete vyhledávání podle významu a složitější nastavení vám nevadí. Převádí kód na vektory (číselné otisky významu) a vyhledává podle popisu: „najdi, kde je naše platební logika“, i když neznáte názvy funkcí. Cenou za toto vyhledávání je dodatečné nastavení.

claude-context vyžaduje externí vektorovou databázi, klíč poskytovatele embeddingů a aktuální verzi Node. Nastavení je z obou nástrojů složitější, proto začátečníkům doporučuji začít něčím jiným.

Co můžete dělat přímo v Claude Code bez nástrojů třetích stran?#

Než nainstalujete nástroje třetích stran, využijte naplno možnosti, které Claude Code už obsahuje. Tyto příkazy jsou zdarma a fungují bez dalšího nastavování.

1. /context — zobrazuje aktuální rozpis toho, co zabírá kontextové okno: systémový prompt, CLAUDE.md, paměť, nástroje a soubory. Příkaz /mcp ukazuje náklady každého připojeného serveru a /memory ukazuje, co se načetlo při spuštění.
2. /compact — zkrátí historii konverzace do stručného shrnutí a pokračuje ve stejném úkolu. Zaměření můžete usměrnit tím, že do /compact přidáte, co má zachovat.
3. /clear — zahodí celou historii. Oficiální doporučení říká spustit tento příkaz při přechodu k nesouvisejícímu úkolu, aby stará konverzace nezabírala místo souborům, které potřebujete.
4. /doctor (také známý jako /checkup, představený 8. července 2026) — diagnostikuje nastavení a navrhuje opravy: odstraňuje duplicity v CLAUDE.md, hledá nepoužívané nástroje a servery a odhaluje pomalé obslužné rutiny.

Samostatná poznámka k souboru CLAUDE.md. Načítá se do kontextu na začátku každé relace a přikládá se ke každé zprávě. Pokud je příliš rozsáhlý, stále za něj platíte. Oficiální doporučení je udržet ho pod 200 řádky a přesunout referenční podrobnosti do dovedností, které se načítají podle potřeby. Správné sestavení souboru CLAUDE.md jsem popsal v samostatném návodu „Jak nakonfigurovat CLAUDE.md“.

Další vestavěnou možností jsou subagenti. Mají vlastní oddělený kontext, takže jim můžete svěřit náročné čtení a průzkum, aniž by se tím rozrostlo vaše hlavní okno. Anthropic ve své technické analýze uvádí obecnou zásadu takto.

Zvětší další MCP server kontext ještě víc?#

Logika „další server znamená větší režii kontextu“ dříve platila, ale Claude Code se změnil. Popisy nástrojů MCP se nyní ve výchozím nastavení načítají odloženě: při spuštění jsou v kontextu jen názvy serverů a úplné popisy se načtou, až když konkrétní nástroj potřebujete pro daný úkol. Dokumentace to uvádí přímo.

Výpočet u paměti kódu je jednoduchý: malá, pevná režie za názvy nástrojů oproti tisícům ušetřených tokenů, protože agent už znovu nečte soubory. Výsledek jednoznačně hovoří ve prospěch indexu.

Několik poctivých upozornění, abyste nečekali zázraky. Index je potřeba občas znovu vytvořit — mapa zachycuje kód v okamžiku skenování a po větších úpravách je třeba ji aktualizovat (liší se to podle nástroje: některé to dělají automaticky, u jiných je třeba spustit příkaz). A velká tvrzení jako „120× méně tokenů“ popisují nejlepší případ u vybraných dotazů, nikoli výsledek, který uvidíte při každém úkolu. Skutečná úspora je skromnější, ale stále znatelná. Pokud chcete podrobněji prozkoumat, jak se obecně vyhnout vyčerpání limitů, mám samostatný rozbor „Jak se vyhnout vyčerpání limitů Claude Code“.

Kde dnes začít?#

Když vypustíme všechno zbytečné, dnešní plán je jednoduchý:

1. Spusťte /doctor a odstraňte to, co doporučí: duplicity v CLAUDE.md a nepoužívané nástroje.
2. Zkraťte CLAUDE.md na 200 řádků a přesuňte referenční materiály do dovedností.

Potom vybírejte podle svých potřeb: pokud často refaktorujete, přidejte Serenu pro přesné úpravy; pokud potřebujete vyhledávání podle významu, nastavte claude-context. Hlavní problém dnes vyřeší paměť kódu a čistý kontext.

Pokud potřebujete přístup k modelům AI přes Ailoot, podívejte se na Ailoot.