37 · Checkpoints 检查点与回滚指南

检查点如何保存文件修改、查看历史和恢复到安全状态，说明它能回滚什么、不能替代什么，以及和 Git 的正确配合。

Checkpoints（检查点）是 Claude Code 的一个「后悔药」功能：它记录文件的修改状态，让你能回滚。这一篇讲清它的能力和边界。

「如何保存」：它会在某些节点记录文件的修改状态，形成一个「检查点」。你可以把它理解成「自动存档」。

「查看历史」：你能看到各个检查点，了解「什么时候、文件是什么状态」。

「恢复到安全状态」：发现问题后，可以回退到之前的某个检查点，把文件恢复到那个状态。

「能回滚什么」：主要是「文件的修改」。它能把被改坏的文件恢复回去。

「不能替代什么」：它不能替代 Git。检查点是一个「安全网」，但不是「版本控制系统」。真正的版本管理、分支、合并、协作，还得靠 Git。

「和 Git 的配合」是正确姿势：用 Git 做真正的版本管理，用 Checkpoints 做「快速回退」的补充。两者不冲突，而是互补——Git 管「长期的、可协作的版本」，检查点管「临时的、快速的后悔药」。

给你的提醒：别因为有检查点就放松对 Git 的使用。检查点是「救急」的，Git 才是「正规军」。

理解检查点的「能」与「不能」，你才能在关键时刻正确地用它救场，而不是误以为它万能。

常见误区：很多新手会把这一篇讲的「基本规则」当成「教条」——什么都严格遵守。其实这些规则的核心是「降低风险、提高效率」，理解了动机，规则就自然内化了，不用死记硬背。

动手试一下：你可以花 5 分钟做一个最小验证——找一个真实的代码任务，让 Codex 跑一遍，看它的行为是不是和这一篇描述的一致。理论与实践对照，才知道「懂」和「会用」是两件事。

与其他篇的关系：这一篇是本组的基础。如果你跳过了前面几篇，建议先回去看，否则这里有些概念可能看着突兀。如果都看过了，那你可以直接进入更后面的实战环节，把这里学到的东西用上。

判断决策树：用三个问题判断该不该用——① 这件事值不值得用 Codex 做？② 用的话该用哪个入口？③ 风险高不高需不需要审批？三个问题的答案一出来，怎么做就清楚了。