它到底是什么

claude rm <id> 把一个 background session（后台会话）从列表中移除。官方 CLI reference 对它的定义是："Remove a background session from the list"。

它属于管理后台会话的一组 CLI 子命令，这一组命令都用同一个短 ID:

后台会话通常由 claude --bg "<prompt>"（或 --background）启动。该 flag 会立即返回，并打印 session ID 和管理命令。

关键点：rm 只移除列表项，不删除对话 transcript。 transcript 仍保留在本机，可以通过 claude --resume 找回。

用法 / 语法

claude rm <id>
claude rm <id> --discard-unpushed <commit>@<worktree-id>
claude rm <id> --force-remove-worktree <worktree-id>

官方示例：

claude rm 7c5dcf5d

<id> 是会话的短 ID，即 ~/.claude/jobs/ 下的目录名。attach、logs、stop、rm 使用同一种 ID。

这两个 flag 的值不需要手写。官方文档说明，当二次 claude rm 能解决拒绝时，拒绝信息会打印出需要传入的确切 flag 和值，照抄即可。

与会话内同名命令的差异

官方文档没有收录会话内的 /rm 命令。要在交互界面里删除会话，用 agent view（claude agents）里的 Ctrl+X。两条路径对 worktree 的处理不同：

运行约束 / 限制

以下均来自官方 agent view 文档中"What deleting a session removes"一节。

常见坑

1. rm 不会删除 transcript。 文档明确写道：transcript 保留在本机，仍可通过 claude --resume 访问。如果目的是清理磁盘上的对话数据，claude rm 达不到。会话文档指出，transcript 按保留期清理规则过期，要更早删除某个项目的 transcript 和相关状态，可以用 claude project purge。
2. claude rm 被拒绝时，重试不是"再执行一遍就行"。 被拒绝后，要按拒绝信息里打印的 flag 和值传参。文档说明 Claude Code 只会丢弃拒绝信息里展示过的内容。如果 worktree 在此期间新增了 commit，会再次保留并显示更新后的状态。
3. --force-remove-worktree 只在满足条件时才会被提示。 官方文档说，Claude Code 只有在能确认该目录是仓库 .claude/worktrees/ 下的 linked worktree、tracked 文件无未提交改动、没有嵌套仓库、也没有其他会话记录引用它时，才提供这个选项。
4. agent view 里的删除比 claude rm 更激进。 前者会连未提交的改动一起移除 worktree，所以官方建议先提交想保留的内容。
5. claude rm 不是对话内删除。 它管理的是后台会话列表。claude --resume 会话选择器里，后台会话以 bg 标记显示。

来源

• CLI reference - Claude Code Docs（docs.claude.com/en/docs/claude-code/cli-reference 会 301 重定向到此）
• Agent view - Claude Code Docs
• Manage sessions - Claude Code Docs