Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Сеанс — это сохранённый диалог, привязанный к каталогу проекта. Claude Code сохраняет его локально по мере работы, поэтому вы можете возобновить работу с того же места, создать ветвь для попытки другого подхода или переключаться между задачами.
Настольное приложение, Claude Code в веб-версии и расширение VS Code каждое ведёт собственную историю сеансов. На этой странице рассматривается CLI:
Возобновление сеанса
Сеансы сохраняются непрерывно в локальные файлы стенограмм по мере работы, поэтому вы можете вернуться к одному из них после выхода или запуска /clear. Используйте эти точки входа:
| Команда | Что она делает |
|---|
claude --continue | Возобновляет самый последний сеанс в текущем каталоге |
claude --resume | Открывает средство выбора сеансов |
claude --resume <name> | Возобновляет именованный сеанс напрямую |
claude --from-pr <number> | Возобновляет сеанс, связанный с этим pull request |
/resume | Переключается на другой диалог из активного сеанса |
claude -p или Agent SDK, не отображаются в средстве выбора сеансов, но вы всё равно можете возобновить один, передав его ID сеанса в claude --resume <session-id>.
Где средство выбора сеансов ищет сеансы
Сеансы хранятся для каждого каталога проекта. По умолчанию средство выбора сеансов показывает интерактивные сеансы из текущего worktree, а также сеансы, запущенные в других местах, которые добавили текущий каталог с помощью /add-dir. Используйте 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 | Выход из средства выбора сеансов или режима поиска |
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.
См. также
На этих страницах рассматриваются связанные механики сеансов и параллелизма:
