【Claude Code】Claude Code 的 Checkpoint 是怎么实现的

Claude Code 的 Checkpoint 是怎么实现的

概述

Checkpoint 是 Claude Code 提供的会话快照功能,可以保存当前对话的完整状态(消息、文件变更、上下文),并在需要时回退到指定时间点继续工作。


自动创建机制 : 每次用户输入都自动创建 Checkpoint ,无需手动创建

与 Git 的类比

Git 概念 Checkpoint 对应 说明
git commit /checkpoint 保存当前状态快照
git branch 并行任务线 支持多个独立工作流
git checkout /rewind 切换到指定快照
git stash 暂停任务 临时保存当前工作
git reset --hard /rewind --all 完全回退
git log /checkpoints list 查看历史

本质区别 :Checkpoint 是会话级的版本控制,不仅包含文件变更,还包含对话历史和 AI 上下文状态。


使用场景

场景 示例
错误恢复 误删代码后回退到上一个正确状态
分支探索 尝试新方案前创建 Checkpoint,不满意则回退
长任务保护 复杂任务中途自动创建 Checkpoint,防止丢失
上下文压缩 Checkpoint 作为压缩点,释放上下文窗口

checkpoint 管理

命令 说明
/checkpoint list 列出所有 checkpoints
/checkpoint show <id> 查看 checkpoint 详情
/checkpoint delete <id> 删除指定 checkpoint
/checkpoint prune 清理过期 checkpoints

如何调用不同的回退模式

回退命令

按两侧 Esc 或者 输入

bash 复制代码
/rewind

即可打开回退菜单,一个可滚动列表会把你的每条提示显示为检查点。选择某条消息后,你会看到四个选项:

复制代码
───────────────────────────────────────────────────────────────────────────────────────────────────
  Rewind

  Confirm you want to restore to the point before you sent this message: (回退前请确认你要保留到该点的内容)

  │ ckeckpoint 是怎么实现的
  │ (22h ago)

  The conversation will be forked.
  The code will be restored -368 in Claude Code的CheckPoint是怎么实现的.md.

  ❯ 1. Restore code and conversation (代码和对话都回到那一刻)
    2. Restore conversation  (只回退对话,保留当前文件/代码变更)
    3. Restore code (只回退文件/代码变更,保留对话)
    5. Summarize from here ( 在此处总结-将选定位置之后的所有内容压缩成摘要,保留该点之前对话的完整细)
    6. Never mind (取消操作)

什么时候用:Claude 自作主张改多了、改错方向了、或者你自己话说错了想重来

回退后,AI 会重新加载 Checkpoint 时的上下文

注意事项

注意事项 说明
操作不可逆 回退后,checkpoint 之后的变更会丢失
文件冲突 如果文件被外部修改,回退可能失败
回退会清除之后的 checkpoints 一旦回退到某个点,该点之后的 checkpoints 会被删除

/rewind 能回退几步?

能回到本次会话中任意一个 Claude 做出更改的节点,不限步数。但前提是这次会话还没关------关了会话再开回来,rewind 历史就丢了(但代码修改在磁盘上还在)

相关推荐
2301_767113988 天前
点过“不再询问”就要检查:Claude Code权限文件也可能存着密钥
git·信息安全·claude code
yz_aiks13 天前
Postman 自动给 Claude Code、Codex、Cursor 装插件怎么查和卸载:本机实测 5 处痕迹(Postman 12.34)
安全·postman·ai编程·开发工具·claude code
寻道码路15 天前
AI Agent 工程化开发实战(五):持久化与断点恢复——Checkpointer 与 Store
人工智能·大模型·checkpoint·持久化·ai agent·langgraph·ai工程化
VIP_CQCRE16 天前
Claude Code 如何接入 Ace Data Cloud?终端与 VS Code 配置指南
api·ai编程·vs code·claude code·ace data cloud
Aman198417 天前
Claude Code做Unity项目移植(二): 自动执行只读操作,告别频繁的
unity·游戏开发·vibe coding·claude code
GoldenSpider.AI17 天前
一张户型图做成浏览器 3D 漫游:house.json 统一模型、1.2 m 剖切图纸与分阶段验收
ai编程·webgl·three.js·3d漫游·claude code
瓶 盖18 天前
你的 IDE 插件改了 authorized_keys:Claude Code 扩展投毒链路拆解
ide·ssh·vs code·安全分析·供应链安全·claude code
Aman198418 天前
Claude Code做Unity项目移植(一):从零散工具到团队式
unity·游戏开发·vibe coding·claude code·项目迁移
deepseek2318 天前
Claude Code 2.1.314 新增工作目录写入边界:工具权限、沙箱与安全盲区怎么分层
人工智能·ai agent·claude code
yz_aiks18 天前
WorkBuddy 使用技巧:Claude Code 国内平替,签到免费用、自动签到和手机远程控制电脑
人工智能·ai编程·效率工具·claude code·workbuddy