Deepseek ArtifactsDeepseek Artifacts
Гайд по чекпоинтам

Чекпоинты Claude Code: как откатить код и диалог

Каждый промпт в Claude Code — это чекпоинт, к которому можно вернуться. Разбираем /rewind и двойное Esc, три варианта восстановления, что захватывают чекпоинты (а что нет), лимиты хранения и как они дополняют git — сверено с официальной документацией.

Коротко

  • Чекпоинты автоматические: каждый промпт, открывающий новый ход, сперва снимает снапшот вашего кода. Настраивать ничего не нужно — достаточно знать, как откатить.
  • Запустите /rewind (или дважды нажмите Esc с пустым промптом) — откроется меню точек восстановления, каждая предлагает: восстановить код и диалог, только диалог или только код.
  • Rewind — это восстановление уровня сессии, а не версионирование: побочные эффекты через Bash (rm, mv, cp), большинство правок субагентов и ваши ручные правки не захватываются. Коммитить в git не переставайте.
  • Claude Code держит 100 последних чекпоинтов сессии около 30 дней (настраивается cleanupPeriodDays), и чекпоинты переживают /resume — вчерашнюю сессию можно откатить сегодня.

12 Claude Code Features Every Engineer Should Know: Subagents, CLAUDE.md, Checkpoints, MCP, and more

Канал: ByteByteAI7:30

Смотреть

Claude Code Checkpoints Are Here (First Look)

Канал: Build at Scale8:16

Смотреть

Checkpointing — official documentation

Официальная документация: code.claude.com/docs

Смотреть

Каждый вариант восстановления, лимит и число хранения на этой странице сверены с официальной документацией по чекпоинтам; видео выше — визуальные и фактические источники.

Скриншоты принадлежат их авторам и снабжены прямыми ссылками на точные таймкоды. Кадры с лицами не используются.

Откатываемся чекпоинтами Claude Code, шаг за шагом

Часть 1 — Что попадает в снапшот

  1. 1

    Поймите, что такое чекпоинт

    Чекпоинт — это автоматический снапшот состояния кода, снимаемый перед каждым промптом, открывающим новый ход. Он существует затем, чтобы неудачный рефакторинг, чересчур ретивая правка или неверное направление откатывались одной командой — без stash, без коммитов, без церемоний.

    Claude Code checkpoints feature intro card with the snapshot camera icon from a twelve features explainer
    О чекпоинтах в двух словах: снапшот перед каждой правкой, откат кода и диалога, когда эксперимент пошёл вкривь.Смотреть на 2:15
  2. 2

    Каждый промпт, открывающий ход, создаёт один

    Чекпоинты вручную не создаются — каждый промпт, запускающий Claude в работу, снимает файлы, которые он собирается тронуть. Длинная сессия выстраивает цепочку точек восстановления, по одной на промпт, — как автосейвы для вашего репозитория.

    Claude Code edit loop diagram showing a snapshot captured for every edit with checkpoint snapshots numbered one through k
    Цикл правок: Claude редактирует, снапшот ложится в цепочку чекпоинтов, следующий промпт открывает новый круг.Смотреть на 2:33
  3. 3

    Откройте меню rewind через /rewind

    Введите /rewind в промпте — получите список чекпоинтов текущей сессии. Клавиатурный путь ещё быстрее: дважды нажмите Esc при пустом поле ввода. (Если в поле есть текст, двойное Esc его просто очистит — нажатое можно вернуть стрелкой ↑.)

    Claude Code /rewind command typed in the terminal to open the checkpoint list of the current session
    Вводим /rewind в промпте Claude Code — список чекпоинтов открывается прямо в сессии.Смотреть на 2:40
  4. 4

    Выберите точку восстановления

    В меню каждый чекпоинт указан вместе с промптом, который его создал, — «восстановить код и/или диалог к моменту до…». Доберитесь до момента, когда всё пошло не так, нажмите Enter и выберите, что восстанавливать.

    Claude Code rewind restore menu offering to restore the code and conversation to the point before an earlier prompt
    Меню восстановления: выбрать промпт перед ошибкой — красным подсвечены предыдущие вопросы этой сессии.Смотреть на 2:45

Часть 2 — Меню rewind

  1. 5

    Восстановите код и диалог вместе

    Полный откат: файлы возвращаются к состоянию снапшота, а диалог развилки назад, к той точке. Используйте, когда неверным было всё направление — сбрасываются и код, и память Claude о задаче.

  2. 6

    Восстановите только код — диалог останется

    Восстановление одного кода откатывает файлы, пока диалог остаётся на месте. Идеально для «подход верный, результат нет»: Claude помнит всё, что вы обсуждали, а сломанные правки исчезли.

  3. 7

    Восстановите только диалог — сделайте форк чата

    Третий вариант отматывает диалог к более ранней точке и не трогает файлы — то же ветвление, которое делало двойное Esc ещё до чекпоинтов. Код в порядке, а обсуждение унесло в сторону? Это ваш случай.

  4. 8

    Вместо отката — резюмируйте отсюда

    В меню есть и "Summarize from here", и "Summarize up to here" — прицельный /compact, который сжимает участок диалога в резюме, сохраняя ваши начальные инструкции. Для настоящего форка берите /branch или claude --continue --fork-session.

Часть 3 — Ограничения и привычка к git

  1. 9

    Знайте, что rewind не отменяет

    Чекпоинты отслеживают правки файлов, которые делает Claude, а не вообще всё: изменения через Bash (rm, mv, cp), большинство правок субагентов, ваши ручные правки и изменения из других сессий не захватываются. Симлинки пропускаются — восстановление сообщит "Restored the code, but skipped N files".

  2. 10

    Чекпоинты vs git: разделите труд

    Чекпоинты — для быстрого восстановления уровня сессии: отменить этот промпт, попробовать ту идею снова. Git — для постоянной истории: коммитьте рабочие состояния, ветвьтесь, пушьте. Рекомендуемый ритм — откатываться смело в процессе исследования и осознанно коммитить, когда изменение стоит сохранить.

  3. 11

    Следите за окном хранения

    Claude Code держит 100 последних чекпоинтов на сессию и выметает старые снапшоты примерно через 30 дней — тот же cleanupPeriodDays, что управляет историей переписки. Продлите его в settings.json, если хотите, чтобы /rewind и /resume дотягивались дальше.

Чекпоинты vs git vs /branch vs двойное Esc vs /compact

В Claude Code пять способов вернуться назад — каждый решает свою задачу:

  • 1Чекпоинты (/rewind) — мгновенно, автоматически, на уровне сессии: отмена кода, диалога или обоих до любой границы промпта. Без настройки, не навсегда, не разделяется.
  • 2Git — настоящая история: явные коммиты, которые вы делаете, когда работу стоит сохранить. Чекпоинты его не заменяют — они стоят в цепочке безопасности перед ним.
  • 3/branch и --fork-session — запустите параллельную линию времени из текущего диалога, не трогая файлы. Когда нужно исследовать альтернативу, сохранив обе линии.
  • 4Двойное Esc — клавиатурный путь к тому же меню rewind при пустом промпте; с текстом в поле оно просто очищает ввод (история хранит, верните стрелкой ↑).
  • 5/compact и "Summarize from here" — не перемещение по диалогу, а его сжатие: возвращаем контекст ценой деталей, решения остаются.

Простая ментальная модель: ошибки — rewind, прогресс — git, альтернативы — fork, место — summarize.

Rewind сработал не так, как вы ждали?

Четыре частых сюрприза с чекпоинтами и что с ними делать:

  • 1"No files were restored". Снапшоты выметены — превышен лимит в 100 чекпоинтов или истекло ~30-дневное хранение. Увеличьте cleanupPeriodDays в settings.json, чтобы хвост был длиннее.
  • 2"Restored the code, but skipped N files". Симлинки и хардлинки пропускаются по замыслу. Запустите /debug и загляните в ~/.claude/debug/<session-id>.txt за точным списком пропущенных путей — их придётся откатить руками.
  • 3Файлы, изменённые через Bash, не изменились. rm, mv и cp исполняются в шелле, вне системы снапшотов — отменяйте через git checkout или восстанавливайте из бэкапов.
  • 4Нужного промпта нет в списке. Сообщения, дошедшие в очередь посреди хода, чекпоинтов не создают — откатывайтесь к ближайшему промпту, открывающему ход, а правки субагентов могут потребовать git revert.
  • 5Команды /rewind вообще нет. Чекпоинты появились в Claude Code 2.0 — проверьте версию через claude update (или claude doctor); имейте в виду, что совсем старые сессии, созданные до этой функции, не имеют снапшотов для отката.

Золотое правило: если изменение важно — коммить. Чекпоинты — подушка, git — ремень. Пользуйтесь обоими.

FAQ по чекпоинтам

Похожие гайды