Docs 检查点

检查点

跟踪、倒带和总结 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 视为“永久历史记录”

另请参阅