它到底是什么

claude stop <id> 用来停止一个后台会话（background session），也可以写成 claude kill <id>。它属于管理后台会话的 CLI 子命令组，同组的还有 claude agents、claude attach、claude logs、claude respawn、claude rm。这些后台会话由 claude --bg 启动，也可以在 agent view 里派发。

官方文档没有为 claude stop 本身标注最低版本要求。

用法 / 语法

claude stop <id>
claude kill <id>      # 别名,等价

claude stop 7c5dcf5d

<id> 是后台会话的短 ID，来源有两个：

• 用 claude --bg 启动会话时会打印出来。
• claude agents --json 输出里后台会话的 id 字段。

每个会话的 ID 就是它在 ~/.claude/jobs/ 下的目录名。

官方文档中 claude stop 只列出了 <id> 这一个参数，没有其他 flag。

同组命令对照：

停止后会发生什么

Shell 集成 / 自动化

先用 claude agents --json 查询状态，再对筛选出的会话执行 stop。官方文档建议脚本读取会话状态时用 claude agents --json，不要直接解析 ~/.claude/jobs/<id>/state.json。

state 的取值有 working、blocked、done、failed、stopped。id 只出现在后台会话上。

下面这个例子由文档中的字段组合而成，文档本身没有给出这段脚本：

# 停止当前所有仍在工作的后台会话
claude agents --json \
  | jq -r '.[] | select(.kind == "background" and .state == "working") | .id' \
  | xargs -n1 claude stop

只处理某个目录下启动的会话，可以给 claude agents 加 --cwd <path>。文档没有说明 claude stop 能否一次接收多个 ID，所以例子用 xargs -n1 逐个调用。

与相关命令的差异

• stop 与 background 的区别：←、/background、/bg 用于把当前会话转入后台（detach），官方文档写明 detaching 不会停止后台会话；stop 才是停止会话。在会话内部结束会话要用 /stop。
• stop 与 rm 的区别：stop 只停止会话。claude rm <id> 是把会话从列表移除，同时在安全时删除 Claude 为它创建的 worktree。rm 之后 transcript 保留在本机，可用 claude --resume 恢复。
• stop 与 daemon stop 的区别：claude daemon stop --any 会停止 supervisor 和它托管的全部后台会话。加 --keep-workers 可以让后台会话继续运行，下一个 supervisor 会重新连接。
• stop 之后的重启：claude respawn <id> 可以重启会话，并恢复其已保存的对话。

常见坑

• 后台任务默认会延续到下一个进程：官方文档写的是会话进程停止或重启时，Claude 启动的后台 shell 命令、dynamic workflow、后台 subagent 会延续到下一个进程，没有单独说明 claude stop 之后是否延续；设置 CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1 则让它们随进程一起停止。
• claude stop 用的是短 ID，不是完整 UUID:claude agents --json 的 id 是短 ID,sessionId 是完整 UUID，后者用于 claude --resume。
• rm 之后 transcript 仍在：claude rm 不会删除 transcript，想清理数据要另用 claude project purge。

来源

• CLI reference - Claude Code Docs
• Agent view - Claude Code Docs
• Manage sessions - Claude Code Docs