它到底是什么

claude daemon stop 是 claude daemon 子命令组的一员，用来停止后台会话 supervisor（监管进程），以及它托管的后台会话。官方 CLI reference 对它的描述是：

停止 background-session supervisor 和它托管的会话。传 --keep-workers 可让后台会话继续运行，下一个 supervisor 会重新连接到它们。

supervisor 是一个后台服务。你第一次把会话转入后台（claude --bg），或第一次打开 agent view（claude agents）时，Claude Code 会自动启动它。它让后台会话在你关闭 agent view 或终端后继续工作，每个会话是它下面的一个独立 Claude Code 进程。

同组的其他子命令：

版本要求：本次访问的官方页面没有给出 daemon stop 的最低版本号，所以这里不写。

用法 / 语法

claude daemon stop --any
claude daemon stop --any --keep-workers

停止后，下一次 claude agents 或 claude --bg 会启动一个新的 supervisor。

退出码 / 输出格式

官方文档没有给出 daemon stop 成功时的退出码，也没有给出结构化输出格式，所以这里不列表。文档只说明了两种异常输出：

• 命令报告"无法确认记录的进程就是 supervisor"时，先检查它给出的进程 ID。如果那确实是你自己的 supervisor，就手动停止它，再删除 ~/.claude/daemon.lock，让下次 claude agents 重新启动。
• 在 Windows 上，如果 supervisor 没有响应停止请求，命令会打印它的进程 ID。用 taskkill /PID <pid> 结束该进程即可完成恢复。传了 --keep-workers 时，后台会话仍会保留。

与会话内同名命令的差异

官方文档把 claude daemon stop 列在 CLI 子命令表里。本次访问的页面没有出现会话内同名的 slash 命令，所以这里不做对比。

运行约束 / 限制

经典使用场景

以下均直接来自官方文档：

• supervisor 无响应：attach、peek 或 claude logs 报告 "the background service did not respond" 时，执行 claude daemon stop --any --keep-workers。下一次 claude agents 会启动新的 supervisor，并重连正在运行的会话。
• 更新后让 supervisor 切到新版本：claude daemon status 发现运行中的 supervisor 与当前 claude 版本不一致时，会提示执行 claude daemon stop --any。
• 认证方式解析失败：派发会话时出现 Could not resolve authentication method，文档建议同样执行 claude daemon stop --any --keep-workers，然后再运行 claude agents 或 claude --bg。

常见坑

• 忘记 --keep-workers：正在跑的后台会话会被一并结束。只想重启 supervisor 时务必加上。
• supervisor 启动了但无法接受连接：官方说它会自行退出并释放锁，下次 claude agents 会重新启动，这种情况不需要手动 stop。手动 stop 针对的是"正在运行的 supervisor 卡住"。

来源

• CLI reference - Claude Code Docs
• Agent view - Claude Code Docs（只读取了前 100000 个字符，后面约 34000 个字符未读）