它到底是什么

/resume 是一条会话内 slash 命令，用于在不退出当前终端的情况下切换到另一个历史会话。它会打开交互式会话选择器（session picker），或者直接按名称/ID 恢复指定会话。

与之对应的是 CLI 启动标志 --resume（和 --continue），两者作用于会话外（即启动 claude 时）。官方文档未将 /continue 列为 /resume 的会话内别名；--continue 仅作为 CLI 启动标志存在。

怎么触发 / 怎么使用

1. 会话内 slash 命令（本文主角）

/resume
/resume <session-name>
/resume <session-id>

2. CLI 启动标志（会话外）

claude --continue                  # 恢复当前目录最近一次会话
claude --resume                    # 打开会话选择器
claude --resume auth-refactor      # 按名称恢复（精确匹配直接恢复；模糊匹配打开选择器并预填搜索词）
claude --resume <session-id>       # 按 ID 恢复
claude --from-pr <number>          # 恢复与某个 Pull Request 关联的会话

注意：/resume 与 claude --resume 在模糊名称处理上行为不同。/resume <name> 模糊时直接报错；claude --resume <name> 模糊时打开选择器并预填搜索词。

监控 / 控制 / 键位

打开会话选择器后，可用以下快捷键操作：

每行显示：会话名称（若已命名；否则显示对话摘要或首条 prompt）、最后活跃时间、消息数、git 分支。用 Ctrl+A 扩展到全项目后额外显示项目路径。

保存 / 配置 / 集成

会话存储路径

~/.claude/projects/<project>/<session-id>.jsonl

每行是一个 JSON 对象（消息、tool use 或 metadata）。<project> 由工作目录路径派生。

相关配置

命名会话（方便日后 /resume <name> 恢复）

claude -n auth-refactor            # 启动时命名
# 会话中：
/rename auth-refactor              # 动态重命名

也可在会话选择器中高亮会话后按 Ctrl+R 重命名。

进阶：用 grep 捞回崩溃的 headless 会话

claude -p（headless / Agent SDK）产生的会话不进选择器，崩溃后只能凭 session ID 用 claude --resume <id> 找回。但如果当时没记下 ID，可以直接在磁盘上的 transcript 里 grep——每个会话就是 ~/.claude/projects/<project>/<session-id>.jsonl 一个文件，文件名即 session ID：

# 列出当前项目最近修改的会话文件（文件名去掉 .jsonl 即 session-id）
ls -t ~/.claude/projects/*/*.jsonl | head

# 按内容定位：找出提到某关键字（如某次崩溃任务的特征字符串）的会话
grep -l "refactor the auth middleware" ~/.claude/projects/*/*.jsonl

# 从命中的文件路径取出 session-id 再恢复
sid=$(basename "$(grep -l 'auth middleware' ~/.claude/projects/*/*.jsonl | head -1)" .jsonl)
claude --resume "$sid"

注意：ID 恢复按目录隔离——--resume <id> 要在该会话所属项目目录下执行（即 ~/.claude/projects/<这个 project> 对应的工作目录），否则报 No conversation found with session ID。<project> 段是工作目录路径派生而来，可据此反推该去哪个目录 cd。

/resume × /rewind 组合恢复流

两者解决的是不同维度的"回到过去"，常配合使用：

• /resume：换哪一个会话（在多条历史会话之间切换 / 找回）。
• /rewind：在当前这条会话内把时间线回滚到更早的检查点（撤销最近若干轮的代码改动 + 对话状态）。

典型组合流：先 /resume（或 claude --resume <name>）把昨天那条跑偏的会话切回来，进去后发现最后几轮改崩了，再 Esc Esc（输入框为空时）或运行 /rewind 打开检查点菜单，回滚到改崩之前的那个检查点继续。即"先选对会话，再在会话内退到对的时间点"。注意 /rewind 只回滚被追踪的 Edit/Write 类改动，详见 /rewind 指南。

运行约束 / 限制

跟同类原语对比

经典使用场景

• 多任务切换：同时进行多个功能开发（如 auth-refactor、fix-bug-123），用 /resume 在不同会话间来回切换，保留各自上下文。
• 跨终端继续工作：关闭终端后重新打开，用 claude --resume 选择器找回昨天的会话，接着未完成的任务。
• PR 关联恢复：用 claude --from-pr <number> 恢复与某个 Pull Request 绑定的会话，继续相关的讨论和代码生成历史。
• 搜索定位旧会话：在选择器中粘贴 GitHub PR URL，直接跳转到创建该 PR 的会话。

常见坑

1. 跨目录 ID 恢复失败：claude --resume <session-id> 必须在会话创建时所在的目录执行，否则报 No conversation found with session ID: <session-id>。解决：cd 到对应项目目录后再执行。
2. headless 会话无法在选择器里找到：claude -p 产生的会话不进选择器列表，只能凭 session ID 用 --resume 恢复。
3. /resume <name> 不做模糊补全：会话名称有歧义时，/resume name 直接报错，需不带参数运行 /resume 打开选择器手动选择。
4. transcript 30 天自动清理：默认保留 30 天，过期会话无法恢复。可在 settings 中调整 cleanupPeriodDays。

来源

• Manage sessions — Claude Code Docs
• Commands — Claude Code Docs
• Claude Code --continue and --resume: Never Lose Your Context Again