Windows 上 `hive-mind spawn --claude` 检测不到 claude CLI（PATH 检测失败）

Q: 会遇到什么问题？

Windows 上跑 hive mind spawn claude ，ruflo 说找不到 claude 命令——但你的终端里 claude 明明能跑（或者你刚装过）。这是典型的 跨工具 PATH 检测失败 ：另一个工具的探测逻辑没认到 Windows 的 PATH 语义。 本文路径： 快速修复 （30 秒一段命令）→ 一步步排查 （可跳读）→ 原理与变体 （症状/原因/证据）。赶时间直接跳到「快速修复」。

Q: 为什么会出现这个问题？

先给结论：PATH 检测失败（issue 3071，closed 2026 08 20）——Windows 的 PATH 语义/安装位置与 Unix 差异大，探测器没识别到 claude CLI。 链路：ruflo spawn → 探测 claude 可执行文件 → Windows PATH 查找（ .cmd / .exe shim、npm 全局 bin 目录）→ 未命中 → 报「找不到命令」。断点： 安装位置不在 PATH，或探测逻辑不认 shim 。 实测对照：本环境（WSL Linux）swarm 本地路径正常； Windows PATH 路径未实测 （如实标注）。 推论：跨工具集成故障先做两步手动验证—— claude version 能不能跑（ where claude 在哪），能跑就是探测层问题：把目录加进 PATH 或改用完整路径。

Q: 怎么快速修复？

Windows 排查两步（机制同 Unix）: 1 claude version 验证 CLI 本身可用； 2 where claude 看安装位置是否在 PATH；不在则把该目录加入 PATH（或系统 PATH），重开终端； 仍不识别时：用完整路径调用，并检查 npm 全局 bin 目录是否在 PATH（claude.cmd 类 shim 所在目录）。

Q: 怎么一步步排查？

1. 手动验证 claude CLI — 必做 claude version + where claude ：命令本身可用 = 问题在探测层，不在安装。 2. 把目录补进 PATH — 必做 在系统「环境变量」里把 claude 所在目录（含 claude.cmd shim 的 npm bin 目录）加进 PATH，重开终端再试。 3. 完整路径兜底 — 按场景 探测类工具支持自定义路径时，直接给 claude 的完整可执行路径。 4. 仍失败则跟进 issue — 排查 确认 PATH 正确仍不识别，跟进 ruvnet/ruflo 3071（closed）的处理结论或开新 issue。

Q: 怎么确认修好了？

hive mind spawn claude 不再报「找不到 claude」； 相关子进程正常拉起（日志里能看到 claude 会话）。

Q: 其它环境的表现？

WSL / Linux：swarm 本地路径实测正常（2026 08 30）； Windows：PATH 语义与 shim 识别是高频坑（ 3071）；

快速修复

Windows 排查两步（机制同 Unix）:
1) claude --version        验证 CLI 本身可用；
2) where claude            看安装位置是否在 PATH；不在则把该目录加入 PATH（或系统 PATH），重开终端；
仍不识别时：用完整路径调用，并检查 npm 全局 bin 目录是否在 PATH（claude.cmd 类 shim 所在目录）。

你会遇到什么

Windows 上跑 hive-mind spawn --claude，ruflo 说找不到 claude 命令——但你的终端里 claude 明明能跑（或者你刚装过）。这是典型的跨工具 PATH 检测失败：另一个工具的探测逻辑没认到 Windows 的 PATH 语义。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

先给结论：PATH 检测失败（issue #3071，closed 2026-08-20）——Windows 的 PATH 语义/安装位置与 Unix 差异大，探测器没识别到 claude CLI。

链路：ruflo spawn → 探测 claude 可执行文件 → Windows PATH 查找（.cmd/.exe shim、npm 全局 bin 目录）→ 未命中 → 报「找不到命令」。断点：安装位置不在 PATH，或探测逻辑不认 shim。

实测对照：本环境（WSL Linux）swarm 本地路径正常；Windows PATH 路径未实测（如实标注）。

推论：跨工具集成故障先做两步手动验证——claude --version 能不能跑（where claude 在哪），能跑就是探测层问题：把目录加进 PATH 或改用完整路径。

一步步来

1. 手动验证 claude CLI — 必做

claude --version + where claude：命令本身可用 = 问题在探测层，不在安装。

2. 把目录补进 PATH — 必做

在系统「环境变量」里把 claude 所在目录（含 claude.cmd shim 的 npm bin 目录）加进 PATH，重开终端再试。

3. 完整路径兜底 — 按场景

探测类工具支持自定义路径时，直接给 claude 的完整可执行路径。

4. 仍失败则跟进 issue — 排查

确认 PATH 正确仍不识别，跟进 ruvnet/ruflo #3071（closed）的处理结论或开新 issue。

怎么确认修好了

hive-mind spawn --claude 不再报「找不到 claude」；
相关子进程正常拉起（日志里能看到 claude 会话）。

其它环境的表现

WSL / Linux：swarm 本地路径实测正常（2026-08-30）；
Windows：PATH 语义与 shim 识别是高频坑（#3071）；

症状

Windows 环境执行 spawn --claude 报找不到 claude 命令。

原因

PATH 检测失败（issue #3071，closed 2026-08-20）：Windows PATH 语义/安装位置差异，未识别到 claude CLI。

解法

把 claude 可执行文件所在目录加入 PATH 后用完整路径调用。
确认 claude CLI 已安装（claude --version）。

验证证据

素材：issue #3071（closed，2026-08-20）匿名检索摘要；本环境 WSL Linux，Windows PATH 路径未实测（如实标注）。

适用工具（1）

本问题方案已挂到下列工具的方案页——从工具页也能回到这里，双向可达。

ruflo

来源与证据

收录 2026-09-19验证 ✓ 实测验证适用 1 工具

方案含本地实测或来源可复核的解法；未实测项已在文中如实标注。

← 多智能体编排问题域｜问题货架｜遇到其它问题？去问题空间提交求助卡