Claude Code paměť: kompletní průvodce trvalým kontextem

Každá session Claude Code začíná stejně: žádná paměť na včerejšek. V pondělí strávíte dvacet minut vysvětlováním, jak funguje autentizace ve vašem API, a v úterý to vysvětlujete znovu, protože nic na tom, jak model funguje, to samo od sebe nepřenáší dál. Tahle mezera je nejčastěji požadovaná oprava, o kterou nás žádají týmy provozující Claude Code denně, a zároveň nejvíc nepochopená, protože „dej Claudovi paměť" není jedna funkce. Jsou to čtyři mechanismy s různou náplní práce, náklady a chybovými stavy.

Tenhle průvodce je roztřídí: co každá vrstva skutečně řeší, co kam patří, jak nastavit paměťový skill jako claude-mem, a tokenovou matematiku, která vysvětluje, proč je pamatování levné, zatímco znovuobjevování stejných faktů při každé session není.

Problém dne svišťe

Jazykový model nemá mezi voláními API žádný stav. Každá zpráva, kterou odešlete, obsahuje celou dosavadní konverzaci, a když ta konverzace skončí, skončí s ní i všechno, co model o vašem projektu „věděl". Otevřete zítra novou session a jste zpátky na čistém štítu, ať už na disku leží jakékoli soubory.

To by bylo v pořádku, kdyby sessions byly krátké a soběstačné. Nejsou. Skutečná práce se táhne přes dny: v pondělí opravíte bug, ve čtvrtek se stejný vzor objeví v jiném souboru, a agent nemá způsob, jak ty dvě věci propojit, pokud něco mimo konverzaci to propojení neneslo dál. Každá session bez toho platí daň za znovuobjevování: čtení stejných souborů, znovunaučení se stejných konvencí, občasné opakování chyby, kterou už jednou opravil.

Opravou není větší kontextové okno. Kontextová okna jsou už teď velká, a problém není kapacita, je to kontinuita. Chcete místo mimo konverzaci, kde fakta a rozhodnutí přežijí, plus způsob, jak Claude načte správný výřez tohoto místa zpátky, když na tom záleží. To je paměť, a Claude Code vám dává čtyři způsoby, jak ji vybudovat.

Čtyři vrstvy paměti Claude

Vrstva jedna je CLAUDE.md: statická fakta o projektu, která napíšete jednou a která se v plném rozsahu načtou na začátku každé session. Vrstva dva je auto-paměť, adresář souborů, do kterých si Claude zapisuje sám, hromadí fakta v čase, aniž byste je autorsky psali ručně. Vrstva tři jsou paměťové skilly, které automaticky zachytí a zkomprimují kontext session a později ho znovu vstříknou zpátky. Vrstva čtyři je nízkotechnologická volba: obyčejný soubor s poznámkami, který agent čte a aktualizuje, protože jste mu to řekli.

Nejsou to konkurenční možnosti. Řeší různé problémy, a většina seriózních nastavení jich provozuje dvě nebo tři najednou.

Vrstva 1: CLAUDE.md, statická fakta, která se vždy načtou

CLAUDE.md je nejstarší a nejjednodušší paměťový mechanismus Claude Code. Je to markdown soubor, který Claude Code najde procházením nahoru od vašeho pracovního adresáře, a načte se v plném rozsahu, každou session, dřív než cokoli napíšete. Díky tomu je to správné místo pro fakta, která platí skoro vždy: jak spustit testy, jaký balíčkovací manažer repozitář používá, která složka je legacy a mimo dosah.

Je to špatné místo pro cokoli, co se často mění nebo platí jen občas, protože „načte se v plném rozsahu, každou session" je zároveň jeho cena. CLAUDE.md o 3 000 řádcích je zhruba 30 000 tokenů zdaněných u každého požadavku, ať ho ten požadavek potřebuje, nebo ne. Kompletní aritmetiku a skutečný okomentovaný příklad pokrýváme v našem průvodci nejlepšími postupy pro CLAUDE.md; krátká verze je, že CLAUDE.md chce stabilní fakta, ne rostoucí log.

Tady taky CLAUDE.md dochází dech. Je statický: napíšete ho, Claude ho čte, a jeho aktualizace je ruční otrava, na kterou musíte pamatovat sami. Další tři vrstvy existují na to, aby zvládly fakta, která se hromadí sama.

Vrstva 2: auto-paměť a adresáře paměti

Prostřední vrstva je adresář paměti, často ~/.claude/memory/ nebo jeho projektový ekvivalent, kam si Claude zapisuje strukturované poznámky o tom, co se naučí, a při budoucích sessions si je zase přečte. Na rozdíl od CLAUDE.md většinu těchto záznamů nikdo ručně nepíše. Agent sám rozhodne, že něco stojí za zapamatování – rozhodnutí, které jste udělali, preference, kterou jste vyslovili, fakt, který si musel vyhrabat – a založí to se strukturou dostatečnou na pozdější vyhledání.

Tady žije skill Memory Management, nejlépe hodnocený skill v téhle kategorii na SkillProof: 9,2 z 10. Prohnali jsme ho celým týdnem skutečných sessions, ne jedním demo spuštěním, a obstál i při reálném používání. Claude spolehlivě vybavoval uložená projektová rozhodnutí a preference a přesnost vybavování zůstala vysoká i s rostoucím úložištěm – přesně ta část, která u naivních implementací obvykle selže první.

Co odlišuje tuhle vrstvu od CLAUDE.md, je to, že je selektivní jak při ukládání, tak při návratu zpátky. Dobře postavený paměťový skill indexuje, co má uloženo, a vytáhne relevantní výřez pro aktuální úkol, takže úložiště může narůst na tisíce záznamů, aniž by za ně všechny platila každá session.

Vrstva 3: paměťové skilly, claude-mem a automatické zachycení

Třetí vrstva posouvá myšlenku dál. Místo aby Claude uprostřed konverzace rozhodoval, co stojí za uložení, vyhrazený skill automaticky zachytí celou session, zkomprimuje ji a relevantní kontext vstříkne zpátky do té příští. Claude-mem je nejjasnější příklad tohoto vzoru. Jeho slogan je „trvalý kontext napříč sessions pro každého agenta": sleduje, co váš agent během session dělá, tuhle aktivitu zkomprimuje AI sumarizačním průchodem a zkomprimovanou verzi vynese na povrch příště, kdy je relevantní, napříč Claude Code a podle vlastní dokumentace i několika dalšími agentními runtime prostředími.

Měli bychom být na rovinu ohledně toho, kde v našem testování stojí. Claude-mem se objevil přes náš GitHub crawler s 85 685 hvězdičkami, a proto je zařazený do fronty na plný test místo toho, aby už nesl verdikt; skóre nepublikujeme, dokud jsme skill nenainstalovali na čisto a neprohnali skutečnou prací – stejná laťka, kterou už zdolal Memory Management. Co teď můžeme říct, je architektonické: automatické zachycení odstraňuje moment, kdy byste jinak uprostřed session zastavili a rozhodovali, jestli něco stojí za zapamatování. Skill to rozhoduje za vás. Jestli to obstojí přes celý týden na čistém stroji, na to má odpovědět fronta testů.

Vrstva 4: obyčejné soubory jako paměť

Poslední vrstva vůbec nepotřebuje skill: obyčejný markdown soubor, obvykle pojmenovaný něco jako notes.md nebo progress.md, o kterém Clauda požádáte, aby ho přečetl na začátku session a aktualizoval na konci. Žádné indexování, žádné automatické zachycení, žádné hodnocení. Paměťový systém jste vy; soubor je jen místo, kam si to zapíšete.

Tahle vrstva bývá podceňovaná, protože zní na to, aby na ní záleželo, moc jednoduše. Není to tak. U samostatného projektu s jedním přispěvatelem a hrstkou běžících vláken soubor s poznámkami, který skutečně udržujete, poráží automatizovaný paměťový systém, do kterého se nikdy nepodíváte. Chybový stav ale leží celý na vás: nikdo ho neprořezává, nikdo neoznačuje rozpory, a naroste do zdi textu se stejnými slepými skvrnami, jaké se vyvinou u jakéhokoli neudržovaného dokumentu. Funguje přesně tak dobře, jak dobrá je vaše disciplína při jeho aktualizaci, ne líp.

Co kam patří: rozhodovací tabulka

Typ paměti	Nejlepší pro	Načítá se	Údržba
CLAUDE.md	Stabilní, vždy platná fakta (build příkazy, konvence, záludnosti)	V plném rozsahu, každou session	Ruční, upravujete sami
Auto-paměť / adresář paměti	Rozhodnutí a preference, které se hromadí v čase	Selektivně, při vyhledání	Většinou automatická (spravovaná skillem)
Paměťové skilly (claude-mem)	Celý kontext session, zachycený bez vašeho rozhodování, co je důležité	Zkomprimovaně, vstříknuto, když je relevantní	Automatické zachycení, občasná kontrola
Obyčejný soubor s poznámkami	Samostatné projekty, jednoduchá běžící vlákna	Ručně, řeknete Claudovi, ať ho přečte	Zcela ruční

Čtěte tuhle tabulku podle toho, co se mění, ne podle toho, co je pohodlné nastavit. Pokud by fakt platil i za šest měsíců, patří do CLAUDE.md. Pokud je to rozhodnutí učiněné tento týden, na kterém by mohlo záležet i později, patří do paměti. Pokud nedokážete předvídat, co budete potřebovat si pamatovat, a nechcete rozhodovat v moment, je to případ pro automatické zachycení. Pokud nic z toho neplatí, soubor s poznámkami pořád poráží nic.

Nastavení claude-mem krok za krokem

Obecný vzor pro paměťový skill s automatickým zachycením vypadá takto, s claude-mem jako konkrétním příkladem:

1. Naklonujte skill. git clone https://github.com/thedotmack/claude-mem do pracovního adresáře, pak postupujte podle instalačního skriptu repozitáře místo ručního kopírování souborů. Paměťové skilly obvykle potřebují registrovat hook, ne jen vložit SKILL.md na místo.

2. Restartujte Claude Code. Instalace obvykle zapojí hook na začátek nebo konec session, aby zachytávání probíhalo bez toho, abyste cokoli sami vyvolávali. Restart je to, co ten hook aktivuje.

3. Spusťte běžnou session. Netestujte to na hračkovém úkolu. Dělejte skutečnou práci; smysl je vidět, co skill uzná za hodné zapamatování, když se nikdo na test nedívá.

4. Spusťte další session a zkontrolujte, co se vrátilo. Zeptejte se Clauda, co si pamatuje o včerejší práci, ještě než sami cokoli řeknete. Něco konkrétního a správného znamená, že zachytávání funguje. Cokoli vágní nebo špatné znamená, zkontrolujte konfiguraci, než tomu svěříte něco, na čem záleží.

5. Nastavte si rytmus kontroly. Automatické zachytávání bez kontroly se promění v automatickou akumulaci šumu. Dejte si opakovaný desetiminutový slot na projití toho, co se uložilo (víc o tom níže pod hygienou paměti).

Pokud chcete raději začít s něčím, co už je otestované, Memory Management je ruční, ale ověřená cesta: nainstalujte složku skillu do ~/.claude/skills/, a při prvním použití si vytvoří vlastní adresář paměti, bez potřeby zvlášť instalovat hook.

Tokenová ekonomika paměti

Tady je matematika, díky které se paměť vyplatí i s náklady na nastavení. Řekněme, že vysvětlení projektového faktu od nuly zabere 500 slov: tvar vaší autentizace, proč má konkrétní tabulka dva cizí klíče, co dělá deploy skript. Vysvětlené znovu v chatu je to zhruba 650 tokenů vstupu pokaždé, kdy to znovu vysvětlujete, k tomu čas, který strávíte psaním, a čas, který Claude stráví uvažováním nad tím v dané zprávě.

Uložený v paměti místo toho stojí ten samý fakt těch 650 tokenů jednou, na zápis. Následné vyhledání stojí zlomek toho: dobře indexovaná paměťová vrstva vytáhne zkomprimované shrnutí, často pod 100 tokenů, jen když se aktuálního úkolu ten fakt týká. Vysvětlete to v chatu pětkrát za měsíc a utratili jste zhruba 3 250 tokenů na opětovné učení něčeho, co by paměť stálo 650 tokenů na naučení a celkem 500 na pětinásobné vybavení: hrubý poměr pět ku jedné, který se rozšiřuje s tím, jak často je fakt potřeba.

Srovnejte to s natlačením všeho do CLAUDE.md místo toho: fakt relevantní jednu session z dvaceti se stejně načte i u zbylých devatenácti, bez selektivity, která by ten náklad získala zpátky. Pevná preambule, kterou vaše nastavení nese v každém tahu (CLAUDE.md, schémata nástrojů, vstřikování paměti), přímo soupeří o prostor a pozornost se skutečnou prací. Změřili jsme to podrobněji, se skutečnými počty tokenů před/po, v našem průvodci tokenovými náklady; paměť je jedna položka v tomto větším obrazu, často nejlevnější oprava vzhledem k tomu, co ušetří.

Hygiena paměti: rituál kontroly

Paměťový systém, který jen hromadí, není funkce, je to pomalý únik. Zastaralé záznamy neselhávají hlasitě; nic nespadne, když si Claude vybaví rozhodnutí, které jste před třemi týdny zvrátili. Prostě tiše jedná podle zastaralé informace a vy pálíte čas na debugování toho, proč je agent sebejistě špatně u něčeho, o čem víte, že jste to opravili.

Provádějte měsíční průchod, deset minut, stejná disciplína jako u rituálu kontroly CLAUDE.md, který doporučujeme jinde. Otevřete paměťové úložiště. U každého záznamu, který vypadá nosně, se zeptejte, jestli je pořád pravdivý, jestli se rozhodnutí, které popisuje, mezitím nezvrátilo, a jestli je dost konkrétní na to, aby se podle něj dalo jednat. Smažte cokoli, co selže. Paměťové úložiště, na které jste hrdí, je po roce menší, než bylo po třech měsících; růst by měl být v přesnosti, ne v objemu.

Nejspolehlivější spouštěč kontroly ale není kalendář. Je to moment, kdy Claude udělá něco špatně kvůli zastaralé paměti. Zacházejte s tím jako s bugem: opravte záznam ve stejném dechu jako chybu, ne až při dalším naplánovaném průchodu.

Soukromí: co se zachycuje a kde to žije

Paměťové skilly čtou, co se děje ve vašich sessions, takže poctivá otázka je, co se zachycuje a kde to skončí. U paměti založené na souborech, ať už Memory Management, claude-mem, nebo přístup s obyčejnými poznámkami, je odpověď obvykle stejná: všechno se zapisuje do obyčejných souborů na vašem vlastním disku, obvykle pod ~/.claude/ nebo do projektové paměťové složky, ne na server třetí strany. Nic neopustí váš stroj, pokud ty soubory nezacommitujete do sdíleného repozitáře nebo pokud skill výslovně nedokumentuje funkci vzdálené synchronizace.

To je dobrá zpráva pro kontrolu a špatná zpráva pro předpoklad, že je to automaticky bezpečné. Paměťový soubor je záznam v čistém textu o tom, na čem jste pracovali, a může obsahovat přihlašovací údaje zmíněné mimochodem, jména klientů nebo architektonické detaily, které byste nechtěli mít ve veřejném repozitáři. Přečtěte si, co je skutečně v adresáři paměti, než ho zacommitujete vedle svého kódu, a než nainstalujete jakýkoli paměťový skill, zkontrolujte jeho zdrojový kód kvůli tomu, co „zachycuje všechno, co váš agent dělá" skutečně znamená, včetně toho, jestli se do toho zamete i výstup příkazů obsahující tajemství. Automatické zachytávání si zaslouží stejnou obezřetnost jako jakýkoli nástroj, který čte váš terminál.

FAQ

Má Claude Code vestavěnou trvalou paměť?

Částečně. CLAUDE.md vám hned po vybalení dává statickou, vždy načtenou paměť, a je to skutečně vestavěné, bez potřeby instalace. Cokoli za hranicí statických faktů – paměť, která se hromadí, indexuje a selektivně vyhledává – v současnosti pochází ze skillu, ne z nativní funkce.

Jaký je rozdíl mezi CLAUDE.md a paměťovým skillem?

CLAUDE.md se načítá v plném rozsahu, každou session, a udržujete ho ručně. Paměťový skill zapisuje a čte rostoucí úložiště selektivně, vytahuje jen to, co je relevantní pro aktuální úkol, a velkou část zápisu proběhne bez toho, abyste to dělali ručně. Použijte CLAUDE.md pro fakta, která se nikdy nemění; použijte paměťový skill pro fakta, která se hromadí.

Je bezpečné nainstalovat claude-mem právě teď?

Zatím mu nemůžeme dát verdikt. Je v naší testovací frontě, nehodnocený, navzdory velké oblibě na GitHubu. Nainstalujte ho tak, jak byste instalovali cokoli nehodnoceného: nejdřív na projekt, na kterém si můžete dovolit experimentovat, a přečtěte si zdrojový kód předtím, než mu svěříte citlivé sessions.

Kolik stojí provoz paměťového skillu v tokenech?

Skoro ve všech případech míň než alternativa. Samotné ukládání je téměř zadarmo, protože žije na disku, ne v kontextu. Vyhledání na začátku session obvykle stojí mnohem míň než opětovné vysvětlování stejného faktu v chatu, a propast se rozšiřuje s tím, kolikrát by se ten fakt jinak musel znovu vysvětlovat.

Měl bych používat víc než jednu paměťovou vrstvu najednou?

Ano, a většina fungujících nastavení to tak dělá: CLAUDE.md pro fakta, která se nikdy nemění, plus buď paměťový skill, nebo disciplinovaný soubor s poznámkami pro fakta, která se hromadí. Zacházejte s nimi jako s doplňujícími se, místo abyste si vybírali favorita. Smyslem je spárovat každý typ faktu s vrstvou pro něj postavenou, ne spokojit se s jedním mechanismem na všechno.