# 装完 npx ccg-workflow，三个 CLI 还是串不起来 **URL:** \ **Category:** 人工智能\ **Tags:** Claude, AICoding, Codex, Gemini\ **Created:** [2026 年10 月 26 日 02:15 UTC](https://www.shiqidu.com/t/topic/1787 "2026-10-26T02:15:56Z")\ **Posts on this page:** 1\ **Page:** 1
作者： ![shiqidu\_editor](https://www.shiqidu.com/user_avatar/www.shiqidu.com/shiqidu_editor/32/528_2.png) [@shiqidu\_editor](https://www.shiqidu.com/u/shiqidu_editor)\ 发布日期： [2026 年10 月 26 日 02:15 UTC](https://www.shiqidu.com/t/topic/1787/1 "2026-10-26T02:15:57Z")
`npx ccg-workflow` 装的是挂在 Claude Code 上的多模型工作流，不是又一个独立聊天窗口。公开定位（GitHub / npm / 文档站）：Claude 当编排，Codex 偏后端分析，Gemini 偏前端；外部模型经 Go 写的 `codeagent-wrapper` 桥接，只回 Patch，由 Claude 审核再落盘。OpenClaw Gateway 定时任务、Codex/Gemini 登录问题另开帖说，这篇只说把三个 CLI 串进 CCG 时一般卡在哪。 可核验入口：仓库 [fengshao1227/ccg-workflow](https://github.com/fengshao1227/ccg-workflow)、包 [ccg-workflow](https://www.npmjs.com/package/ccg-workflow)（撰写时文档标到 v3.7.x）、安装说明 [ccg.fengshao1227.com/installation](https://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` 是安装向导。文档站列了大致步骤（新用户可能只看到选语言 + 一键默认的简化流程，高级选项之后在菜单里改）： 1. 语言 — 中/英，记住即可。 2. 外部模型鉴权 — Official login（用 Codex/Gemini 自带登录）、API Key、或 Skip。Skip 就是稍后再配，这时候跑双模型策略，看起来就像只有 Claude 在干活。本文不展开各厂登录细节。 3. 模型路由 — 勾 Codex / Gemini / Both。只勾一个的话，另一侧的前端/后端路由就用不上。 4. MCP（可选） — fast-context、ace-tool、context7 等；配不上一般只是少了检索能力，三个 CLI 的主流程不受影响，可以用 `diagnose-mcp` 单独查。 5. 性能模式 — 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//`（task.json、plan.md 等）。 超时相关 env（写在 `~/.claude/settings.json` 的 `env`）：`CODEX_TIMEOUT` 默认 7200 秒，`CODEAGENT_POST_MESSAGE_DELAY` 默认 5。外部模型慢的话先看是不是超时/延迟设置的问题，别急着卸了重装。 ## 用自带命令检查 ```bash 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 里，向导里有没有启用；现在卡的是鉴权、降级策略，还是计划审批的暂停。大部分情况都出在这几处。 参考： - [GitHub - fengshao1227/ccg-workflow: 多模型协作工作流引擎 — /ccg:go 一个命令，AI 自动分析意图、选择策略、编排 Codex + Gemini + Claude 协作执行 · GitHub](https://github.com/fengshao1227/ccg-workflow) - [https://www.npmjs.com/package/ccg-workflow](https://www.npmjs.com/package/ccg-workflow) - [Install CCG Workflow - Multi-Model AI Coding Setup Guide | CCG Workflow](https://ccg.fengshao1227.com/installation/)