Pamięć w Claude Code: pełny przewodnik po kontekście

Każda sesja Claude Code zaczyna się tak samo: bez pamięci o wczoraj. Spędzasz dwadzieścia minut, tłumacząc przepływ autoryzacji swojego API w poniedziałek, a we wtorek tłumaczysz go znowu, bo nic w sposobie działania modelu nie przenosi tego samo z siebie dalej. Ta luka to najczęściej zgłaszana poprawka, jaką słyszymy od zespołów uruchamiających Claude Code codziennie, i też najbardziej niezrozumiana, bo „daj Claude pamięć" to nie jedna funkcja. To cztery mechanizmy o różnych rolach, kosztach i trybach awarii.

Ten przewodnik je porządkuje: co faktycznie rozwiązuje każda warstwa, co należy do której, jak skonfigurować skill pamięciowy jak claude-mem i matematykę tokenów wyjaśniającą, dlaczego pamiętanie jest tanie, a odkrywanie tych samych faktów na nowo co sesję — nie.

Problem dnia świstaka

Model językowy nie ma stanu między wywołaniami API. Każda wysłana wiadomość zawiera całą dotychczasową rozmowę, a gdy ta rozmowa się kończy, kończy się też wszystko, co model „wiedział" o twoim projekcie. Otwórz nową sesję jutro i wracasz do czystej karty, niezależnie od tego, jakie pliki akurat siedzą na dysku.

Byłoby to w porządku, gdyby sesje były krótkie i samowystarczalne. Nie są. Realna praca rozciąga się na dni: naprawiasz buga w poniedziałek, ten sam wzorzec pojawia się w innym pliku w czwartek, a agent nie ma sposobu, by połączyć te dwie rzeczy, chyba że coś poza rozmową przeniosło to połączenie dalej. Każda sesja bez tego płaci podatek ponownego odkrywania: czytanie tych samych plików, ponowna nauka tych samych konwencji, okazjonalne powtórzenie błędu, który już naprawił.

Naprawą nie jest większe okno kontekstu. Okna kontekstu są już duże, a problemem nie jest pojemność, tylko ciągłość. Czego chcesz, to miejsce poza rozmową, gdzie fakty i decyzje przetrwają, plus sposób, by Claude załadował z powrotem właściwy wycinek tego miejsca, gdy ma to znaczenie. To jest pamięć, a Claude Code daje ci cztery sposoby, żeby ją zbudować.

Cztery warstwy pamięci Claude

Warstwa pierwsza to CLAUDE.md: statyczne fakty o projekcie, które piszesz raz, a które ładują się w całości na początku każdej sesji. Warstwa druga to auto-pamięć, katalog plików, do których Claude sam pisze, gromadząc fakty w czasie bez ręcznego autorstwa z twojej strony. Warstwa trzecia to skille pamięciowe, które automatycznie przechwytują i kompresują kontekst sesji, a potem wstrzykują go z powrotem później. Warstwa czwarta to opcja niskotechnologiczna: zwykły plik notatek, który agent czyta i aktualizuje, bo mu tak kazałeś.

Nie konkurują ze sobą. Rozwiązują różne problemy, a większość poważnych setupów uruchamia dwie albo trzy naraz.

Warstwa 1: CLAUDE.md, statyczne fakty ładowane zawsze

CLAUDE.md to najstarszy i najprostszy mechanizm pamięci Claude Code. To plik markdown, który Claude Code znajduje, idąc w górę od twojego katalogu roboczego, i ładuje się w całości, co sesję, zanim cokolwiek wpiszesz. To czyni go właściwym miejscem na fakty prawdziwe niemal zawsze: jak uruchomić testy, jakiego menedżera pakietów używa repo, który folder jest przestarzały i zabroniony.

To złe miejsce na cokolwiek, co często się zmienia albo stosuje okazjonalnie, bo „ładuje się w całości, co sesję" to też jego koszt. CLAUDE.md o 3000 linii to mniej więcej 30 000 tokenów naliczanych przy każdym żądaniu, niezależnie od tego, czy to żądanie czegokolwiek z tego potrzebuje. Omawiamy pełną arytmetykę i prawdziwy, opatrzony adnotacjami przykład w naszym przewodniku po najlepszych praktykach CLAUDE.md; krótka wersja jest taka, że CLAUDE.md chce stabilnych faktów, nie rosnącego dziennika.

To też miejsce, gdzie CLAUDE.md się kończy. Jest statyczny: piszesz go, Claude czyta, a aktualizowanie to ręczny obowiązek, o którym musisz pamiętać. Kolejne trzy warstwy istnieją, żeby obsłużyć fakty, które gromadzą się same.

Warstwa 2: auto-pamięć i katalogi pamięci

Środkowa warstwa to katalog pamięci, często ~/.claude/memory/ albo lokalny dla projektu odpowiednik, gdzie Claude pisze uporządkowane notatki o tym, czego się uczy, i czyta je z powrotem na początku przyszłych sesji. W przeciwieństwie do CLAUDE.md, nikt ręcznie nie autoryzuje większości tych wpisów. Agent decyduje, że coś jest warte zapamiętania, decyzja, którą podjąłeś, preferencja, którą wyraziłeś, fakt, który musiał odkopać, i zapisuje to z wystarczającą strukturą, by odzyskać to później.

Tutaj żyje skill Memory Management, i jest najwyżej ocenionym skillem w tej kategorii na SkillProof: 9,2 na 10. Uruchomiliśmy go przez pełny tydzień realnych sesji, nie jednorazowego demo, i sprawdził się w faktycznym użyciu. Claude niezawodnie przypominał sobie decyzje projektowe i preferencje, które zapisał, a precyzja przywoływania pozostawała wysoka nawet w miarę wzrostu magazynu, część, która zwykle psuje się pierwsza w naiwnych implementacjach.

To, co odróżnia tę warstwę od CLAUDE.md, to fakt, że jest selektywna zarówno w drodze do środka, jak i z powrotem. Dobrze zbudowany skill pamięciowy indeksuje to, co przechowuje, i dociąga odpowiedni wycinek dla bieżącego zadania, więc magazyn może urosnąć do tysięcy wpisów, a każda sesja nie płaci za nie wszystkie.

Warstwa 3: skille pamięciowe, claude-mem i automatyczne przechwytywanie

Trzecia warstwa idzie z tym pomysłem dalej. Zamiast Claude decydującego w trakcie rozmowy, co jest warte zapisania, dedykowany skill przechwytuje całą sesję automatycznie, kompresuje ją i wstrzykuje odpowiedni kontekst z powrotem do kolejnej. Claude-mem to najwyraźniejszy przykład tego wzorca. Jego hasło to „trwały kontekst między sesjami dla każdego agenta": obserwuje, co robi twój agent podczas sesji, kompresuje tę aktywność przejściem podsumowującym AI i pokazuje skompresowaną wersję następnym razem, gdy jest istotna, w Claude Code i, według własnej dokumentacji, kilku innych środowiskach agentowych.

Powinniśmy być szczerzy co do tego, gdzie stoi w naszym testowaniu. Claude-mem pojawił się przez naszego crawlera GitHub z 85 685 gwiazdkami, dlatego czeka w kolejce na pełny test zamiast już nosić werdykt; nie publikujemy oceny, dopóki nie zainstalujemy skilla na czysto i nie uruchomimy go przeciwko realnej pracy, ten sam pasek, który przeszedł już Memory Management. Co możemy powiedzieć teraz, to architektura: automatyczne przechwytywanie usuwa moment, w którym inaczej zatrzymałbyś się i zdecydował, w trakcie sesji, czy coś jest warte zapamiętania. Skill decyduje za ciebie. Czy sprawdzi się przez pełny tydzień na czystej maszynie, to pytanie, na które istnieje kolejka testowa.

Warstwa 4: zwykłe pliki jako pamięć

Ostatnia warstwa nie potrzebuje żadnego skilla: zwykły plik markdown, zwykle nazwany czymś w stylu notes.md albo progress.md, który prosisz Claude, żeby przeczytał na początku sesji i zaktualizował na końcu. Bez indeksowania, bez automatycznego przechwytywania, bez oceniania. Ty jesteś systemem pamięci; plik to tylko miejsce, gdzie to zapisujesz.

Ta warstwa jest niedoceniana, bo brzmi zbyt prosto, by mieć znaczenie. Nie jest. Dla solowego projektu z jednym współpracownikiem i garścią bieżących wątków, plik notatek, który faktycznie utrzymujesz, bije zautomatyzowany system pamięci, na który nigdy nie patrzysz. Tryb awarii siedzi jednak całkowicie po twojej stronie: nikt tego nie przycina, nikt nie flaguje sprzeczności, i rośnie w ścianę tekstu z tymi samymi martwymi punktami, jakie rozwija każdy nieutrzymywany dokument. Działa dokładnie tak dobrze, jak twoja dyscyplina w aktualizowaniu, nie lepiej.

Co należy gdzie: tabela decyzyjna

Typ pamięci	Najlepsze do	Ładuje się	Utrzymanie
CLAUDE.md	Stabilnych, zawsze prawdziwych faktów (komendy budowania, konwencje, pułapki)	W całości, co sesję	Ręcznie, edytujesz sam
Auto-pamięć / katalog pamięci	Decyzji i preferencji, które gromadzą się w czasie	Selektywnie, na żądanie	Głównie automatyczne (zarządzane przez skill)
Skille pamięciowe (claude-mem)	Pełnego kontekstu sesji, przechwyconego bez twojej decyzji, co ma znaczenie	Skompresowane, wstrzykiwane, gdy istotne	Automatyczne przechwytywanie, okazjonalny przegląd
Zwykły plik notatek	Solowych projektów, prostych bieżących wątków	Ręcznie, mówisz Claude, żeby przeczytał	W pełni ręczne

Czytaj tę tabelę pod kątem tego, co się zmienia, nie tego, co wygodnie skonfigurować. Jeśli fakt byłby wciąż prawdziwy za sześć miesięcy, należy do CLAUDE.md. Jeśli to decyzja podjęta w tym tygodniu, która może mieć znaczenie znowu później, należy do pamięci. Jeśli nie potrafisz przewidzieć, czego będziesz musiał zapamiętać, i nie chcesz decydować w danym momencie, to jest przypadek dla automatycznego przechwytywania. Jeśli nic z tego się nie stosuje, plik notatek wciąż bije brak niczego.

Konfiguracja claude-mem, krok po kroku

Ogólny wzorzec dla skilla pamięciowego z automatycznym przechwytywaniem wygląda tak, na konkretnym przykładzie claude-mem:

1. Sklonuj skill. git clone https://github.com/thedotmack/claude-mem do katalogu roboczego, potem podążaj za skryptem instalacyjnym repo zamiast kopiować pliki ręcznie. Skille pamięciowe zwykle muszą zarejestrować hook, nie tylko umieścić SKILL.md na miejscu.

2. Zrestartuj Claude Code. Instalacja zwykle podłącza hook startu albo końca sesji, żeby przechwytywanie działało bez wywoływania czegokolwiek przez ciebie. Restart to coś, co go podchwytuje.

3. Uruchom normalną sesję. Nie testuj tego zadaniem-zabawką. Rób realną pracę; chodzi o zobaczenie, co skill uzna za warte zapamiętania, gdy nikt nie pilnuje testu.

4. Rozpocznij kolejną sesję i sprawdź, co wróciło. Zapytaj Claude, co pamięta z wczorajszej pracy, zanim cokolwiek powiesz. Coś konkretnego i poprawnego znaczy, że przechwytywanie działa. Cokolwiek niejasnego albo błędnego znaczy: sprawdź konfigurację, zanim zaufasz mu przy czymś, co ma znaczenie.

5. Ustal rytm przeglądu. Automatyczne przechwytywanie bez przeglądu zamienia się w automatyczne gromadzenie szumu. Daj sobie powtarzalny dziesięciominutowy slot na przejrzenie tego, co zostało zapisane (więcej o tym w części o higienie pamięci poniżej).

Jeśli wolisz zacząć od czegoś już ocenionego, Memory Management to droga ręczna-ale-testowana: zainstaluj folder skilla do ~/.claude/skills/, a tworzy własny katalog pamięci przy pierwszym użyciu, bez osobnej instalacji hooka.

Ekonomia tokenów pamięci

Oto matematyka, która sprawia, że koszt konfiguracji jest wart poniesienia. Powiedzmy, że fakt o projekcie zajmuje 500 słów, by wyjaśnić go od zera: kształt twojego przepływu autoryzacji, dlaczego pewna tabela ma dwa klucze obce, co faktycznie robi skrypt wdrożeniowy. Wyjaśniony na świeżo w czacie, to około 650 tokenów wejścia za każdym razem, gdy tłumaczysz to na nowo, na dodatek do czasu, który spędzasz na wpisywaniu tego, i czasu, który Claude spędza, rozumując nad tym w tamtej wiadomości.

Przechowany w pamięci zamiast tego, ten sam fakt kosztuje te 650 tokenów raz, żeby go zapisać. Odzyskanie potem kosztuje ułamek tego: dobrze zindeksowana warstwa pamięci dociąga skompresowane podsumowanie, często poniżej 100 tokenów, tylko gdy bieżące zadanie tego faktu dotyka. Wyjaśnij to w czacie pięć razy w ciągu miesiąca, a wydałeś około 3250 tokenów na ponowne uczenie tego, co pamięć kosztowałaby 650 tokenów, żeby się nauczyć, i 500 łącznie, żeby przywołać pięć razy: mniej więcej pięć do jednego luka, która poszerza się, im częściej fakt jest potrzebny.

Porównaj to z upychaniem wszystkiego w CLAUDE.md zamiast tego: fakt istotny raz na dwadzieścia sesji wciąż ładuje się w pozostałych dziewiętnastu, bez selektywności, by odzyskać ten koszt. Stała preambuła, którą niesie twój setup przy każdej turze (CLAUDE.md, schematy narzędzi, wstrzyknięcia pamięci), konkuruje bezpośrednio z twoją realną pracą o miejsce i uwagę. Zmierzyliśmy to głębiej, z prawdziwymi liczbami tokenów przed/po, w naszym przewodniku po kosztach tokenów; pamięć to jedna pozycja w tym większym obrazie, często najtańsza poprawka względem tego, co oszczędza.

Higiena pamięci: rytuał przeglądu

System pamięci, który tylko gromadzi, to nie funkcja, to powolny wyciek. Nieaktualne wpisy nie zawodzą głośno; nic się nie wywala, gdy Claude przywołuje decyzję, którą cofnąłeś trzy tygodnie temu. Po prostu cicho działa na podstawie nieaktualnej informacji, a ty spalasz czas debugowania, ustalając, dlaczego agent jest pewnie w błędzie co do czegoś, co wiesz, że naprawiłeś.

Rób comiesięczne przejście, dziesięć minut, ta sama dyscyplina co rytuał przeglądu CLAUDE.md, który rekomendujemy gdzie indziej. Otwórz magazyn pamięci. Dla każdego wpisu, który wygląda na istotny, zapytaj, czy wciąż jest prawdziwy, czy decyzja, którą opisuje, została od tego czasu cofnięta, i czy jest wystarczająco konkretny, by na nim działać. Usuń wszystko, co zawiedzie. Magazyn pamięci, z którego jesteś dumny, jest mniejszy po roku, niż był po trzech miesiącach; wzrost powinien być w precyzji, nie w objętości.

Najbardziej niezawodnym wyzwalaczem przeglądu nie jest jednak kalendarz. To moment, w którym Claude robi coś złego z powodu nieaktualnej pamięci. Traktuj to jak buga: napraw wpis w tym samym oddechu, co pomyłkę, nie przy swoim następnym zaplanowanym przejściu.

Prywatność: co jest przechwytywane, gdzie ląduje

Skille pamięciowe czytają to, co dzieje się w twoich sesjach, więc uczciwe pytanie brzmi, co jest przechwytywane i gdzie to trafia. Dla pamięci opartej na plikach, zarówno Memory Management, claude-mem, jak i podejścia zwykłych notatek, odpowiedź jest zwykle taka sama: wszystko jest zapisywane do zwykłych plików na twoim własnym dysku, zazwyczaj pod ~/.claude/ albo lokalnym dla projektu folderem pamięci, nie na serwerze zewnętrznym. Nic nie opuszcza twojej maszyny, chyba że zacommitujesz te pliki do współdzielonego repo albo skill jawnie dokumentuje funkcję zdalnej synchronizacji.

To dobra wiadomość dla kontroli i zła dla zakładania, że jest automatycznie bezpieczne. Plik pamięci to zwykły tekstowy zapis tego, nad czym pracowałeś, i może zawierać poświadczenia wspomniane mimochodem, nazwy klientów albo szczegóły architektury, których nie chciałbyś w publicznym repo. Przeczytaj, co faktycznie jest w katalogu pamięci, zanim zacommitujesz go razem z kodem, i przed zainstalowaniem jakiegokolwiek skilla pamięciowego sprawdź jego źródło pod kątem tego, co „przechwytuje wszystko, co robi twój agent" naprawdę oznacza, w tym czy wynik komend zawierający sekrety też jest zamiatany. Automatyczne przechwytywanie zasługuje na tę samą uważność, co każde narzędzie czytające twój terminal.

FAQ

Czy Claude Code ma wbudowaną trwałą pamięć?

Częściowo. CLAUDE.md daje ci statyczną, zawsze ładowaną pamięć od razu, i jest naprawdę wbudowany, bez potrzeby instalacji. Cokolwiek poza statycznymi faktami — pamięć, która się gromadzi, jest indeksowana i selektywnie odzyskiwana — obecnie pochodzi ze skilla, nie z funkcji natywnej.

Jaka jest różnica między CLAUDE.md a skillem pamięciowym?

CLAUDE.md ładuje się w całości, co sesję, i utrzymujesz go ręcznie. Skill pamięciowy pisze i czyta rosnący magazyn selektywnie, dociągając tylko to, co istotne dla bieżącego zadania, a większość pisania odbywa się bez twojego ręcznego udziału. Używaj CLAUDE.md do faktów, które nigdy się nie zmieniają; używaj skilla pamięciowego do faktów, które się gromadzą.

Czy claude-mem jest bezpieczny do zainstalowania teraz?

Nie możemy jeszcze wydać werdyktu. Jest w naszej kolejce testowej, nieoceniony, mimo dużej popularności na GitHubie. Zainstaluj go tak, jak zainstalowałbyś cokolwiek nieocenionego: najpierw w projekcie, w którym możesz sobie pozwolić na eksperyment, i przeczytaj źródło, zanim zaufasz mu z wrażliwymi sesjami.

Ile w tokenach kosztuje uruchomienie skilla pamięciowego?

Mniej niż alternatywa niemal zawsze. Samo przechowywanie jest niemal darmowe, bo żyje na dysku, nie w kontekście. Odzyskiwanie na starcie sesji zwykle kosztuje znacznie mniej niż ponowne tłumaczenie tego samego faktu w czacie, a luka poszerza się, im więcej razy ten fakt musiałby zostać wytłumaczony na nowo.

Czy powinienem używać więcej niż jednej warstwy pamięci naraz?

Tak, i większość działających setupów tak robi: CLAUDE.md do faktów, które nigdy się nie zmieniają, plus skill pamięciowy albo zdyscyplinowany plik notatek do faktów, które się gromadzą. Traktuj je jako uzupełniające się, nie wybieraj faworyta. Chodzi o dopasowanie każdego typu faktu do warstwy zbudowanej do niego, nie o osiadanie na jednym mechanizmie do wszystkiego.