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

О чекпоинтах в двух словах: снапшот перед каждой правкой, откат кода и диалога, когда эксперимент пошёл вкривь.Смотреть на 2:15 - 2
Каждый промпт, открывающий ход, создаёт один
Чекпоинты вручную не создаются — каждый промпт, запускающий Claude в работу, снимает файлы, которые он собирается тронуть. Длинная сессия выстраивает цепочку точек восстановления, по одной на промпт, — как автосейвы для вашего репозитория.

Цикл правок: Claude редактирует, снапшот ложится в цепочку чекпоинтов, следующий промпт открывает новый круг.Смотреть на 2:33 - 3
Откройте меню rewind через /rewind
Введите /rewind в промпте — получите список чекпоинтов текущей сессии. Клавиатурный путь ещё быстрее: дважды нажмите Esc при пустом поле ввода. (Если в поле есть текст, двойное Esc его просто очистит — нажатое можно вернуть стрелкой ↑.)

Вводим /rewind в промпте Claude Code — список чекпоинтов открывается прямо в сессии.Смотреть на 2:40 - 4
Выберите точку восстановления
В меню каждый чекпоинт указан вместе с промптом, который его создал, — «восстановить код и/или диалог к моменту до…». Доберитесь до момента, когда всё пошло не так, нажмите Enter и выберите, что восстанавливать.

Меню восстановления: выбрать промпт перед ошибкой — красным подсвечены предыдущие вопросы этой сессии.Смотреть на 2:45
Часть 2 — Меню rewind
- 5
Восстановите код и диалог вместе
Полный откат: файлы возвращаются к состоянию снапшота, а диалог развилки назад, к той точке. Используйте, когда неверным было всё направление — сбрасываются и код, и память Claude о задаче.
- 6
Восстановите только код — диалог останется
Восстановление одного кода откатывает файлы, пока диалог остаётся на месте. Идеально для «подход верный, результат нет»: Claude помнит всё, что вы обсуждали, а сломанные правки исчезли.
- 7
Восстановите только диалог — сделайте форк чата
Третий вариант отматывает диалог к более ранней точке и не трогает файлы — то же ветвление, которое делало двойное Esc ещё до чекпоинтов. Код в порядке, а обсуждение унесло в сторону? Это ваш случай.
- 8
Вместо отката — резюмируйте отсюда
В меню есть и "Summarize from here", и "Summarize up to here" — прицельный /compact, который сжимает участок диалога в резюме, сохраняя ваши начальные инструкции. Для настоящего форка берите /branch или claude --continue --fork-session.
Часть 3 — Ограничения и привычка к git
- 9
Знайте, что rewind не отменяет
Чекпоинты отслеживают правки файлов, которые делает Claude, а не вообще всё: изменения через Bash (rm, mv, cp), большинство правок субагентов, ваши ручные правки и изменения из других сессий не захватываются. Симлинки пропускаются — восстановление сообщит "Restored the code, but skipped N files".
- 10
Чекпоинты vs git: разделите труд
Чекпоинты — для быстрого восстановления уровня сессии: отменить этот промпт, попробовать ту идею снова. Git — для постоянной истории: коммитьте рабочие состояния, ветвьтесь, пушьте. Рекомендуемый ритм — откатываться смело в процессе исследования и осознанно коммитить, когда изменение стоит сохранить.
- 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 — ремень. Пользуйтесь обоими.
