Checkpoints и откат

Checkpoints позволяют сохранять состояние диалога и откатываться к предыдущим точкам сессии Claude Code. Это незаменимо, когда нужно опробовать разные подходы, откатить ошибки или сравнить альтернативные решения.

Обзор

Checkpoints позволяют сохранять состояние диалога и откатываться к предыдущим точкам, обеспечивая безопасное экспериментирование и проработку нескольких вариантов решения. Это снимки состояния вашего диалога, включающие:

• все обменённые сообщения
• сделанные изменения в файлах
• историю вызовов инструментов
• контекст сессии

Checkpoints незаменимы при проработке разных подходов, откате ошибок и сравнении альтернативных решений.

Ключевые понятия

Доступ к контрольным точкам

Есть два основных способа получить доступ к контрольным точкам и управлять ими:

С помощью сочетания клавиш

Дважды нажмите Esc (Esc + Esc), чтобы открыть интерфейс контрольных точек и просмотреть сохранённые точки.

С помощью slash-команды

Для быстрого доступа используйте команду /rewind (алиас: /checkpoint):

# Open rewind interface
/rewind

# Or use the alias
/checkpoint

Варианты перемотки

При перемотке появляется меню из шести вариантов:

1. Restore code and conversation - откатить и файлы, и сообщения к выбранной контрольной точке
2. Restore conversation - перемотать только сообщения, оставив текущий код как есть
3. Restore code - откатить только изменения файлов, сохранив всю историю переписки
4. Summarize from here - сжать переписку начиная с этой точки и далее в сгенерированное AI резюме, освободив место в контекстном окне. Сообщения до выбранной точки остаются без изменений. Файлы на диске не затрагиваются. Исходные сообщения сохраняются в транскрипте сессии. При желании можно задать инструкции, чтобы сфокусировать резюме на конкретных темах.
5. Summarize up to here - обратный вариант: сжать всё до выбранной точки в сгенерированное AI резюме, оставив сообщения от этой точки и далее нетронутыми. Вместе с «Summarize from here» это даёт двунаправленное точечное уплотнение контекстного окна. Файлы на диске не изменяются, а исходные сообщения сохраняются в транскрипте сессии.
6. Never mind - отменить и вернуться к текущему состоянию

Примечание: после восстановления переписки или создания резюме исходный prompt из выбранного сообщения возвращается в поле ввода - его можно отправить заново или отредактировать.

/clear больше не является жёсткой границей (v2.1.191+): /rewind может вернуть вас к контрольной точке, созданной до выполнения /clear. Очистка переписки больше не приводит к безвозвратной потере предшествующего состояния - вы можете перемотать назад через точку очистки, если снова понадобится более ранний код или контекст.

Автоматические контрольные точки

Claude Code создаёт контрольные точки автоматически:

• На каждый пользовательский prompt - новая контрольная точка создаётся при каждом вводе пользователя
• Устойчивость - контрольные точки сохраняются между сессиями
• Автоочистка - контрольные точки автоматически удаляются через 30 дней

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

Сценарии использования

Использование контрольных точек

Просмотр и откат

Нажмите Esc дважды или введите /rewind, чтобы открыть браузер контрольных точек. Вы увидите список всех доступных контрольных точек с временными метками. Выберите любую из них, чтобы откатиться к соответствующему состоянию.

Информация о контрольной точке

Для каждой контрольной точки отображается:

• Время создания
• Изменённые файлы
• Количество сообщений в диалоге
• Использованные инструменты

Практические примеры

Пример 1. Проработка разных подходов

User: Let's add a caching layer to the API

Claude: I'll add Redis caching to your API endpoints...
[Makes changes at checkpoint A]

User: Actually, let's try in-memory caching instead

Claude: I'll rewind to explore a different approach...
[User presses Esc+Esc and rewinds to checkpoint A]
[Implements in-memory caching at checkpoint B]

User: Now I can compare both approaches

Пример 2: Исправление ошибок

User: Refactor the authentication module to use JWT

Claude: I'll refactor the authentication module...
[Makes extensive changes]

User: Wait, that broke the OAuth integration. Let's go back.

Claude: I'll help you rewind to before the refactoring...
[User presses Esc+Esc and selects the checkpoint before the refactor]

User: Let's try a more conservative approach this time

Пример 3: Безопасное экспериментирование

User: Let's try rewriting this in a functional style
[Creates checkpoint before experiment]

Claude: [Makes experimental changes]

User: The tests are failing. Let's rewind.
[User presses Esc+Esc and rewinds to the checkpoint]

Claude: I've rewound the changes. Let's try a different approach.

Пример 4: Подходы к ветвлению

User: I want to compare two database designs
[Takes note of checkpoint - call it "Start"]

Claude: I'll create the first design...
[Implements Schema A]

User: Now let me go back and try the second approach
[User presses Esc+Esc and rewinds to "Start"]

Claude: Now I'll implement Schema B...
[Implements Schema B]

User: Great! Now I have both schemas to choose from

Хранение контрольных точек

Claude Code автоматически управляет контрольными точками:

• Контрольные точки создаются автоматически при каждом запросе пользователя
• Старые контрольные точки хранятся до 30 дней
• Контрольные точки автоматически удаляются, чтобы предотвратить неограниченный рост объёма хранилища

Шаблоны рабочих процессов

Стратегия ветвления для исследования вариантов

Когда вы прорабатываете несколько подходов:

1. Start with initial implementation → Checkpoint A
2. Try Approach 1 → Checkpoint B
3. Rewind to Checkpoint A
4. Try Approach 2 → Checkpoint C
5. Compare results from B and C
6. Choose best approach and continue

Паттерн безопасного рефакторинга

При внесении значительных изменений:

1. Current state → Checkpoint (auto)
2. Start refactoring
3. Run tests
4. If tests pass → Continue working
5. If tests fail → Rewind and try different approach

Рекомендации

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

Эффективное использование контрольных точек

✅ Рекомендуется:

• Просматривать доступные контрольные точки перед откатом
• Использовать откат, когда хотите попробовать другие подходы
• Сохранять контрольные точки для сравнения различных решений
• Понимать, что делает каждый вариант отката (восстановить код и диалог, восстановить только диалог, восстановить только код или создать сводку)

❌ Не рекомендуется:

• Полагаться исключительно на контрольные точки для сохранения кода
• Ожидать, что контрольные точки будут отслеживать изменения во внешней файловой системе
• Использовать контрольные точки вместо git commit'ов

Настройка

Контрольные точки - это встроенное поведение Claude Code по умолчанию, и никакой настройки для их включения не требуется. Каждый пользовательский prompt автоматически создаёт контрольную точку.

Поведением контрольных точек управляют две настройки: создаются ли снимки вообще и как долго они хранятся:

{
  "fileCheckpointingEnabled": true,
  "cleanupPeriodDays": 30
}

Обновление v2.1.117: cleanupPeriodDays теперь управляет сроком хранения для четырёх дисковых кешей, а не только для контрольных точек:

• Контрольные точки сессий
• ~/.claude/tasks/ - постоянные списки задач
• ~/.claude/shell-snapshots/ - сохранённые снимки shell-окружения
• ~/.claude/backups/ - скользящие резервные копии настроек и CLAUDE.md

Одна настройка теперь единообразно очищает все четыре каталога по истечении одного и того же числа дней.

Ограничения

У контрольных точек есть следующие ограничения:

• Изменения через команды Bash НЕ отслеживаются - операции вроде rm, mv, cp в файловой системе не фиксируются в контрольных точках
• Внешние изменения НЕ отслеживаются - изменения, сделанные вне Claude Code (в вашем редакторе, терминале и т. п.), не фиксируются
• Не заменяет систему контроля версий - используйте git для постоянных, отслеживаемых изменений в кодовой базе

Обновление v2.1.216: /rewind больше не восстанавливает и не удаляет файлы через символьные или жёсткие ссылки по отслеживаемым путям. Если отслеживаемый путь ведёт через symlink или hard link, /rewind пропускает его, не переходя по ссылке, и сообщает, сколько путей было пропущено по этой причине.

Устранение неполадок

Отсутствующие контрольные точки

Проблема: ожидаемая контрольная точка не найдена

Решение:

• Проверьте, не были ли контрольные точки очищены
• Проверьте свободное место на диске
• Убедитесь, что значение cleanupPeriodDays достаточно велико (по умолчанию: 30 дней)

Не удалось выполнить rewind

Проблема: невозможно откатиться к контрольной точке

Решение:

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

Интеграция с Git

Контрольные точки дополняют git (но не заменяют его):

1. Используйте checkpoints для быстрых экспериментов
2. Используйте git commits для финальных изменений
3. Создавайте checkpoint перед git-операциями
4. Коммитьте в git успешные состояния из checkpoints

Краткое руководство по началу работы

Базовый рабочий процесс

1. Работайте как обычно - Claude Code создаёт checkpoints автоматически
2. Хотите вернуться назад? - Нажмите Esc дважды или используйте /rewind
3. Выберите checkpoint - Выберите из списка нужную точку для отката
4. Выберите, что восстановить - Доступные варианты: восстановить код и переписку, восстановить только переписку, восстановить только код, суммировать от этой точки, суммировать до этой точки или отменить
5. Продолжайте работу - Вы снова в выбранной точке

Горячие клавиши

• Esc + Esc - Открыть браузер checkpoints
• /rewind - Альтернативный способ доступа к checkpoints
• /checkpoint - Псевдоним для /rewind

Когда стоит откатываться: мониторинг контекста

Checkpoints позволяют вернуться назад, но как понять, когда это нужно сделать? По мере роста переписки контекстное окно Claude заполняется, и качество модели незаметно деградирует. Вы можете выпускать код от «полуслепой» модели, даже не подозревая об этом.

cc-context-stats решает эту проблему, добавляя в статус-бар Claude Code зоны контекста в реальном времени. Утилита показывает, в какой части контекстного окна вы находитесь: от Plan (зелёная - можно спокойно планировать и писать код) через Code (жёлтая - не стоит начинать новые планы) до Dump (оранжевая - пора закругляться и откатываться). Когда зона меняется, это сигнал: пора зафиксировать checkpoint и начать с чистого листа, а не продавливать задачу с деградирующим выводом.

Связанные концепции

• Advanced Features - Режим планирования и другие продвинутые возможности
• Memory Management - Управление историей переписки и контекстом
• Slash Commands - Команды, вызываемые пользователем
• Hooks - Автоматизация на основе событий
• Plugins - Готовые пакеты расширений

Дополнительные ресурсы

• Официальная документация по checkpointing
• Руководство по Advanced Features - Extended thinking и другие возможности

Итог

Checkpoints - это встроенная функция Claude Code, которая позволяет безопасно пробовать разные подходы, не боясь потерять наработки. Каждый пользовательский prompt автоматически создаёт новый checkpoint, поэтому вы можете откатиться к любой предыдущей точке в сессии.

Ключевые преимущества:

• Экспериментируйте с разными подходами без опасений
• Быстро откатывайтесь после ошибок
• Сравнивайте решения бок о бок
• Безопасно интегрируйтесь с системами контроля версий

Помните: checkpoints не заменяют git. Используйте checkpoints для быстрых экспериментов, а git - для постоянных изменений в коде.

Последнее обновление: 25 августа 2026 г. Версия Claude Code: 2.1.245 Источники:

• https://code.claude.com/docs/en/checkpointing
• https://code.claude.com/docs/en/settings
• https://github.com/anthropics/claude-code/releases/tag/v2.1.117
• https://code.claude.com/docs/en/model-config Совместимые модели: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5