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 还关心这些话发生在哪个项目目