SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor

Как возобновить сессию Claude Code и найти историю

Узнайте, как продолжить работу в Claude Code через команду resume или выбор из списка. Инструкция по поиску локальных текстовых логов сессий и управлению историей диалогов.

Как возобновить сеанс Claude Code

Чтобы возобновить сеанс Claude Code, выполните claude --continue для открытия последнего диалога в текущем каталоге или claude --resume, чтобы выбрать более старый диалог из списка. В уже запущенном сеансе команда /resume переключает вас на другой диалог без выхода из текущего сеанса. Краткие формы команд: -c и -r.

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

Если имя или идентификатор сеанса уже известны, передайте его как аргумент. Claude Code сразу откроет нужный сеанс и не покажет список выбора.

Всё ниже соответствует официальной документации по сеансам по состоянию на November 2026. Claude Code часто выпускает новые версии, а имена флагов и сочетания клавиш могут меняться. Поэтому при расхождениях с выводом в терминале ориентируйтесь на claude --help и указанную страницу.

Что такое сессия на самом деле

Сессия — это сохраненный диалог, привязанный к директории проекта. Она содержит всю историю сообщений, включая вызовы инструментов, сделанные Claude, и результаты этих вызовов. Claude Code записывает данные на диск непрерывно в процессе работы, а не один раз в конце, поэтому диалог сохраняется при закрытии терминала или разрыве SSH-соединения.

Возобновление сессии восстанавливает не только текст. Полностью возвращается история диалога, а также модель, которая использовалась в сессии, и субагент, с которым она была запущена, если вы использовали --agent. Режим разрешений также восстанавливается при возобновлении из оболочки с помощью --continue или идентификатора сессии, за одним исключением, предусмотренным в целях безопасности: режим bypass-permissions никогда не восстанавливается, поэтому сессия, завершенная в этом режиме, возобновится в режиме, который используется при запуске новой сессии. Режим планирования (plan mode) восстанавливается, в том числе при выборе сессии из списка или переключении на нее с помощью /resume — в двух случаях, когда режим обычно не переносится. В терминале возобновление этого режима работает с версии v2.1.290, а в списке выбора и через /resume — с версии v2.1.292; в более ранних версиях режим планирования при возобновлении сбрасывался. При запуске из оболочки --permission-mode переопределяет любой режим, который был восстановлен.

Некоторые параметры не восстанавливаются, так как они являются флагами запуска, а не сохраненным состоянием. Директории, добавленные через --add-dir, и опции, такие как --mcp-config, --settings и --plugin-dir, необходимо указывать повторно при возобновлении. Файлы настроек, такие как settings.json, считываются заново при запуске, поэтому все, что в них содержится, повторять не нужно. Учетные данные относятся к этой же категории: Claude Code определяет способ аутентификации при запуске на основе вашего логина и окружения, а не восстанавливает их из сессии. Поэтому сессия, возобновленная на VPS, где в оболочку случайно попал ANTHROPIC_API_KEY, приведет к ошибке неверного API-ключа, даже если в прошлый раз все работало корректно.

Почему история сеансов особенно важна на 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 локально хранит транскрипты сессий в открытом виде в ~/.claude/projects/. Поскольку в транскрипт также записываются данные, которые Claude Code отправляет модели, в нём могут находиться системный промпт, определения инструментов, параметры запросов и загруженные файлы CLAUDE.md.

Рассмотрим, что это означает для сервера. Если Claude прочитал файл .env, чтобы выяснить, почему сервис не запускается, содержимое этого файла теперь находится в JSONL-файле в вашем домашнем каталоге. Если команда вывела строку подключения, она также попадёт туда. Утечки не произошло. Транскрипт записал то, что произошло, и именно для этого он предназначен. Поэтому его необходимо учитывать в модели угроз.

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

Если вы не хотите создавать транскрипт, CLAUDE_CODE_SKIP_PROMPT_HISTORY отключает запись транскриптов, а --no-session-persistence отключает её для одного неинтерактивного запуска claude -p. Перед включением любого из этих параметров чётко оцените компромисс. Команда resume читает транскрипты, поэтому без транскрипта продолжить сессию невозможно.

Как найти старую сессию

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

Список поддерживает поиск. Нажмите / или просто начните вводить текст, чтобы отфильтровать список. Полезно знать сочетания клавиш, которые расширяют область поиска: Ctrl+A показывает сессии всех проектов на этом компьютере, Ctrl+W — все worktree текущего репозитория, а Ctrl+B ограничивает список текущей веткой git. Нажмите Space, чтобы просмотреть содержимое сессии перед её выбором, и Ctrl+R, чтобы переименовать выделенную сессию.

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

Неименованная сессия всё равно получает сгенерированный заголовок. Фоновый запрос к небольшой быстрой модели создаёт его на основе краткого содержания вашего первого запроса. Этот заголовок помогает найти нужную строку в списке выбора и также используется как идентификатор для возобновления: claude --resume находит сессию так же, как заданное вами имя. Однако имя по умолчанию, например my-app-3f, которое неименованная интерактивная сессия получает в списках запущенных сессий, для этого не подходит. Если передать его в claude --resume, Claude Code не найдёт сессию.

Поиск нужного сеанса в расшифровках

Иногда вы помните фразу и больше ничего. Расшифровки хранятся в виде текста, поэтому их можно искать.

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

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

Есть два важных ограничения. Содержимое экранировано в формате JSON, поэтому фраза с кавычками или фраза, разделённая переносом строки, может не найтись как литеральная строка. Совпадение внутри результата инструмента означает, что Claude увидел этот текст, а не то, что его кто-то ввёл.

Чтение и экспорт диалога

/export преобразует текущий диалог в простой текст, где сообщения и вывод инструментов представлены в читаемом виде, а не в формате JSON. Без аргументов команда открывает меню с выбором: буфер обмена или файл. При указании имени файла /export handover.txt записывает данные непосредственно по этому пути. Это оптимальный способ переноса диалога с сервера на локальный компьютер или прикрепления его к тикету.

Для автоматизации используйте интерфейсы, предназначенные для стабильной работы. Хуки и команды строки состояния получают поле transcript_path в качестве входных данных, поэтому хук SessionEnd может архивировать транскрипт по завершении сессии. Вы также можете задать вопрос сохранённой сессии, не открывая её:

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

Эта команда отправляет дополнительный запрос в старый диалог и возвращает структурированный JSON. Это гораздо более надёжная основа, чем парсинг формата JSONL, структура которого может измениться в следующем релизе.

Когда новая сессия лучше продолжения

При продолжении восстанавливается вся история, и именно всю историю содержит каждый последующий запрос. Продолжать сегодня разговор, который вчера длился четыре часа, дорого. В материале как расходуются токены в длинной сессии объясняется, из чего складываются эти затраты.

Иногда Claude Code выбирает промежуточный вариант за вас. Если оставить длинный разговор без действий в интерактивной сессии терминала, а для него используется часовой кэш промпта, который подписка Claude предоставляет основной беседе по умолчанию в пределах лимита вашего плана, автоматическое сжатие в режиме простоя выполнится примерно через 54 минуты, незадолго до истечения срока действия кэша. Оно применяется, когда контекст разговора достигает порога токенов, по умолчанию 200,000, если автоматическое сжатие включено и компьютер в этот момент не выключен и не находится в спящем режиме. До v2.1.314 Claude Code также должен был получать флаги функций от Anthropic, поэтому у подписчиков с отключённой телеметрией эта возможность не работала. Начиная с v2.1.314 она работает и у них, а также в панели чата расширения VS Code и на вкладке Code в настольном приложении. Диалог подтверждения не отображается. После возвращения в разговоре появляется строка, начинающаяся с Compacted while idle, before the prompt cache expired, а следующее сообщение отправляет резюме вместо всей истории.

  • Оставьте эту возможность включённой. Последующие запросы будут дешевле, но всё, что не попало в резюме, больше недоступно. Порог можно снизить с помощью CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS, однако значения ниже 100,000 увеличиваются до 100,000.
  • Отключите её, задав idleCompaction значение false в settings.json или выбрав строку Idle compaction в разделе /config в v2.1.302 или более поздней версии. В этом случае разговор сохраняется полностью, а стоимость каждого запроса зависит от его размера. Если кэш истёк до отправки следующего сообщения, этот запрос один раз повторно обрабатывает всю историю.

В планах Pro и Max в v2.1.304 появилась ещё одна проверка. В текущей документации также указаны планы Ultra. При продолжении длинного разговора после длительного перерыва или при выборе другой модели, если это использует заметную долю лимита использования за 5 часов, отображается диалог Resume this conversation?. Он показывает расчётную долю и позволяет продолжить разговор либо начать новый. Если вариант создания нового разговора это предусматривает, Claude может найти предыдущий разговор, если вы сошлётесь на него.

Выбор проще, чем кажется. Продолжайте разговор, если следующий текст зависит от того, что уже было сказано. Начинайте новый, если такой зависимости нет. Устаревший контекст легко заметить, если обращать на него внимание: например, Claude ссылается на файл, который вы удалили час назад, или повторно обсуждает решение, принятое в начале сессии. Это устаревший контекст. Его перенос одновременно увеличивает расход токенов и снижает точность.

Если полезная часть старого разговора — это решение или факт, который понадобится вам снова, не полагайтесь на продолжение разговора. Запишите его там, где его видит каждая сессия. Для этого предназначены файлы памяти Claude Code.

Здесь также полезно знать о /branch. Эта функция копирует разговор до текущего места и переключает вас в копию, оставляя исходный разговор без изменений и доступным в списке выбора. Используйте её, чтобы попробовать другой подход и не потерять исходный.

Чем возобновление отличается от сжатия и памяти

Эти понятия постоянно путают, хотя они решают разные задачи.

Возобновление (resume) нужно для того, чтобы вернуться к диалогу после выхода из программы, перезагрузки или переключения на другую задачу. Сжатие (compaction) работает с контекстным окном внутри активного диалога: /compact заменяет текущий контекст Claude на краткое содержание, чтобы последующие запросы потребляли меньше токенов. Если проблема заключается в переполнении контекстного окна, используйте сжатие; подробнее об этом написано в разделе управление контекстным окном Claude Code.

Память (memory) — это другое. Файлы CLAUDE.md и автоматическая память хранят инструкции и факты, которые загружаются в начале каждой сессии, поэтому они не являются диалогом, к которому нужно возвращаться. Это записи, которые вы делаете, чтобы вам больше не приходилось возвращаться к старым диалогам.

Если вам нужно запустить два одновременных диалога с координацией между ними, для этого существует отдельный механизм. Сессии 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.

Была ли эта статья полезной?