SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Claude Code: wznawianie sesji i historia rozmów

Sprawdź `claude --continue`, `--resume` i `/resume`, aby wznowić sesję Claude Code oraz znaleźć zapisane transkrypcje tekstowe na komputerze agenta.

Jak wznowić sesję Claude Code

Aby wznowić sesję Claude Code, należy wykonać claude --continue dla ostatniej konwersacji w bieżącym katalogu lub claude --resume, aby wybrać starszą sesję z listy. Będąc wewnątrz aktywnej sesji, polecenie /resume pozwala przełączyć się na inną konwersację bez przerywania pracy. Skrócone formy to -c oraz -r.

claude --continue
claude --resume
claude --resume auth-refactor

Jeśli znana jest nazwa sesji lub jej identyfikator, należy przekazać je jako argument, a Claude Code przejdzie bezpośrednio do wybranej sesji, pomijając menu wyboru.

Poniższe informacje są zgodne z oficjalną dokumentacją sesji według stanu na listopad 2026. Claude Code otrzymuje częste aktualizacje, a nazwy flag oraz skróty klawiszowe mogą ulegać zmianom między wersjami, dlatego w przypadku rozbieżności z terminalem należy traktować claude --help oraz wskazaną stronę jako wiarygodne źródło informacji.

Czym w rzeczywistości jest sesja

Sesja to jedna zapisana konwersacja powiązana z katalogiem projektu. Przechowuje ona całą historię wiadomości, w tym wywołania narzędzi wykonane przez Claude oraz wyniki zwrócone przez te wywołania. Claude Code zapisuje ją na dysku w sposób ciągły podczas pracy, a nie jednorazowo po jej zakończeniu, dzięki czemu konwersacja jest zachowana po zamknięciu terminala lub utracie połączenia SSH.

Wznowienie przywraca więcej niż tylko tekst. Historia konwersacji powraca w całości, wraz z modelem używanym przez sesję oraz subagentem, z którym została uruchomiona, jeśli użyto --agent. Tryb uprawnień również powraca podczas wznawiania z poziomu powłoki za pomocą --continue lub identyfikatora sesji, z jednym wyjątkiem wprowadzonym ze względów bezpieczeństwa: tryb bypass-permissions nigdy nie jest przywracany, więc sesja, która zakończyła się w tym trybie, zostanie wznowiona w trybie, w jakim rozpoczynałaby się nowa sesja. Tryb planu jest przywracany, również w przypadku wyboru sesji z selektora lub przełączenia się na nią za pomocą /resume – są to dwie ścieżki, które w innych przypadkach nie przenoszą zapisanego trybu. Wznowienia z terminala przywracają go od wersji v2.1.290, a selektor oraz /resume od wersji v2.1.292; wcześniejsze wydania również usuwały tryb planu przy wznowieniu. Z poziomu powłoki --permission-mode nadpisuje każdy tryb, który powraca.

Niektóre elementy nie są przywracane, ponieważ były to flagi czasu uruchomienia, a nie zapisany stan. Katalogi dodane za pomocą --add-dir oraz opcje takie jak --mcp-config, --settings i --plugin-dir muszą zostać przekazane ponownie podczas wznawiania. Pliki ustawień, takie jak settings.json, są odczytywane ponownie przy uruchomieniu, więc wszystko, co się w nich znajduje, nie wymaga powtarzania. Poświadczenia należą do tej samej kategorii: Claude Code ustala sposób uwierzytelnienia przy uruchomieniu, na podstawie logowania i środowiska, zamiast przywracać je wraz z konwersacją. W rezultacie sesja wznowiona na serwerze VPS, gdzie do powłoki wkradł się błędny ANTHROPIC_API_KEY, wywoła błąd nieprawidłowego klucza API, mimo że poprzednio działała poprawnie.

Dlaczego historia sesji ma większe znaczenie na VPS

Oto fakt, który zaskakuje użytkowników. Transkrypcja jest zapisywana na maszynie, na której uruchomiono agenta. Nie jest ona przechowywana na koncie użytkownika ani synchronizowana z chmurą. Jest to plik na dysku danej maszyny.

Zatem sesja pozostawiona w oknie tmux na VPS nie pojawi się w selektorze na laptopie, a sesja z laptopa nie będzie widoczna na VPS. Dane nie są przenoszone między nimi. Jeśli praca odbywa się w sposób typowy dla większości użytkowników, czyli podczas uruchamiania Claude Code w tmux na VPS, to serwer jest miejscem, w którym gromadzi się rzeczywista historia konwersacji, a selektor widoczny lokalnie wyświetla inny, znacznie mniejszy zestaw.

Ten sam podział dotyczy różnych interfejsów. Aplikacja desktopowa oraz rozszerzenie VS Code przechowują własną historię sesji i żadna z nich nie jest historią CLI, choć aplikacja desktopowa potrafi wznowić sesję CLI. Claude Code w wersji webowej również posiada własną historię. Cowork znajduje się jeszcze dalej: jego sesje domyślnie działają w chmurze Anthropic i są zapisywane na koncie Claude, a nie na posiadanym sprzęcie, przy czym lokalne wykonywanie kodu jest zachowane tylko dla istniejących wdrożeń desktopowych. Dlatego, jeśli porównujesz Cowork z Claude Code, miejsce przechowywania transkrypcji jest istotnym elementem decyzji.

W obrębie jednej maszyny zakres wyszukiwania jest szerszy, niż można oczekiwać. claude --resume <session-id> przeszukuje najpierw bieżący katalog projektu i jego drzewa robocze git, a następnie każdy inny projekt na tej maszynie. Kluczową kwestią jest sformułowanie „na tej maszynie”. Identyfikator sesji z innego hosta nie zostanie rozpoznany, o czym Claude Code informuje za pomocą No conversation found with session ID: <session-id>.

Gdzie Claude Code przechowuje historię sesji

Domyślnie transkrypty znajdują się w katalogu konfiguracyjnym Claude Code, w ścieżce o formacie ~/.claude/projects/<project>/<session-id>.jsonl.

<project> to ścieżka do katalogu roboczego, w której każdy znak niebędący znakiem alfanumerycznym został zastąpiony myślnikiem, więc sesja rozpoczęta w /home/deploy/apps/api jest zapisywana w katalogu o nazwie -home-deploy-apps-api. Jeśli przekonwertowana nazwa przekroczyłaby 200 znaków, Claude Code skraca ją i dodaje skrót pełnej ścieżki, dzięki czemu nazwa katalogu mieści się w limitach systemu plików.

Plik ma format JSONL: jeden obiekt JSON w linii, gdzie każda linia to wiadomość, użycie narzędzia lub jego wynik, zapis żądania wysłanego przez Claude Code do modelu lub wpis metadanych. Jest to czytelny tekst i można go przeglądać.

Nie należy tworzyć parserów dla tych plików. Format wpisów jest wewnętrzny dla Claude Code i zmienia się między wersjami, więc skrypt odczytujący te pliki bezpośrednio może przestać działać po każdej aktualizacji. Dokumentacja Anthropic zaleca używanie /export lub udokumentowanych interfejsów skryptowych, co jest słuszną radą właśnie z tego powodu.

Dwa ustawienia zmieniają sposób przechowywania. CLAUDE_CONFIG_DIR przenosi cały katalog konfiguracyjny, co pozwala na umieszczenie transkryptów na oddzielnym lub zaszyfrowanym wolumenie. cleanupPeriodDays w settings.json określa czas przechowywania danych; domyślnie jest to 30 dni, przy czym wartość minimalna wynosi 1.

Co faktycznie znajduje się w tych plikach transkrypcji

Wynik działania każdego narzędzia jest rejestrowany, co oznacza, że transkrypcja zawiera zawartość plików odczytanych przez Claude oraz dane wyjściowe poleceń wykonanych przez Claude. Strona dotycząca wykorzystania danych firmy Anthropic jasno to określa: Claude Code przechowuje transkrypcje sesji lokalnie w formacie tekstowym w ~/.claude/projects/. Ponieważ transkrypcja rejestruje również to, co Claude Code wysyła do modelu, może ona zawierać prompt systemowy, definicje narzędzi, parametry żądań oraz wczytane pliki CLAUDE.md.

Należy rozważyć, co to oznacza w kontekście serwera. Jeśli Claude odczytał plik .env, aby ustalić, dlaczego usługa nie startuje, zawartość tego pliku znajduje się teraz w pliku JSONL w katalogu domowym. Jeśli polecenie wyświetliło ciąg połączeniowy, ten ciąg również tam jest. Nie doszło do wycieku. Transkrypcja zarejestrowała przebieg zdarzeń, co jest jej głównym celem, i właśnie dlatego należy uwzględnić ją w modelu zagrożeń.

  • Kopie zapasowe: zwykła kopia zapasowa /home lub /root przenosi transkrypcje do miejsca docelowego kopii. Należy dodać wykluczenie lub zaakceptować fakt, że kopie promptów i zawartości plików znajdują się teraz w magazynie kopii zapasowych.
  • Migawki i obrazy: migawka VPS wykonana z dowolnego powodu zawiera cały katalog. Podobnie jest w przypadku obrazu klonowanego w celu utworzenia drugiego serwera.
  • Inne konta na serwerze: należy samodzielnie sprawdzić uprawnienia za pomocą ls -ld ~/.claude ~/.claude/projects, zamiast zakładać, że są one wystarczająco restrykcyjne.
  • Świadome przesyłanie danych: polecenie /feedback wysyła historię konwersacji do Anthropic w sposób zamierzony, a /bug oraz /share raportują przez tę samą ścieżkę. Okno dialogowe opinii może również zawierać inne sesje z tego samego projektu z ostatnich 24 godzin lub 7 dni, a nie tylko bieżącą. Są to działania dobrowolne, dlatego należy mieć świadomość, na co wyraża się zgodę przed potwierdzeniem.

Jeśli transkrypcje nie powinny być tworzone, CLAUDE_CODE_SKIP_PROMPT_HISTORY wyłącza ich zapisywanie, a --no-session-persistence wyłącza je dla pojedynczego, nieinteraktywnego uruchomienia claude -p. Przed ustawieniem którejkolwiek z tych opcji należy zrozumieć konsekwencje. Transkrypcje są wykorzystywane przez funkcję wznawiania, więc brak transkrypcji oznacza brak możliwości wznowienia sesji.

Jak odnaleźć poprzednią konwersację

Otwórz selektor za pomocą claude --resume lub użyj /resume wewnątrz aktywnej sesji. Każdy wiersz wyświetla nazwę sesji (jeśli została nadana) lub wygenerowany tytuł, czas od ostatniej aktywności, gałąź git oraz rozmiar pliku.

Selektor obsługuje wyszukiwanie. Naciśnij / lub po prostu zacznij pisać, aby przefiltrować listę. Warto opanować skróty rozszerzające zakres wyszukiwania: Ctrl+A wyświetla sesje ze wszystkich projektów na tej maszynie, Ctrl+W pokazuje wszystkie drzewa robocze (worktrees) bieżącego repozytorium, a Ctrl+B ogranicza listę do bieżącej gałęzi git. Naciśnij Space, aby podejrzeć zawartość sesji przed jej wybraniem, oraz Ctrl+R, aby zmienić nazwę podświetlonego elementu.

Nadawanie nazw sesjom znacznie ułatwia pracę. Rozpocznij sesję za pomocą claude -n auth-refactor lub uruchom /rename auth-refactor w trakcie pracy, gdy uznasz, że konwersacja przekształciła się w konkretne zadanie. Nazwaną sesję można następnie wznowić bezpośrednio z poziomu powłoki, używając jej nazwy.

Nienazwana sesja również otrzymuje wygenerowany tytuł, tworzony przez działający w tle model, który podsumowuje pierwszy prompt. Tytuł ten pomaga zidentyfikować wiersz w selektorze i służy jako identyfikator wznowienia: claude --resume rozpoznaje go w taki sam sposób, jak własną nazwę. Nie zadziała natomiast domyślna nazwa wyświetlana, taka jak my-app-3f, która przypisywana jest nienazwanym sesjom interaktywnym na listach uruchomionych procesów. Przekazanie jej do claude --resume sprawi, że Claude Code nie odnajdzie sesji.

Wyszukiwanie fraz w transkrypcjach w celu znalezienia sesji

Czasami pamięta się tylko konkretną frazę. Transkrypcje są plikami tekstowymi, więc można je przeszukiwać.

grep -rl "nftables" ~/.claude/projects/

To polecenie wyświetla ścieżki do pasujących transkrypcji. Nazwa pliku bez rozszerzenia .jsonl stanowi identyfikator sesji, który jest akceptowany przez claude --resume <session-id>. Polecenie claude --resume akceptuje również bezpośrednio ścieżkę bezwzględną do transkrypcji. Użyj grep, aby ustalić, która sesja jest potrzebna, a następnie wznów ją lub wyeksportuj, aby odczytać zawartość.

Dwie istotne uwagi. Zawartość jest zapisana w formacie JSON-escaped, więc fraza zawierająca znaki cudzysłowu lub podzielona znakiem nowej linii może nie zostać dopasowana jako ciąg dosłowny. Ponadto dopasowanie wewnątrz wyniku działania narzędzia oznacza, że tekst ten został przetworzony przez Claude, a nie wpisany przez użytkownika.

Odczyt i eksport konwersacji

/export renderuje bieżącą konwersację jako tekst zwykły, w którym wiadomości oraz dane wyjściowe narzędzi są zapisane w sposób czytelny, zamiast w formacie JSON. Bez argumentu otwiera menu oferujące zapis do schowka lub pliku. Z podaną nazwą pliku /export handover.txt zapisuje dane bezpośrednio pod wskazaną ścieżką. Jest to właściwy sposób przenoszenia konwersacji z serwera na laptopa lub dołączania jej do zgłoszenia serwisowego.

W przypadku automatyzacji należy korzystać z interfejsów, które mają zapewnioną stabilność. Hooki oraz polecenia linii statusu otrzymują pole transcript_path jako dane wejściowe, dzięki czemu hook SessionEnd może archiwizować transkrypcję po zakończeniu sesji. Można również zadać pytanie zapisanej sesji bez jej otwierania:

claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'

Polecenie to wysyła dodatkowe zapytanie do starej konwersacji i zwraca ustrukturyzowany format JSON. Jest to znacznie lepsza podstawa niż parsowanie formatu JSONL, który może ulec zmianie w kolejnym wydaniu.

Rozpoczęcie od nowa kontra wznawianie

Wznawianie przywraca całą historię, a cała historia jest tym, co zawiera każde kolejne żądanie. Kontynuowanie dzisiaj rozmowy, która trwała cztery godziny wczoraj, jest kosztowne, a sposób, w jaki zużycie tokenów sumuje się w długiej sesji wyjaśnia, skąd faktycznie bierze się ten koszt.

Claude Code czasami wybiera dla użytkownika rozwiązanie pośrednie. Jeśli długa rozmowa pozostanie bezczynna w interaktywnej sesji terminala i korzysta z godzinnego cache'u promptów (co subskrypcja Claude zapewnia domyślnie dla głównej rozmowy w ramach limitów planu), mechanizm idle compaction skompresuje ją po około 54 minutach, tuż przed wygaśnięciem cache'u. Mechanizm ten uruchamia się, gdy kontekst rozmowy osiągnie próg tokenów (domyślnie 200,000), przy włączonej opcji auto-compaction i aktywnym urządzeniu w tym momencie. Przed wersją v2.1.314 wymagało to również pobrania flag funkcji z Anthropic przez Claude Code, więc subskrybenci z wyłączoną telemetrią nigdy go nie otrzymywali; od wersji v2.1.314 działa on również dla nich, a także w panelu czatu rozszerzenia VS Code oraz w karcie Code aplikacji desktopowej. Żadne okno dialogowe nie prosi o zgodę. Po powrocie rozmowa wyświetla linię zaczynającą się od Compacted while idle, before the prompt cache expired, a kolejna wiadomość wysyła podsumowanie zamiast całej historii.

  • Pozostawienie włączonej opcji sprawia, że kolejne żądania są tańsze, ale wszystko, co zostało pominięte w podsumowaniu, przestaje być dostępne. Próg można obniżyć za pomocą CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS, choć wartości poniżej 100,000 są podnoszone do 100,000.
  • Wyłączenie opcji poprzez ustawienie idleCompaction na false w settings.json lub w wierszu Idle compaction w /config (w wersji v2.1.302 lub nowszej) sprawia, że rozmowa pozostaje kompletna, a koszt każdego żądania skaluje się wraz z jej rozmiarem. Jeśli cache wygasł w momencie wysyłania kolejnej wiadomości, żądanie to jednorazowo przetworzy pełną historię.

W planach Pro i Max wersja v2.1.304 dodała dodatkową weryfikację, a obecna dokumentacja wymienia również plany Ultra. W przypadku wznawiania długiej rozmowy po długiej przerwie lub przy użyciu innego modelu, co mogłoby zużyć znaczną część 5-godzinnego limitu użycia, pojawi się okno dialogowe Resume this conversation?, które pokaże szacowane zużycie i pozwoli na kontynuację lub rozpoczęcie nowej rozmowy. Jeśli opcja nowej rozmowy na to pozwala, Claude może odwołać się do poprzedniej, jeśli użytkownik o niej wspomni.

Decyzja jest prostsza, niż się wydaje. Wznawiaj, gdy kolejna czynność zależy od tego, co już powiedziano. Rozpoczynaj od nowa, gdy tak nie jest. Dryf kontekstu łatwo zauważyć, jeśli się go monitoruje: Claude odwołuje się do pliku usuniętego godzinę temu lub ponownie kwestionuje decyzję ustaloną na początku sesji. Jest to nieaktualny kontekst, a jego przenoszenie kosztuje jednocześnie tokeny i obniża dokładność.

Jeśli użyteczną częścią starej rozmowy jest decyzja lub fakt, który będzie potrzebny ponownie, nie należy polegać na wznawianiu w celu jego zachowania. Należy zapisać go w miejscu dostępnym dla każdej sesji, do czego służą pliki pamięci Claude Code.

Warto również znać /branch. Kopiuje ono rozmowę do bieżącego punktu i przełącza użytkownika na kopię, pozostawiając oryginał nienaruszony i dostępny w selektorze. Użyj tego, aby wypróbować drugie podejście bez utraty pierwszego.

Czym różni się wznawianie od kompresji i pamięci

Pojęcia te są stale mylone, mimo że rozwiązują odmienne problemy.

Wznawianie dotyczy przywrócenia dostępu do konwersacji po jej opuszczeniu, restarcie systemu lub przejściu do innego zadania. Kompresja odnosi się do okna kontekstowego wewnątrz aktywnej konwersacji: /compact zastępuje dane przechowywane przez Claude podsumowaniem, dzięki czemu późniejsze żądania zużywają mniej tokenów. Jeśli problemem jest zapełnienie okna kontekstowego, należy użyć kompresji, co szczegółowo opisano w zarządzaniu oknem kontekstowym Claude Code.

Pamięć działa w jeszcze inny sposób. Pliki CLAUDE.md oraz pamięć automatyczna przechowują instrukcje i fakty, które są ładowane na początku każdej sesji, więc nie stanowią one konwersacji, do której się powraca. Są to informacje zapisywane w celu uniknięcia konieczności powracania do poprzednich sesji.

Jeśli celem jest prowadzenie dwóch jednoczesnych i współpracujących ze sobą konwersacji, służy do tego osobny mechanizm. Sesje Claude Code mogą przesyłać między sobą wiadomości, gdy obie są aktywne, co stanowi problem odmienny od przywracania wczorajszej sesji z dysku.

FAQ

Gdzie Claude Code przechowuje historię sesji?

Domyślnie w katalogu konfiguracyjnym, pod adresem ~/.claude/projects/<project>/<session-id>.jsonl, gdzie <project> to ścieżka do katalogu roboczego, w której znaki niebędące alfanumerycznymi zastąpiono myślnikami. Każdy plik ma format JSONL: jeden obiekt JSON w linii dla wiadomości, użycia narzędzia lub jego wyniku, zapisu żądania wysłanego do modelu lub wpisu metadanych. Zmienna CLAUDE_CONFIG_DIR pozwala przenieść katalog konfiguracyjny w inne miejsce, a cleanupPeriodDays w settings.json określa czas przechowywania transkrypcji (domyślnie 30 dni, minimum 1 dzień).

Dlaczego nie widzę sesji z VPS w selektorze na laptopie?

Ponieważ transkrypcje są zapisywane na dysku maszyny, na której uruchomiono agenta, i nie są synchronizowane między urządzeniami. Konwersacja prowadzona wewnątrz tmux na VPS istnieje tylko na tym VPS. Należy ją wznowić tam przez SSH lub uruchomić /export i skopiować plik tekstowy, jeśli wymagana jest lokalna kopia.

Czy można wznowić sesję rozpoczętą w innym katalogu?

Tak, jeśli znany jest identyfikator sesji. claude --resume <session-id> przeszukuje najpierw bieżący katalog projektu i jego drzewa robocze git, a następnie wszystkie inne projekty na tej samej maszynie. Wewnątrz selektora Ctrl+A rozszerza listę na wszystkie projekty na maszynie, a Ctrl+W na wszystkie drzewa robocze bieżącego repozytorium. Jeśli nie znaleziono dopasowania, Claude Code zgłasza No conversation found with session ID: <session-id>.

Czy lepiej wznowić starą sesję, czy rozpocząć nową?

Sesję należy wznowić, gdy kolejna wiadomość zależy od wcześniejszych ustaleń. Nową sesję należy rozpocząć, gdy nie ma takiej zależności, ponieważ wznowienie ładuje całą historię, a każde kolejne żądanie przesyła ją ponownie. Należy monitorować zjawisko dryfu: sesja, która odwołuje się do usuniętych plików, zawiera nieaktualny kontekst, co zwiększa zużycie tokenów i obniża precyzję odpowiedzi.

Czy można zablokować zapisywanie transkrypcji przez Claude Code na dysku?

Tak. CLAUDE_CODE_SKIP_PROMPT_HISTORY wyłącza zapisywanie transkrypcji, a --no-session-persistence wyłącza je dla pojedynczego, nieinteraktywnego uruchomienia claude -p. Należy pamiętać, że transkrypcje są niezbędne do działania funkcji wznawiania, więc ich wyłączenie sprawi, że --continue oraz --resume nie będą miały danych do załadowania. Jeśli problemem jest lokalizacja plików, a nie sam fakt ich istnienia, należy wskazać CLAUDE_CONFIG_DIR na zaszyfrowany wolumen i zmniejszyć wartość cleanupPeriodDays.

Czy ten artykuł był przydatny?