Claude Code Session 恢复机制详解,从 --continue 到 /resume 的工程化工作流

📅 2026/7/5 13:32:09
Claude Code Session 恢复机制详解,从 --continue 到 /resume 的工程化工作流
写代码时最怕的不是 Claude Code 停下来,而是停下来以后,前面半小时、两个小时、甚至一整天积累的上下文断掉。一个复杂任务里,Claude Code 可能已经读过几十个文件,跑过测试,理解过某个模块的依赖关系,还和我们来回确认过实现边界。这个时候退出终端,或者执行/clear清空当前上下文,如果没有 session 恢复机制,整个协作过程就像刚整理好的会议白板被擦掉,只剩下一句模糊的记忆,刚才好像讨论过什么。Claude Code 的Resume a session解决的正是这个问题。它不是简单地保存一句最后的 prompt,也不是把终端屏幕内容复制下来,而是把工作过程持续写入本地 transcript 文件。官方文档把 session 定义为绑定到项目目录的已保存对话,Claude Code 会在工作过程中把它保存在本地,因此后续可以继续、分支、切换任务或回到之前的路径。CLI、桌面端、Web 端和 VS Code extension 各自维护自己的 session 历史,这里讨论的重点是 CLI 场景。(Claude)Session 不是聊天记录,而是项目现场很多人第一次接触 Claude Code session 时,会把它理解成普通聊天软件里的历史会话。这个理解只对了一半。普通聊天记录关心的是说过什么,Claude Code session 还关心这些话发生在哪个项目目