检查点的工作原理
在您与 Claude 协作时，检查点功能会在您发送每条开启新轮次的提示词之前，自动捕获代码的状态。自动跟踪
Claude Code 会跟踪其文件编辑工具所做的所有更改：- 您发送的每条开启新轮次的提示词都会创建一个新的检查点
- Claude Code 会为会话中最近的 100 个检查点保留文件快照。丢弃较旧的检查点时，会删除不再被任何剩余检查点引用的快照文件，但每个文件的首个快照除外，VS Code 扩展会将其用作会话 diff 的基线。
- Claude Code 会将检查点与对话一起保存，因此在恢复会话后您仍然可以运行
/rewind - Claude Code 会在保留期清理中删除会话的文件快照，默认情况下约为该会话最后一次保存快照后的 30 天。回退到快照已被删除的检查点时，可能会失败并显示
No files were restored。如需更长时间地保留快照，请设置cleanupPeriodDays。
回退与摘要
运行/rewind，或在提示词输入框为空时按两次 Esc，即可打开回退菜单。
如果提示词输入框中有文本，双击
Esc 会清除该文本，而不是打开菜单。被清除的文本会保存到输入历史记录中，因此在回退菜单中操作完成后，按 Up 即可找回。- Restore code and conversation：将代码和对话都恢复到该位置
- Restore conversation：回退到该消息，同时保留当前代码
- Restore code：还原文件更改，同时保留对话
- Summarize from here：将从该位置开始往后的对话压缩为摘要，以释放上下文窗口空间
- Summarize up to here：将该位置之前的对话压缩为摘要，并完整保留之后的消息
- Never mind：返回消息列表，不做任何更改
如果在发送下一条提示词之前退出，已回退的消息可能会重新出现
要再次移除重新出现的消息，请在该会话中运行/rewind 并选择同一条提示词，然后选择 Restore conversation。在退出之前，请向 Claude 发送一条提示词，因为 Claude Code 会将回退后的对话与该提示词一起保存。您已恢复的文件会保持回退后的状态。
回退到已清除的对话之前
如果您之前在同一个 Claude Code 进程中运行过/clear，回退菜单会在列表顶部显示一个额外条目，标记为 /resume <session-id> (previous session)。选择该条目即可恢复运行 /clear 之前处于活动状态的对话。在您退出 Claude Code 或恢复其他会话之前，该条目会一直可用。
引导摘要
摘要不会更改磁盘上的文件，原始消息也会保留在会话记录中，因此 Claude 仍然可以引用其中的细节。如需引导摘要的侧重点，请使用方向键高亮某个 Summarize 选项，在该行显示 add context (optional) 的位置输入说明，然后按Enter。使用数字键选择该选项则会立即生成摘要，不附带任何说明。
摘要会让您停留在同一会话中并压缩上下文，类似于有针对性的
/compact。如果想在完整保留原始会话的同时另起分支尝试不同的方法，请改用 /branch 或 claude --continue --fork-session。常见用例
Checkpoints 在以下情况下特别有用：- 探索替代方案：尝试不同的实现方法，而不会丢失起点
- 从错误中恢复：快速撤销引入错误或破坏功能的更改
- 迭代功能：进行变体实验，知道您可以恢复到工作状态
- 释放上下文空间：从中点开始总结冗长的调试会话，保持初始说明完整
限制
Bash 命令更改未跟踪
一旦 Claude 在您的对话中使用其文件编辑工具编辑过某个文件，/rewind 就会撤销之后 Bash 命令对该文件所做的更改。仅由 Bash 命令更改过的文件不会被跟踪，并保持原样。要还原此类文件，请使用版本控制，例如 Git。
在每条提示词下，回溯菜单会统计对 Claude 已编辑过的文件所做的更改，无论这些更改由什么产生。如果某条提示词中有 shell 命令更改了此类文件，该提示词同样会列出文件更改。
子代理编辑未恢复
子代理使用 Claude 的文件编辑工具进行编辑，但 Claude Code 通常不会在您的会话检查点中捕获这些编辑。回溯是否恢复这些编辑取决于子代理的运行方式：- 前台分叉技能：具有
context: fork的技能在前台运行，在您自己的回合期间编辑您的工作树，因此回溯会照常恢复其编辑。设置background: false以在前台运行分叉；有几种情况（列在技能页面上）无论设置如何都会在那里运行。 - 任何其他子代理：回溯只会恢复 Claude 已在您的对话中编辑过的文件。子代理对其他文件的编辑会保留，因此请使用版本控制（例如 Git）来还原它们。这包括在后台运行的分叉 skill（默认设置）和后台
/code-review --fix运行。
外部更改未跟踪
Checkpointing 仅跟踪在当前会话中编辑过的文件。您在 Claude Code 外部对文件所做的手动更改以及来自其他并发会话的编辑通常不会被捕获，除非它们碰巧修改了与当前会话相同的文件。中途发送的消息未检查点
在回溯菜单中，您在 Claude 仍在工作时输入的消息可能会被标记为 No code restore。被标记的消息没有属于自己的检查点。 要撤销 Claude 在该消息之后所做的文件编辑，请选择启动该轮次的提示词，然后选择 Restore code 或 Restore code and conversation。这会还原 Claude 在整个轮次中所做的文件编辑，包括您的消息到达之前所做的编辑。符号链接和硬链接路径未恢复
检查点功能不会回溯符号链接或硬链接文件。当您从/rewind 菜单中选择 Restore code 或 Restore code and conversation 时，Claude Code 会跳过任何是符号链接或硬链接的跟踪路径，并显示 Restored the code, but skipped N files 警告。跳过的文件保持其当前内容。要撤销会话对其中一个文件的更改，请要求 Claude 反转编辑或自己编辑文件。dotfile 管理器符号链接到您项目中的配置文件，以及 pnpm 硬链接到位的文件，都属于此类别。
要查看恢复跳过的路径，请在恢复前使用 /debug 打开调试日志：~/.claude/debug/<session-id>.txt 中的调试日志会列出每个跳过的路径。有关每个跳过原因和恢复步骤，请参阅错误参考中的 skipped-files 条目。
不是版本控制的替代品
Checkpoints 设计用于快速的会话级恢复。对于永久版本历史和协作，继续使用版本控制（例如 Git）进行提交、分支和长期历史。另请参阅
- Interactive mode - 快捷键和会话控制
- Commands - 使用
/rewind访问 checkpoints - CLI reference - 命令行选项