npx ccg-workflow 装的是挂在 Claude Code 上的多模型工作流，不是又一个独立聊天窗口。公开定位（GitHub / npm / 文档站）：Claude 当编排，Codex 偏后端分析，Gemini 偏前端；外部模型经 Go 写的 codeagent-wrapper 桥接，只回 Patch，由 Claude 审核再落盘。OpenClaw Gateway 定时任务、Codex/Gemini 登录问题另开帖说，这篇只说把三个 CLI 串进 CCG 时一般卡在哪。
可核验入口：仓库 fengshao1227/ccg-workflow、包 ccg-workflow（撰写时文档标到 v3.7.x）、安装说明 ccg.fengshao1227.com/installation。
装上了不代表三个模型都在跑
文档里写了：
- 必需：Node.js 20+、Claude Code CLI。Node 18 会因
ora@9直接SyntaxError。 - 可选：Codex CLI、Gemini CLI（安装页仍这么写；较新 README 还列了 Grok / Kimi Code / Antigravity 等可选后端）。没装外部 CLI 时，CCG 仍能装、能跑，但依赖外部模型的策略会自动降级，安装页的例子是：
full-collaborate退成guided-develop。 - 安装页还把 jq 列为必需（Hook 里解析 JSON）。缺 jq 时 Hook / 自动授权容易出问题。
所以 npx 跑完了却感觉没有双模型，多半是路由里没启用外部模型，或者外部模型的 CLI 不在 PATH 里，不一定是安装失败。
完整编排走方式 A（npx ccg-workflow / init，带 commands、hooks、binary）。方式 B 是 Claude 原生 plugin，只要 skills、不要多模型编排；多模型命令带安装期占位符，不随 plugin 发。装错了的表现是：有 /ccg-… 技能名，却没有完整 /ccg:go 编排能力。
向导的几步分别容易卡在哪
npx ccg-workflow 起交互菜单；init 是安装向导。文档站列了大致步骤（新用户可能只看到选语言 + 一键默认的简化流程，高级选项之后在菜单里改）：
- 语言 — 中/英，记住即可。
- 外部模型鉴权 — Official login（用 Codex/Gemini 自带登录）、API Key、或 Skip。Skip 就是稍后再配，这时候跑双模型策略，看起来就像只有 Claude 在干活。本文不展开各厂登录细节。
- 模型路由 — 勾 Codex / Gemini / Both。只勾一个的话，另一侧的前端/后端路由就用不上。
- MCP（可选） — fast-context、ace-tool、context7 等；配不上一般只是少了检索能力，三个 CLI 的主流程不受影响，可以用
diagnose-mcp单独查。 - 性能模式 — High-performance 要开 Agent Teams，文档要求环境变量
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1。没开却选了高并发路径，并行 Builder 会出问题。
装完写到 ~/.claude/：commands/ccg/、hooks/ccg/、.ccg/config.toml、bin/codeagent-wrapper，并改 settings.json 注册 Hook。缺 wrapper 二进制，外部模型就接不上。
非交互：npx ccg-workflow init --skip-prompt（全用默认项，不用回答问题，不过也就没机会检查路由勾得对不对）。
跑起来以后看着像卡住的情况
验证命令（安装页）：Claude Code 会话里 /ccg:go hello，引擎开始分析意图就算主链路通了。v3 默认智能入口是 /ccg:go；/ccg:workflow、/ccg:plan、/ccg:execute 等在文档里归到 Legacy 额外命令，升级后还用旧命令的，会以为命令没了。
工作流示例里，双模分析出计划后有一次 HARD STOP 等人审批。停在那里是在等你确认，不是卡死了。任务落在项目下 .ccg/tasks/<name>/（task.json、plan.md 等）。
超时相关 env（写在 ~/.claude/settings.json 的 env）：CODEX_TIMEOUT 默认 7200 秒，CODEAGENT_POST_MESSAGE_DELAY 默认 5。外部模型慢的话先看是不是超时/延迟设置的问题，别急着卸了重装。
用自带命令检查
node -v # 要 >= 20
which claude codex gemini jq
npx ccg-workflow doctor
npx ccg-workflow doctor --json
npx ccg-workflow status
README 写明：doctor 查安装形态、所选后端、Hook 注册、技能等，不调用厂商模型，也不等于 API 可用性探测。缺外部模型的委派工具时给警告和安装指引。更新用 npx ccg-workflow@latest，再 doctor；卸载 npx ccg-workflow uninstall（不动 Claude Code 本身）。
公开资料能查到的和查不到的
能查到的：包名与仓库、Node/Claude 硬依赖、Codex/Gemini 可选与降级、向导步骤、/ccg:go 验证、doctor 边界、wrapper 路径、Agent Teams 开关。较新的 README 已经不止三个 CLI，还加了更多可选后端，你装的是哪个版本就看哪个版本的 README / 文档站。
查不到的：某个版本向导文案的具体差异、各家账号风控的细节。README 里有赞助商的中转服务，用不用自己判断，本文不推荐。
串不起来的话先查这几处：Node 和 Claude 是否满足要求；Codex/Gemini 是否真的在 PATH 里，向导里有没有启用；现在卡的是鉴权、降级策略，还是计划审批的暂停。大部分情况都出在这几处。
参考：