第五章. 安全网：Checkpoints 与 Rewind

本章学习路径

5.1. 为什么需要安全网

上一章我们学会了如何与 Claude 高效交互。但有个问题一直悬在心头：万一 Claude 改错了怎么办？

5.1.1. AI 不是万能的：它会犯错

Claude 很强，但它不是神。它可能会：

• 误解你的意图，改错文件
• 重构代码时引入新 bug
• 删除了不该删的内容

“那我是不是每次让它改代码前，都要手动备份一下？”

不用。Claude Code 已经帮你做了这件事。

5.1.2. Checkpoints 的设计哲学

Claude Code 的设计理念是：让你敢于大胆尝试。

每当 Claude 通过 Edit（编辑）或 Write（写入）工具修改文件时，系统会自动创建一个 Checkpoint。这就像游戏里的自动存档——你不需要手动操作，系统默默帮你记录每一个关键节点。

1
2
3
4
5
6
7
8
9
10

你的操作                    系统行为
    │                          │
    ▼                          ▼
"帮我重构这个函数"  ──────►  [自动创建 Checkpoint]
    │                          │
    ▼                          ▼
Claude 修改了代码   ──────►  [记录修改前的状态]
    │                          │
    ▼                          ▼
"糟糕，改错了！"    ──────►  [可以回滚到 Checkpoint]

5.2. Checkpoints 自动存档机制

既然是 “自动” 存档，我们就需要搞清楚：什么操作会触发存档，什么操作不会。

5.2.1. 什么操作会触发存档

Claude Code 会在以下情况自动创建 Checkpoint：

5.2.2. 什么操作不会被追踪（重要）

这是很多人踩坑的地方：通过 Bash 命令执行的文件操作，不会被 Checkpoint 追踪。

1
2
3
4
5

# 以下操作不会创建 Checkpoint，也无法通过 /rewind 恢复！
rm important-file.js        # 删除文件
mv old.js new.js            # 移动/重命名文件
cp source.js dest.js        # 复制文件
sed -i 's/old/new/g' file   # 直接修改文件内容

“为什么 Bash 命令不追踪？”

因为 Checkpoint 机制是基于 Claude 的 Edit/Write 工具实现的。当你让 Claude 执行 Bash 命令时，它是直接调用系统命令，绕过了 Claude Code 的文件追踪层。

实际影响：

最佳实践：如果你要做破坏性操作（删除、移动），建议先用 Git 提交一个版本，或者手动备份。

5.2.3. 本节小结

5.3. /rewind 一键回滚

有了 Checkpoint，下一步就是学会如何 “读档”。这就是 /rewind 命令的用武之地。

5.3.1. 基本用法：回到上一个检查点

最简单的用法：

1

› /rewind

执行后，Claude Code 会显示最近的 Checkpoint 列表，让你选择要回滚到哪个点：

1
2
3
4
5
6
7
8

› /rewind

可用的检查点：
  [1] 2 分钟前 - 修改了 src/utils/auth.js
  [2] 5 分钟前 - 创建了 src/components/Button.jsx
  [3] 12 分钟前 - 修改了 package.json

选择要回滚到的检查点 (1-3):

输入数字，回车确认，文件就会恢复到那个时间点的状态。

5.3.2. 快捷回滚：双回车

“我就想回到上一步，不想选来选去。”

在 Claude 刚执行完一个操作后，直接按两下回车，可以快速撤销刚才的修改。

这个操作等同于 “回滚到最近一个 Checkpoint”，适合 “刚改完就发现不对” 的场景。

5.3.3. 回滚后会发生什么

回滚操作会：

• ✅ 恢复文件内容到指定 Checkpoint 的状态
• ✅ 保留对话历史（你和 Claude 的聊天记录还在）
• ❌ 不会恢复 Bash 命令造成的更改

“回滚后，Claude 知道我回滚了吗？”

知道。Claude 会看到你执行了 /rewind，并且了解当前文件状态。你可以继续对话，告诉它 “刚才那个方案不行，换一种思路”。

5.3.4. 本节小结

5.4. 最佳实践：大胆尝试的底气

有了 Checkpoint 和 /rewind，你应该建立一种新的工作心态：大胆尝试，快速回滚。

5.4.1. 实验性修改前的心态

以前没有安全网时，你可能会这样想：

“让 AI 重构这段代码？万一改崩了怎么办… 算了，还是我自己慢慢改吧。”

现在有了 Checkpoint，你应该这样想：

“让 Claude 试试看，反正改崩了我一个 /rewind 就回来了。”

这种心态转变非常重要。它让你能够：

• 尝试更激进的重构方案
• 让 Claude 探索多种实现思路
• 快速验证想法，而不是纠结于 “万一失败”

5.4.2. 回滚后如何重新引导 Claude

回滚不是终点，而是新的起点。回滚后，你需要告诉 Claude 为什么之前的方案不行：

1
2
3
4
5

› /rewind
[选择了检查点 1]

› 刚才的重构方案有问题，它破坏了原有的 API 兼容性。
  请换一种方式：保持函数签名不变，只优化内部实现。

给 Claude 明确的反馈，它下次就能做得更好。

5.4.3. 本节小结

5.5. 本章总结与安全网速查

本章我们学习了 Claude Code 的 “后悔药” 机制：Checkpoint 自动存档 + /rewind 一键回滚。有了这套安全网，你可以放心地让 Claude 大展拳脚，不用担心 “改崩了回不去”。

5.5.1. 场景速查：遇到这些情况，直接用

场景 1：Claude 刚改完代码，发现改错了

直接按两下回车，快速撤销。

场景 2：想回到 10 分钟前的状态

1

› /rewind

然后选择对应的检查点。

场景 3：要执行危险的删除操作

先手动备份或 Git commit，因为 Bash 命令不被 Checkpoint 追踪：

1

git add -A && git commit -m "备份：准备执行删除操作"

场景 4：回滚后想让 Claude 换个思路

1

› 刚才的方案不行，因为 [具体原因]。请换一种方式：[新的要求]