SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor

Як відновити сеанс Claude Code та знайти історію

Дізнайтеся, як відновити сеанс Claude Code за назвою або через picker, а також де на машині агента зберігаються його plaintext-транскрипти.

Як відновити сеанс Claude Code

Щоб відновити сеанс Claude Code, виконайте claude --continue для останньої розмови в поточному каталозі або claude --resume, щоб вибрати старішу розмову зі списку. У вже запущеному сеансі команда /resume перемикає вас на іншу розмову без виходу. Скорочені форми — -c і -r.

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

Якщо ви вже знаєте назву або ID сеансу, передайте його як аргумент, і Claude Code одразу відкриє потрібний сеанс без відображення списку вибору.

Усе наведене нижче відповідає офіційній документації щодо сеансів станом на November 2026. Claude Code часто випускає нові версії, а назви прапорців і комбінації клавіш можуть змінюватися між версіями, тому в разі розбіжностей із виводом у вашому терміналі вважайте claude --help і цю сторінку основними джерелами.

Що насправді таке сесія

Сесія — це одна збережена розмова, прив’язана до каталогу проєкту. Вона містить усю історію повідомлень, зокрема виклики інструментів, які виконав Claude, і результати цих викликів. Claude Code безперервно записує її на диск під час роботи, а не лише наприкінці, тому розмова зберігається навіть після закриття термінала або втрати SSH-з’єднання.

Відновлення повертає не лише текст. Повна історія розмови відновлюється разом із моделлю, яку використовувала сесія, і subagent, з яким її було запущено, якщо ви використовували --agent. Режим дозволів також відновлюється, коли ви продовжуєте роботу з shell за допомогою --continue або ідентифікатора сесії. Єдиний виняток зроблено для безпеки: режим bypass-permissions ніколи не відновлюється. Тому сесія, яка завершилася в цьому режимі, продовжується в режимі, з якого починалася б нова сесія. Plan mode відновлюється також у разі вибору сесії зі списку або переходу до неї за допомогою /resume. В інших випадках ці два способи не переносять збережений режим. Для відновлення з термінала це підтримується починаючи з v2.1.290, а для списку вибору та /resume — з v2.1.292. У попередніх релізах plan mode під час відновлення також втрачався. У shell --permission-mode перевизначає режим, який було відновлено.

Деякі параметри не відновлюються, оскільки під час запуску вони задаються як flags, а не зберігаються в стані сесії. Каталоги, додані за допомогою --add-dir, і такі параметри, як --mcp-config, --settings та --plugin-dir, потрібно передати повторно під час відновлення. Файли налаштувань, наприклад settings.json, перечитуються під час запуску, тому параметри з них не потрібно задавати повторно. Облікові дані працюють так само: Claude Code визначає спосіб автентифікації під час запуску на основі вашого входу та середовища, а не відновлює його разом із розмовою. Тому сесія, відновлена на VPS, де в shell випадково з’явився ANTHROPIC_API_KEY, отримає помилку недійсного API key, навіть якщо минулого разу все працювало.

Чому історія сесій важливіша на VPS

Є факт, який дивує багатьох. Транскрипт зберігається на машині, де працював агент. Він не зберігається у вашому обліковому записі й не синхронізується з хмарою. Це файл на диску цього сервера.

Тому сесія, яку ви залишили у вікні tmux на VPS, не з’явиться у списку вибору на ноутбуці, а сесія з ноутбука не з’явиться на VPS. Між ними нічого не передається. Якщо ви працюєте так, як більшість користувачів, запускаючи Claude Code у tmux на VPS, саме сервер накопичує вашу основну історію розмов, а список вибору, який ви бачите локально, містить інший і значно менший набір сесій.

Такий самий поділ діє між інтерфейсами. Настільний застосунок і розширення VS Code зберігають власну історію сесій, і жодна з них не є історією CLI, хоча настільний застосунок також може відновити сесію CLI. Claude Code у вебі також зберігає власну історію. Cowork працює ще окреміше: за замовчуванням його сесії виконуються в хмарі Anthropic і зберігаються у вашому обліковому записі Claude, а не на обладнанні, яким ви володієте. Локальне виконання доступне лише для наявних розгортань настільного застосунку. Тому якщо ви порівнюєте Cowork і Claude Code, місце зберігання транскрипту є частиною рішення.

На одній машині пошук охоплює більше, ніж можна очікувати. claude --resume <session-id> спочатку перевіряє поточний каталог проєкту та його git worktrees, а потім — усі інші проєкти на цій машині. Головне — запам’ятати фразу «на цій машині». Ідентифікатор сесії з іншого хоста нічого не повертає, і Claude Code повідомляє про це за допомогою No conversation found with session ID: <session-id>.

Де Claude Code зберігає історію сеансів

За замовчуванням стенограми зберігаються в каталозі конфігурації Claude Code за шляхом такого формату: ~/.claude/projects/<project>/<session-id>.jsonl.

<project> — це шлях до робочого каталогу, у якому кожен неалфавітно-цифровий символ замінено дефісом. Тому сеанс, запущений у /home/deploy/apps/api, зберігається в каталозі з назвою -home-deploy-apps-api. Якщо після такого перетворення назва перевищує 200 символів, Claude Code скорочує її та додає хеш повного шляху. Завдяки цьому назва каталогу не виходить за обмеження файлової системи.

Файл має формат JSONL: один JSON-об’єкт у кожному рядку. Кожен рядок містить повідомлення, використання інструмента або його результат, запис запиту, який Claude Code надіслав моделі, або запис метаданих. Це звичайний текст, тому читати його безпечно.

Створювати на його основі парсер не рекомендується. Формат записів є внутрішнім форматом Claude Code і змінюється між версіями. Тому скрипт, який безпосередньо читає ці файли, може перестати працювати після будь-якого оновлення. У власній документації Anthropic радить натомість використовувати /export або документовані інтерфейси для скриптів. Це слушна порада саме з цієї причини.

Два параметри змінюють місце та строк зберігання. CLAUDE_CONFIG_DIR переміщує весь каталог конфігурації. Це дає змогу зберігати стенограми на окремому або зашифрованому томі. Параметр cleanupPeriodDays у settings.json визначає строк їх зберігання. Значення за замовчуванням — 30 днів, мінімальне значення — 1 день.

Що насправді міститься у файлах транскриптів

Записується результат кожного інструмента, тому транскрипт містить вміст файлів, які прочитав Claude, і вивід команд, виконаних Claude. На сторінці використання даних Anthropic прямо зазначає: Claude Code зберігає транскрипти сеансів локально у форматі plaintext у каталозі ~/.claude/projects/. Оскільки транскрипт також записує дані, які Claude Code надсилає моделі, він може містити системний prompt, визначення інструментів, параметри запитів і завантажені файли CLAUDE.md.

Розгляньте, що це означає для сервера. Якщо Claude прочитав файл .env, щоб з’ясувати, чому сервіс не запускається, вміст цього файла тепер зберігається у файлі JSONL у вашому домашньому каталозі. Якщо команда вивела рядок підключення, цей рядок також буде записано туди. Нічого не витекло. Транскрипт лише зафіксував те, що відбулося, і саме для цього він призначений. Тому його потрібно враховувати у вашій моделі загроз.

  • Резервні копії: звичайна резервна копія /home або /root скопіює ваші транскрипти туди, де зберігаються резервні копії. Додайте виключення або прийміть, що копії ваших prompt і вмісту файлів тепер зберігатимуться у сховищі резервних копій.
  • Снапшоти та образи: снапшот VPS, створений з будь-якої причини, містить увесь каталог. Те саме стосується образу, який ви клонували для створення другого сервера.
  • Інші облікові записи на сервері: перевірте права самостійно за допомогою ls -ld ~/.claude ~/.claude/projects, а не припускайте, що вони достатньо обмежені.
  • Навмисне передавання: команда /feedback навмисно надсилає історію розмов до Anthropic, а /bug і /share передають дані тим самим каналом. Діалогове вікно зворотного зв’язку також може містити інші сеанси з того самого проєкту за останні 24 години або 7 днів, а не лише поточний сеанс. Це дії, які ви виконуєте самостійно, тому перед підтвердженням переконайтеся, що розумієте, на що погоджуєтеся.

Якщо ви не хочете створювати транскрипт, CLAUDE_CODE_SKIP_PROMPT_HISTORY вимикає запис транскриптів, а --no-session-persistence вимикає його для одного неінтерактивного запуску claude -p. Перед встановленням будь-якого з цих параметрів чітко оцініть компроміс. Операція resume читає транскрипти, тому без транскрипту resume не працює.

Як знайти стару розмову

Відкрийте список вибору за допомогою claude --resume або за допомогою /resume під час активного сеансу. У кожному рядку відображається назва сеансу, якщо ви її вказали, або згенерований заголовок, якщо ні, а також час від останньої активності, git branch і розмір файлу.

У списку можна виконувати пошук. Натисніть / або просто почніть вводити текст, щоб відфільтрувати список. Варто запам’ятати клавіші, які розширюють область пошуку: Ctrl+A показує сеанси з усіх проєктів на цьому комп’ютері, Ctrl+W — усі worktree поточного репозиторію, а Ctrl+B фільтрує список за поточною git branch. Натисніть Space, щоб переглянути вміст сеансу перед його відновленням, і Ctrl+R, щоб перейменувати вибраний сеанс.

Назви сеансів значно спрощують цю роботу. Запустіть сеанс за допомогою claude -n auth-refactor або виконайте /rename auth-refactor посеред роботи, коли стане зрозуміло, що розмова перетворилася на окреме робоче завдання. Після цього іменований сеанс можна відновити за назвою безпосередньо з shell.

Неіменований сеанс також отримує згенерований заголовок. Фоновий запит до невеликої швидкої моделі створює його на основі стислого опису вашого першого запиту. Цей заголовок допомагає розпізнати рядок у списку вибору й також працює як ідентифікатор для відновлення: claude --resume знаходить сеанс так само, як і вказана вами назва. Натомість не працює стандартне ім’я відображення, наприклад my-app-3f, яке неіменований інтерактивний сеанс має в переліках активних сеансів. Якщо передати його до claude --resume, Claude Code не знайде сеанс.

Пошук потрібного сеансу в транскриптах за допомогою grep

Іноді ви пам’ятаєте лише фразу. Транскрипти зберігаються як текст, тому їх можна шукати.

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

Команда виводить шляхи до транскриптів, у яких знайдено збіг. Ім’я файлу без розширення .jsonl — це ідентифікатор сеансу, який приймає claude --resume <session-id>. claude --resume також безпосередньо приймає абсолютний шлях до транскрипту. Використовуйте grep, щоб визначити потрібний сеанс, а потім відновіть його або експортуйте, щоб прочитати транскрипт.

Є 2 важливі застереження. Вміст екрановано у форматі JSON, тому фраза з лапками або фраза, розділена переносом рядка, може не збігтися з літеральним рядком. Збіг у результаті роботи інструмента означає, що Claude побачив цей текст, а не те, що його хтось увів.

Читання та експорт розмови

/export відображає поточну розмову як звичайний текст. Повідомлення та вивід інструментів подаються у зручному для читання форматі, а не як JSON. Без аргументів команда відкриває меню, у якому можна вибрати буфер обміну або файл. Якщо вказати ім’я файлу, /export handover.txt записує дані безпосередньо за цим шляхом. Це правильний спосіб перенести розмову із сервера на ноутбук або додати її до заявки.

Для автоматизації використовуйте інтерфейси, призначені для стабільної роботи. Hooks і команди рядка стану отримують поле transcript_path як вхідні дані, тому SessionEnd hook може архівувати transcript після завершення сесії. Також можна поставити запит збереженій сесії, не відкриваючи її:

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

Ця команда надсилає follow-up prompt у стару розмову та повертає структурований JSON. Це значно надійніша основа, ніж обробка формату JSONL, який може змінитися в наступному релізі.

Коли почати нову розмову краще, ніж продовжити наявну

Продовження повертає всю історію, і саме всю цю історію містить кожен наступний запит. Розмову, яка тривала чотири години вчора, дорого продовжувати сьогодні, а в матеріалі як накопичується використання токенів у довгій сесії пояснено, звідки саме виникають ці витрати.

Claude Code іноді сам обирає проміжний варіант. Якщо залишити довгу розмову бездіяльною в інтерактивній terminal session і для неї використовується one-hour prompt cache, який підписка Claude за замовчуванням надає для основної розмови в межах вашого плану, idle compaction стискає її приблизно через 54 хвилини, незадовго до завершення дії cache. Це відбувається, коли контекст розмови досягає порогового значення токенів, за замовчуванням 200,000, якщо auto-compaction увімкнено, а машина в цей момент не спить. До v2.1.314 Claude Code також мав отримати feature flags від Anthropic, тому підписники з вимкненою телеметрією не отримували цю функцію; починаючи з v2.1.314 вона працює і для них, а також у chat panel розширення VS Code та на вкладці Code desktop app. Підтвердження не запитується. Після повернення до розмови в ній відображається рядок, що починається з Compacted while idle, before the prompt cache expired, а наступне повідомлення надсилається як summary, а не як повна історія.

  • Якщо залишити цю функцію увімкненою, наступні запити будуть дешевшими, але все, що не потрапило до summary, більше недоступне. Порогове значення можна зменшити за допомогою CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS, але значення менші за 100,000 буде підвищено до 100,000.
  • Вимкніть функцію, встановивши idleCompaction у значення false у settings.json, або через рядок Idle compaction у /config у версії v2.1.302 або новішій. Тоді розмова зберігається повністю, а вартість кожного запиту залежить від її розміру. Якщо до моменту надсилання наступного повідомлення cache уже завершив дію, цей запит один раз повторно обробить усю історію.

У планах Pro і Max у v2.1.304 додано ще одну перевірку, а поточна документація також містить плани Ultra. Якщо продовження довгої розмови після тривалої перерви або на іншій моделі використає помітну частину вашого 5-hour usage limit, діалог Resume this conversation? покаже оцінену частку та дасть змогу продовжити розмову або почати нову. Якщо це передбачено опцією нової розмови, Claude може знайти попередню розмову, якщо ви на неї посилаєтеся.

Вибір простіший, ніж здається. Продовжуйте розмову, якщо наступне повідомлення залежить від уже сказаного. Починайте нову, якщо не залежить. Ознаки drift легко помітити, якщо стежити за ними: Claude посилається на файл, який ви видалили годину тому, або знову обговорює рішення, ухвалене на початку сесії. Це застарілий контекст. Його перенесення одночасно збільшує витрати токенів і знижує точність.

Якщо корисна частина старої розмови — це рішення або факт, який знадобиться знову, не покладайтеся на продовження розмови. Запишіть це там, де його бачитиме кожна сесія. Саме для цього призначені файли пам’яті Claude Code.

/branch також варто знати. Вона копіює розмову до поточного моменту й перемикає вас на копію, залишаючи оригінал без змін і доступним у picker. Використовуйте її, щоб спробувати інший підхід і не втратити перший.

Як resume відрізняється від compaction і memory

Ці поняття часто плутають, але вони вирішують різні завдання.

Resume потрібен, щоб знову відкрити розмову після виходу з неї, перезавантаження системи або переходу до іншого завдання. Compaction стосується контекстного вікна в активній розмові: /compact замінює контекст, який Claude зберігає, підсумком, тому наступні запити надсилають менше токенів. Якщо проблема полягає в тому, що контекстне вікно заповнене, використовуйте compaction. Докладний опис наведено в матеріалі керування контекстним вікном Claude Code.

Memory працює інакше. Файли CLAUDE.md і auto memory містять інструкції та факти, які завантажуються на початку кожної сесії. Тому вони не є розмовою, до якої ви повертаєтеся. Це записи, які ви створюєте, щоб більше не повертатися до однієї й тієї самої інформації.

Якщо потрібно одночасно запустити дві розмови та організувати їхню взаємодію, це окремий механізм. Сесії Claude Code можуть надсилати повідомлення одна одній, поки обидві активні. Це інше завдання, ніж відновлення вчорашньої сесії з диска.

FAQ

Де Claude Code зберігає історію моїх сеансів?

За замовчуванням — у каталозі конфігурації, у ~/.claude/projects/<project>/<session-id>.jsonl, де <project> — шлях до робочого каталогу, у якому всі неалфавітно-цифрові символи замінено дефісами. Кожен файл має формат JSONL: один об’єкт JSON у кожному рядку для повідомлення, використання інструмента або його результату, запису запиту, надісланого моделі, чи запису метаданих. CLAUDE_CONFIG_DIR переміщує каталог конфігурації в інше місце, а cleanupPeriodDays у settings.json визначає, як довго зберігаються транскрипти; типове значення — 30 днів, мінімальне — 1 день.

Чому я не бачу сеанс із VPS у списку вибору на ноутбуці?

Тому що транскрипти записуються на диск комп’ютера, на якому працював агент, і між комп’ютерами не синхронізуються. Розмова, яку ви вели всередині tmux на VPS, існує лише на VPS. Відновіть її там через SSH або виконайте /export усередині сеансу й скопіюйте текстовий файл, якщо потрібна локальна копія.

Чи можу я відновити сеанс, який розпочав в іншому каталозі?

Так, якщо у вас є його ідентифікатор сеансу. claude --resume <session-id> спочатку шукає в поточному каталозі проєкту та його git worktrees, а потім — в інших проєктах на цьому самому комп’ютері. У списку вибору Ctrl+A розширює список до всіх проєктів на комп’ютері, а Ctrl+W — до всіх worktrees поточного репозиторію. Якщо збігів немає, Claude Code повідомляє No conversation found with session ID: <session-id>.

Чи варто відновити старий сеанс чи почати новий?

Відновлюйте сеанс, якщо наступне повідомлення залежить від того, що вже було сказано в цій розмові. Починайте новий, якщо це не так, оскільки під час відновлення завантажується вся історія, а кожен наступний запит містить її. Стежте за втратою актуальності контексту: якщо сеанс продовжує посилатися на вже видалені файли, він використовує застарілий контекст, який у кожному повідомленні витрачає токени та знижує точність.

Чи можна заборонити Claude Code записувати транскрипти на диск?

Так. CLAUDE_CODE_SKIP_PROMPT_HISTORY вимикає запис транскриптів, а --no-session-persistence вимикає його для одного неінтерактивного запуску claude -p. Спочатку врахуйте наслідки: саме транскрипти використовуються для відновлення, тому після їх вимкнення --continue і --resume не матимуть що завантажувати. Якщо вас турбує не саме існування файлів, а місце їх зберігання, вкажіть для CLAUDE_CONFIG_DIR зашифрований том і натомість зменште cleanupPeriodDays.

Чи була ця стаття корисною?