Управление сеансами
Назовите, возобновите, создавайте ветви и переключайтесь между диалогами Claude Code. Охватывает
--continue,--resume,--from-pr, средство выбора/resume, именование сеансов и место хранения стенограмм.
Сеанс — это сохранённый диалог, привязанный к каталогу проекта. Claude Code сохраняет его локально по мере работы, поэтому вы можете возобновить работу с того же места, создать ветвь для попытки другого подхода или переключаться между задачами.
Настольное приложение, Claude Code в веб-версии и расширение VS Code каждое ведёт собственную историю сеансов. На этой странице рассматривается CLI:
- Возобновление предыдущего диалога по флагу, имени или PR
- Именование сеансов, чтобы вы могли найти их позже
- Просмотр сеансов с помощью средства выбора
/resume - Создание ветви диалога для попытки другого подхода
- Экспорт стенограмм и их поиск на диске
Возобновление сеанса
Сеансы сохраняются непрерывно в локальные файлы стенограмм по мере работы, поэтому вы можете вернуться к одному из них после выхода или запуска /clear. Используйте эти точки входа:
| Команда | Что она делает |
|---|---|
claude --continue |
Возобновляет самый последний сеанс в текущем каталоге |
claude --resume |
Открывает средство выбора сеансов |
claude --resume <name> |
Возобновляет именованный сеанс напрямую |
claude --from-pr <number> |
Возобновляет сеанс, связанный с этим pull request |
/resume |
Переключается на другой диалог из активного сеанса |
Сеансы, созданные с помощью claude -p или Agent SDK, не отображаются в средстве выбора сеансов, но вы всё равно можете возобновить один, передав его ID сеанса в claude --resume <session-id>. Запустите это из каталога, в котором был запущен сеанс: поиск ID сеанса ограничен текущим каталогом проекта и его git worktrees, поэтому сеанс, созданный в другом месте, сообщает No conversation found with session ID: <session-id>.
Где средство выбора сеансов ищет сеансы
Сеансы хранятся для каждого каталога проекта. По умолчанию средство выбора сеансов показывает интерактивные сеансы из текущего worktree, а также сеансы, запущенные в других местах, которые добавили текущий каталог с помощью /add-dir. {/* min-version: 2.1.169 */}Начиная с версии 2.1.169, перемещение сеанса с помощью /cd переносит его в хранилище проекта нового каталога, поэтому он появляется в средстве выбора этого каталога впоследствии. Используйте Ctrl+W для расширения на все worktrees репозитория или Ctrl+A для расширения на каждый проект на этой машине.
Выбор сеанса из другого worktree того же репозитория возобновляет его на месте. Выбор сеанса из несвязанного проекта копирует команду cd и команду возобновления в буфер обмена.
Возобновление по имени разрешается в текущем репозитории и его worktrees. Обе формы ищут точное совпадение и возобновляют его напрямую, даже если он находится в другом worktree:
| Команда | Точное совпадение | Неоднозначное имя |
|---|---|---|
claude --resume <name> |
Возобновляет напрямую | Открывает средство выбора сеансов с предварительно заполненным именем в качестве условия поиска |
/resume <name> |
Возобновляет напрямую | Сообщает об ошибке; запустите /resume без аргументов, чтобы открыть средство выбора сеансов |
Именование ваших сеансов
Дайте сеансам описательные имена, чтобы их можно было найти в средстве выбора сеансов и возобновить по имени. Это особенно важно, когда вы работаете над несколькими задачами параллельно.
| Когда | Как установить имя |
|---|---|
| При запуске | claude -n auth-refactor |
| Во время сеанса | /rename auth-refactor. Имя также отображается на панели подсказок |
| Из средства выбора сеансов | Выделите сеанс и нажмите Ctrl+R |
| При принятии плана | Принятие плана в режиме плана называет сеанс на основе содержимого плана, если вы ещё не установили имя |
После того как сеанс назван, вернитесь к нему с помощью claude --resume <name> или /resume <name>. См. Возобновление сеанса для информации о том, как разрешение имён работает в worktrees.
Использование средства выбора сеансов
Запустите /resume внутри сеанса или claude --resume без аргументов, чтобы открыть интерактивное средство выбора сеансов. Используйте эти сочетания клавиш для навигации, поиска и расширения списка:
| Сочетание клавиш | Действие |
|---|---|
↑ / ↓ |
Навигация между сеансами |
→ / ← |
Развёртывание или свёртывание сгруппированных сеансов |
Enter |
Возобновление выделенного сеанса |
Space |
Предпросмотр содержимого сеанса. Ctrl+V также работает на терминалах, которые не захватывают его как вставку |
Ctrl+R |
Переименование выделенного сеанса |
/ или любой печатный символ, кроме Space |
Вход в режим поиска и фильтрация сеансов. Вставьте URL pull или merge request GitHub, GitHub Enterprise, GitLab или Bitbucket, чтобы найти сеанс, который его создал |
Ctrl+A |
Показать сеансы из всех проектов на этой машине. Нажмите снова, чтобы вернуться к текущему репозиторию |
Ctrl+W |
Показать сеансы из всех worktrees текущего репозитория. Нажмите снова, чтобы вернуться к текущему worktree. Отображается только в репозиториях с несколькими worktrees |
Ctrl+B |
Фильтр к сеансам из текущей ветви git. Нажмите снова, чтобы показать все ветви |
Esc |
Выход из средства выбора сеансов или режима поиска |
Каждая строка показывает имя сеанса, если оно установлено, в противном случае сводку диалога или первую подсказку, а также время с момента последней активности, количество сообщений и ветвь git. Путь проекта отображается после расширения на все проекты с помощью Ctrl+A.
Разветвлённые сеансы, созданные с помощью /branch, /rewind или --fork-session, сгруппированы под их корневым сеансом. Нажмите → для развёртывания группы.
Создание ветви сеанса
Создание ветви создаёт копию диалога до сих пор и переключает вас в неё, оставляя оригинал нетронутым. Используйте это, чтобы попробовать другой подход без потери пути, на котором вы были.
Из активного сеанса запустите /branch с необязательным именем:
/branch try-streaming-approach
Из командной строки объедините --continue или --resume с --fork-session:
claude --continue --fork-session
Исходный сеанс остаётся неизменным и остаётся доступным в средстве выбора сеансов. Подтверждение /branch выводит два ID сеанса: новую ветвь, в которой вы находитесь, и оригинал. Чтобы вернуться к оригиналу, передайте его ID в /resume, используйте средство выбора сеансов или запустите /resume <original-name>. Разрешения, которые вы одобрили с помощью "allow for this session", не переносятся на новую ветвь. Если вы возобновите один и тот же сеанс в двух терминалах без разветвления, сообщения из обоих будут чередоваться в одной стенограмме.
Для перемотки на основе контрольных точек в одном сеансе см. Checkpointing.
Управление контекстом в сеансе
Эти команды управляют тем, что находится в окне контекста, не покидая сеанс:
/clear: начать заново с пустым контекстом. Предыдущий диалог сохраняется и может быть возобновлен/compact [instructions]: заменить историю сводкой, опционально сосредоточенной на том, что вы указали/context: показать, что в настоящее время потребляет контекст
О том, как уплотнение взаимодействует с CLAUDE.md, skills и правилами, см. руководство по окну контекста. Для стратегий о том, когда очищать или уплотнять, см. Best practices.
Экспорт и поиск данных сеанса
Запустите /export, чтобы скопировать текущий диалог в буфер обмена или сохранить его как простой текстовый файл с сообщениями и выводом инструментов, отображаемыми как читаемый текст. Передайте имя файла для прямой записи в этот файл.
Стенограммы хранятся как JSONL в ~/.claude/projects/<project>/<session-id>.jsonl, где <project> получается из пути вашего рабочего каталога. Каждая строка — это объект JSON для сообщения, использования инструмента или записи метаданных. Чтобы хранить сеансы в другом месте, чем ~/.claude, установите CLAUDE_CONFIG_DIR. Эти локальные файлы удаляются по умолчанию через 30 дней; измените это с помощью cleanupPeriodDays.
Чтобы полностью подавить запись стенограмм, установите CLAUDE_CODE_SKIP_PROMPT_HISTORY или в неинтерактивном режиме используйте --no-session-persistence.
См. также
На этих страницах рассматриваются связанные механики сеансов и параллелизма:
- Worktrees: запуск изолированных параллельных сеансов на отдельных ветвях
- Checkpointing: перемотка кода и диалога к более ранней точке
- Context window: что заполняет контекст и что выживает при уплотнении
- Non-interactive mode: поведение сеанса в
claude -p