Claude Code /resume 怎么用？桌面版新功能与 5 种会话恢复方式详解（2026年8月）

Claude Code 的 /resume 是恢复历史会话的内置命令：在会话里输入 /resume 会弹出交互式会话列表，选中一条就能带着完整上下文回到那次对话。2026 年 8 月下旬起，桌面版也补上了这个入口，终端里创建的会话可以直接在桌面应用里恢复，两端双向打通。这篇文章把 5 种恢复方式、会话选择器快捷键、/rename 命名技巧一次讲清，全部内容对照 Anthropic 官方文档和 Changelog 核实，并附我们编辑部的实测踩坑记录。

本文你会看到：

• /resume 与 claude -c、claude -r、--from-pr 的区别
• 桌面版 /resume 新功能怎么用
• 会话选择器快捷键速查（很多旧教程写错了）
• 会话存在哪里、会不会过期
• 实测踩坑与常见问题 FAQ

Claude Code /resume 是什么？

/resume 是 Claude Code 的内置斜杠命令，用来恢复之前保存的对话会话。Claude Code 在你工作时会把对话持续保存为本地文本记录，所以无论是退出终端、关机下班，还是执行了 /clear 清空上下文，你都可以随时回到之前的对话——聊天记录、工具调用结果、代码修改的来龙去脉都还在。

它解决的是 AI 编程工具最常见的浪费：上下文断裂。昨天的功能写到一半，今天重新开对话，就得把背景、方案、已排除的思路全部重新描述一遍，token 和时间双输。有了 /resume，每次对话都可以"续上"。

桌面版 /resume 新功能：终端与桌面双向打通

2026 年 8 月下旬，Anthropic 为 Claude Code 桌面版补上了 /resume 会话恢复入口。在桌面应用里输入 /resume，会弹出历史会话列表，点选任意一个此前在 CLI 终端里开展的工作会话，完整的对话记录、代码片段、推理脉络会一并迁移到桌面端继续执行。

配合此前已有的 /desktop 命令（把当前终端会话推送到桌面），终端与桌面两端的会话已经支持双向自由切换。在此之前，桌面端没有等效的会话恢复入口，跨端切换就意味着丢上下文，这是社区从桌面版推出以来持续呼吁的痛点。

注意边界：根据官方文档，桌面应用、网页版 Claude Code 和 VS Code 扩展目前仍各自维护独立的会话历史记录，跨界面完全统一尚未完成。本文介绍的命令行为以 CLI 为准。

Claude Code 恢复会话的 5 种方式

不同场景该用哪个入口？下表全部摘自 Anthropic 官方"管理会话"文档：

几个容易忽略的细节：

• 脚本模式创建的会话不在选择器里：用 claude -p（headless）或 Agent SDK 创建的会话不会出现在会话选择器中，但可以用 claude --resume <session-id> 恢复。会话 ID 的查找范围仅限当前项目目录及其 git worktree，换目录会报 No conversation found with session ID。
• 会话按项目目录存储：claude -c 和 claude -r 默认只找当前目录的会话。在选择器里按 Ctrl+A 可以扩展到本机全部项目，按 Ctrl+W 扩展到当前仓库的所有 worktree。
• claude --resume <name> 与 /resume <name> 的模糊匹配行为不同：前者遇到模糊名称会打开选择器并预填搜索词；后者直接报错，需要运行不带参数的 /resume 打开选择器。
• **会话还在后台跑？用 claude attach**：v2.1.251 起，--resume 遇到仍在运行的后台会话时，提示语会直接给出对应的 claude attach <id> 命令。attach 是「接管正在运行的会话」，而不是把已结束的会话复制一份重来，长任务跑到一半想换个终端窗口时特别有用。

v2.1.251 更新：会话恢复的三处新变化

2026 年 8 月底发布的 v2.1.251 对会话恢复做了几处与日常体验直接相关的更新（摘自官方 Changelog）：

1. 恢复前能预判成本了：SessionStart 的 resume 钩子现在会收到会话新鲜度（staleness）和预估的 re-cache 成本。简单说，恢复一个搁置很久的会话前，脚本和提示能告诉你"这个会话放了多少天、恢复上来第一轮要额外花多少缓存重建的 token"——配合自动化脚本，可以做到"旧会话自动提醒开新会话"；
2. attach 等子命令进入官方帮助：claude --help 现在列出了 attach、logs、stop、respawn、rm 五个子命令，后台会话的接管、查日志、停止、重启和清理不再需要记文档；
3. 修复两类会话数据问题：一是 --input-format stream-json 恢复旧会话时消息可能丢失的问题；二是切换工作目录后，同 ID 的会话记录可能被静默覆盖的问题——这两类都与"会话恢复后内容不完整"的直接痛点相关。

/resume 会话选择器怎么用？快捷键一览

输入 /resume（或 claude --resume）后打开的会话选择器不只是个列表，它是搜索、预览、改名一体化的工作台。以下快捷键整理自官方文档：

每行会话显示：会话名称（或对话摘要）、距上次活动的时间、消息数和 git 分支。用 /branch、/rewind 或 --fork-session 创建的分叉会话会分组显示在根会话下，按 → 展开。

一个实测提醒：网上不少旧教程把快捷键写成 A / B / R / P 单键，那是过时的写法。新版本统一是 Ctrl + 字母组合键，直接按字母会进入搜索模式。如果你按旧教程操作"失灵"，不是功能坏了，以你本机选择器底部提示和官方文档为准。

/rename 和 /resume 怎么配合使用？

会话多了之后，"找到想恢复的那条"比"恢复"本身更花时间。/rename 就是为此准备的：给会话起一个描述性名字，之后用 claude --resume <name> 或 /resume <name> 按名直达。

• 启动时命名：claude -n auth-refactor
• 会话中命名：/rename auth-refactor，名字会同时显示在提示栏上
• 选择器里改名：高亮会话后按 Ctrl+R

从 v2.1.196 起，未命名的会话会自动获得默认显示名（如 my-app-3f），但默认名不是恢复句柄——claude --resume <name> 和 /resume <name> 只匹配你手动设置的名称。并行推进多个任务时，建议启动会话后第一件事就是 /rename。

会话存在哪里？会话会过期吗？

Claude Code 的对话记录默认以 JSONL 格式存储在 ~/.claude/projects/<项目路径编码>/.jsonl，每行是一条消息、工具调用或元数据。想导出给人类阅读，用 /export 命令；想给脚本用，官方提供了 headless 模式和 Agent SDK 等结构化接口。

会话默认保留 30 天（cleanupPeriodDays 设置可调），不是永不过期——这一点很多教程没写对。另外两个与"删除"相关的常见疑问：

• /clear 不等于删除：它只是以空上下文重新开始，之前的对话已保存，仍可通过 /resume 找回。
• 想彻底清理：可以调低 cleanupPeriodDays 让旧文本记录自动清理；桌面端还有 desktopSessionCleanupPeriodDays 设置单独控制桌面会话的清理。

实测体验与踩坑记录

我们编辑部在 macOS 终端（zsh）+ Claude Code 桌面版上用这套命令跑了日常选题和代码任务，几个真实感受：

• 跨天开发是 /resume 收益最大的场景。写多篇长文时，我们按选题用 /rename 命名（如 resume-article、seo-audit），第二天 claude -c 直接续上，不用重新交代背景。配合命名，"找会话"基本零成本。
• 长会话恢复后回答质量可能下降。上下文塞得太满，模型容易"走神"。我们的做法是把 /resume 和 /clear 搭配：一个任务一个会话，做完 /clear 开新的，历史会话留着备查。
• 踩坑一：第三方 API 代理用户注意。如果历史记录里含 Anthropic API 不接受的工具数据块，恢复后每一轮都会报 400 错误，官方在 v2.1.246 已修复，遇到的话先升级到最新版（当前为 v2.1.251）。
• 踩坑二：claude -c 恢复到错误的会话。路径里只差下划线、连字符的目录可能互相"串会话"，官方在 v2.1.239 修复了路径字符相似导致的误匹配。如果你的项目目录命名相近，建议显式用 claude --resume <name> 而不是裸 claude -c。
• 踩坑三：/resume 列表里找不到老会话。v2.1.243 之前选择器只列最近 50 条，升级后列表会随滚动加载更多；另外自定义标题曾会在对话超过 64KB 后从 /resume 里消失，v2.1.239 已修复。找不到时先升级版本，再用 Ctrl+A 扩大搜索范围。

总结

/resume 一句话：让每一次和 Claude Code 的对话都不白聊。日常记住三个动作就够了——接着上次干用 claude -c；挑着恢复用 /resume；重要会话随手 /rename。桌面版 8 月补上 /resume 后，终端和桌面可以自由接力，长任务、多任务并行的上下文管理成本低了很多。

如果你想继续深入 Claude Code，推荐阅读站内这几篇：Claude Code 命令清单（中文版）、Claude Code v2.1.241 新功能详解、Claude Code 提示词技巧：CLAUDE.md 怎么写，以及 Claude Code 充值订阅全攻略。更多 AI 工具可以到 AI345 工具导航按需查找。

参考资料：

• Anthropic 官方文档《管理会话》：code.claude.com/docs/zh-CN/sessions
• Claude Code 官方 Changelog（版本修复记录）：github.com/anthropics/claude-code
• AI 产品库：Claude Code /resume 会话恢复命令（2026-08-29 收录）：aiproducthub.cn

作者：AI345 编辑部 ｜ 最后更新于 2026 年 8 月 31 日（新增 v2.1.251 会话恢复更新与 claude attach 用法） ｜ 本文基于 Claude Code v2.1.251 与官方文档实测整理