检查点
跟踪、倒带和总结 Claude 的编辑和对话以管理会话状态。
跟踪、倒带和总结 Claude 的编辑和对话以管理会话状态。
Claude Code 在您工作时自动跟踪 Claude 的文件编辑,让您可以快速撤消更改并在出现任何偏离轨道时回退到之前的状态。
检查点如何工作
当您使用 Claude 时,检查点会在每次编辑之前自动捕获代码的状态。这个安全网让您可以执行雄心勃勃的大规模任务,因为您知道您始终可以返回到先前的代码状态。
自动追踪
Claude Code 跟踪其文件编辑工具所做的所有更改:
- 每个用户提示都会创建一个新的检查点
- 检查点在会话中持续存在,因此您可以在恢复的对话中访问它们
- 30天后随会话一起自动清理(可配置)
回顾并总结
按 Esc 两次 (Esc + Esc) 或使用 /rewind 命令打开快退菜单。可滚动列表显示会话中的每个提示。选择您想要执行操作的点,然后选择一个操作:
- 恢复代码和对话:将代码和对话恢复到该点
- 恢复对话:回退到该消息,同时保留当前代码
- 恢复代码:在保持对话的同时恢复文件更改
- 从这里总结:将当前点的对话压缩为摘要,释放上下文窗口空间
- 没关系:返回消息列表而不进行更改
恢复对话或摘要后,所选消息的原始提示将恢复到输入字段中,以便您可以重新发送或编辑它。
恢复与总结
三个恢复选项可恢复状态:它们撤消代码更改、对话历史记录或两者。 “从这里总结”的工作方式有所不同:
- 所选消息之前的消息保持不变
- 所选消息和所有后续消息将替换为 AI 生成的紧凑摘要
- 磁盘上的文件没有改变
- 原始消息保留在会话记录中,因此 Claude 可以在需要时参考详细信息
这与 /compact 类似,但有针对性:您无需总结整个对话,而是保留早期上下文的完整细节,并且仅压缩占用空间的部分。您可以键入可选说明来指导摘要的重点内容。
注意
总结使您保持在同一个会话中并压缩上下文。如果您想分支并尝试不同的方法,同时保持原始会话完好无损,请使用 fork 代替 (claude --continue --fork-session)。
常见用例
检查点在以下情况下特别有用:
- 探索替代方案:在不失去起点的情况下尝试不同的实施方法
- 从错误中恢复:快速撤消引入错误或破坏功能的更改
- 迭代功能:尝试各种变化,知道您可以恢复到工作状态
- 释放上下文空间:从中点向前总结详细的调试会话,保持初始指令完整
限制
Bash 命令更改未跟踪检查点不跟踪 bash 命令修改的文件。例如,如果 Claude Code 运行:
rm file.txt
mv old.txt new.txt
cp source.txt dest.txt
这些文件修改无法通过倒回撤消。仅跟踪通过 Claude 的文件编辑工具进行的直接文件编辑。
未跟踪外部更改
检查点仅跟踪当前会话中已编辑的文件。通常不会捕获对 Claude Code 之外的文件进行的手动更改以及其他并发会话中的编辑,除非它们碰巧修改了与当前会话相同的文件。
不能替代版本控制
检查点旨在实现快速的会话级恢复。对于永久版本历史记录和协作:
- 继续使用版本控制(例如 Git)进行提交、分支和长期历史记录
- 检查点补充但不取代适当的版本控制
- 将检查点视为“本地撤消”,将 Git 视为“永久历史记录”