Перейти к основному содержимому

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

Средний
What you'll learn
  • Понять, что фиксирует контрольная точка — и что она молча не фиксирует
  • Открыть меню отката двумя способами и каждый раз выбирать правильное действие восстановления
  • Отличать «восстановить» (откат состояния) от «резюмировать» (сжатие контекста)
  • Точно знать, почему контрольные точки дополняют Git, но никогда его не заменяют

Главная идея​

Когда вы отпускаете Claude на амбициозное, масштабное изменение, самый пугающий вопрос — «а что, если всё пойдёт не так на третьей правке вглубь?» Контрольные точки — это ответ: Claude Code автоматически делает снимок вашего кода перед каждой правкой, так что вы можете откатиться к любому более раннему состоянию, а не распутывать вручную наполовину завершённый рефакторинг.

Считайте это локальной отменой для всей сессии — страховкой, которая позволяет сказать «да, попробуй смелый подход» без страха.

Как создаются контрольные точки​

Вы не создаёте контрольные точки — они возникают автоматически.

Guided walkthrough1 of 3
  1. Каждый пользовательский запрос фиксирует состояние вашего кода до того, как отработают инструменты редактирования файлов Claude. Никаких команд, никакой настройки, никаких церемоний.

Открытие меню отката​

Есть два способа войти:

Guided walkthrough1 of 2
  1. Введите слэш-команду в строке запроса. Работает всегда.

Open the rewind menu

/rewind

Меню перечисляет каждый запрос, отправленный вами в этой сессии. Выберите точку, с которой хотите работать, затем выберите одно действие.

Восстановить или резюмировать: ключевое различие​

Именно здесь люди путаются. Меню предлагает два вида действий:

  • Действия восстановления меняют состояние на диске и/или в разговоре — они отменяют.
  • Действия резюмирования никогда не трогают ваши файлы — они сжимают разговор, чтобы освободить место в окне контекста.
Watch out
  • Восстановить = отменить (откатывает код, разговор или и то, и другое). Резюмировать = сжать контекст (файлы на диске не трогаются).
  • Тянитесь к восстановлению, когда правка что-то сломала. Тянитесь к резюмированию, когда сессия раздута, но код в порядке.

Действия восстановления​

Guided walkthrough1 of 3
  1. Откатывает и ваши файлы, и историю чата к выбранной точке — чистая «перемотка времени» к этому моменту.

После восстановления разговора (или выбора «Резюмировать отсюда») исходный запрос из выбранного сообщения возвращается в поле ввода, чтобы вы могли отправить его повторно или отредактировать.

Действия резюмирования​

Оба сжимают часть разговора в сгенерированное ИИ резюме — как точечный /compact, где вы выбираете, какую сторону выбранного сообщения сжать.

Guided walkthrough1 of 2
  1. Сообщения ПЕРЕД выбранным сообщением остаются нетронутыми. Выбранное сообщение и всё после него становятся резюме. Используйте это, чтобы отбросить побочное обсуждение, сохранив ранний контекст во всех деталях.

Исходные сообщения в любом случае остаются в стенограмме сессии, так что Claude по-прежнему может ссылаться на детали. Вы можете ввести необязательные инструкции, чтобы направить, на чём фокусируется резюме.

Весь процесс см. в Управление контекстом — действия резюмирования /rewind — это скальпель, тогда как /compact — широкая кисть.

Откат за пределы /clear​

Если вы ранее в том же процессе Claude Code запускали /clear, меню отката показывает дополнительную запись вверху: /resume <session-id> (previous session). Выберите её, чтобы вернуться к разговору, который был активен до /clear.

Где контрольные точки останавливаются — ограничения, которые кусаются​

Контрольные точки кажутся волшебными, пока не перестают. Три пробела имеют значение:

Guided walkthrough1 of 3
  1. Файлы, затронутые shell-командами, которые запускает Claude — rm, mv, cp, генераторы кода, форматтеры — НЕ отслеживаются. Только прямые правки через инструменты редактирования файлов Claude попадают в контрольные точки. Удалённый через rm файл потерян с точки зрения отката.

Контрольные точки против Git: используйте оба​

Они решают разные задачи, поэтому сочетайте их.

Контрольные точки (/rewind)Git
ОбластьОдна сессияВся история проекта
ДетализацияНа каждый запрос, автоматическиНа каждый коммит, намеренно
Отслеживает изменения через bash?НетДа (после добавления/коммита)
Срок жизни~30 дней, затем исчезаютПостоянно
Совместное использование / коллаборацияНетДа
Ментальная модель«Локальная отмена»«Постоянная история»
Pro tip
  • Фиксируйте рабочие состояния в Git перед рискованным, масштабным запуском — это ваш надёжный фундамент.
  • Используйте /rewind для быстрого восстановления внутри сессии между коммитами, не засоряя историю Git.
  • Если Claude будет запускать разрушительный bash (rm/mv) или генераторы, опирайтесь на Git — откат не спасёт эти файлы.

Когда к этому прибегать​

Guided walkthrough1 of 4
  1. Попробуйте смелую реализацию, и если она вам не понравится, восстановите код и разговор к точке развилки и попробуйте другую.

Check yourself

0/3
  1. Claude выполнил `rm config.old.json` через bash-команду, и вы хотите вернуть файл. Может ли `/rewind` его восстановить?
  2. Ваш код в порядке, но долгий отход в отладку заполнил окно контекста. Какое действие подходит?
  3. Как создаётся контрольная точка?
Checkpoints & rewind vocabulary
Нажмите Enter или пробел, чтобы перевернуть карточку. Используйте стрелки влево и вправо для перехода между карточками.Показан термин.
1 / 5
Key takeaways
  • Контрольные точки — это автоматические снимки вашего кода на каждый запрос — локальная отмена для всей сессии, хранятся около 30 дней.
  • Открывайте меню отката через /rewind или двойной Esc при пустом поле ввода; оно перечисляет каждый отправленный вами запрос.
  • Действия восстановления отменяют состояние (код, разговор или и то, и другое); действия резюмирования сжимают контекст и никогда не трогают файлы.
  • Изменения через bash, внешние и параллельные изменения НЕ отслеживаются — только прямые правки через файловые инструменты.
  • Контрольные точки дополняют Git, а не заменяют его: думайте «локальная отмена» против «постоянной, разделяемой истории».

Далее​