Claude Code 多模型协作利器：CCG Workflow v1.7.55 更新指南

Claude Code 编排 Codex + Gemini 三 CLI 协作，固定路由前端→Gemini、后端→Codex，支持多模型并行工作流，一键安装极简配置。

🆕 v1.7.55 更新速览：完美兼容第三方 Gemini API

痛点解决：之前使用第三方 Gemini API（如中转服务）时，常因模型名称不匹配导致报错。v1.7.55 彻底解决了这个问题！

核心更新：

🟢 默认模型升级 ：所有 Gemini 命令默认采用 Google 最新旗舰模型 gemini-3-pro-preview
🟢 自定义模型支持 ：新增 --gemini-model 参数，完美适配各类第三方中转 API（感谢 @xuebkgithub 的 PR #42）
🟢 全面兼容：14 个底层命令模板全部重构更新

适用场景：

官方 API 用户：零配置，开箱即用最新模型。
中转 API 用户：通过参数指定服务商支持的模型名称即可。
极客玩家：想尝鲜其他 Gemini 模型？加个参数轻松切换。

如何更新：

复制代码

npx ccg-workflow@latest
# 选择 "更新工作流" 即可完成升级

💡 核心理念：让专业模型做专业的事

CCG 工作流的本质是**"以 Claude 为大脑，Codex 和 Gemini 为双手"**。它改变了传统单模型硬啃全栈的模式，通过智能路由实现降本增效：

🎨 前端任务 → Gemini：充分发挥其在 UI/CSS/组件生成上的天赋
⚙️ 后端任务 → Codex：利用其在复杂逻辑/算法/底层调试上的优势
🧠 全栈整合 → Claude：专注于架构编排、决策调度与最终代码审计

架构拓扑图

复制代码

┌─────────────────────────────────────────────────────┐
│              Claude Code CLI (主导编排)              │
└──────────────┬──────────────────────────────────────┘
               │
       ┌───────┴───────┐
       ↓               ↓
┌─────────────┐ ┌─────────────┐
│  Codex CLI  │ │ Gemini CLI  │
│  (后端原型)  │ │  (前端原型)  │
└─────────────┘ └─────────────┘
       │               │
       └───────┬───────┘
               ↓
         返回 Patch
    (Claude 审核校验后应用)

✨ 六大核心特性

特性	说明
🌐 Web UI 实时输出	自动唤起浏览器，流式可视化呈现思考过程、命令执行与生成结果
🛤️ 固定智能路由	前端走 Gemini，后端走 Codex，全栈由 Claude 统筹，拒绝模型错配
⚡ 多模型并行	Codex ∥ Gemini 双线并发调用，结果交叉验证，效率翻倍
🔄 6 阶段标准工作流	Prompt增强 → 代码检索 → 并行分析 → 原型生成 → 代码实施 → 质量审计
🎭 12 个专家提示词	基于 ROLE_FILE 零 token 动态注入，无需手动复制粘贴
🛠️ 16 个斜杠命令	覆盖开发流、Git 工具、项目管理，一条命令直达结果

🚀 30 秒极速上手

1. 前置要求

必需：Claude Code CLI、Node.js 18+
可选：Codex CLI、Gemini CLI（ 注：即使不装这两个，工作流依然可用，只是前端/后端任务会自动降级由 Claude 独立完成）

2. 一键安装

复制代码

npx ccg-workflow

按照提示选择 "初始化工作流"，配置 ace-tool MCP（可跳过），等待自动安装 16 个命令后重启终端。

3. 体验第一个命令

在 Claude Code 中输入：

复制代码

/ccg:workflow 实现用户登录功能

此时，系统将自动驱动 6 阶段流水线，你可以在 Web UI 中静静观看三个模型协同工作的全过程。

📚 命令速查手册（16 个）

🌟 日常开发"黄金 6 件套"

记住这 6 个，足以应对 90% 的日常开发场景：

复制代码

/ccg:workflow   # 完整 6 阶段流程，复杂任务首选
/ccg:plan       # 多模型规划（Phase 1-2），只出方案不写码
/ccg:execute    # 多模型执行（Phase 3-5），按计划开干
/ccg:feat       # 敏捷功能开发，规划→实施一条龙
/ccg:frontend   # 纯前端任务，调用 Gemini 快速出活
/ccg:backend    # 纯后端任务，调用 Codex 深度剖析

📂 完整命令矩阵

开发工作流（12 个）

命令	用途	调度模式
`/ccg:workflow`	完整 6 阶段工作流	Codex ∥ Gemini
`/ccg:plan`	多模型规划（P1-P2）	Codex ∥ Gemini
`/ccg:execute`	多模型执行（P3-P5）	Codex ∥ Gemini + Claude
`/ccg:feat`	智能功能开发	规划 → 实施
`/ccg:frontend`	前端专项	Gemini
`/ccg:backend`	后端专项	Codex
`/ccg:analyze`	纯技术分析	Codex ∥ Gemini
`/ccg:debug`	问题诊断 + 修复	Codex ∥ Gemini
`/ccg:optimize`	性能瓶颈优化	Codex ∥ Gemini
`/ccg:test`	测试用例生成	智能路由
`/ccg:review`	代码审查（默认审查 git diff）	Codex ∥ Gemini
`/ccg:enhance`	Prompt 增强	ace-tool MCP

Git 工具（3 个） ：/ccg:commit (智能提交) · /ccg:rollback (交互式回滚) · /ccg:clean-branches (清理分支) · /ccg:worktree (Worktree管理)

项目管理（1 个） ：/ccg:init (初始化项目 CLAUDE.md)

⚙️ 进阶配置与优化

🔧 ace-tool MCP 配置（可选）

用于增强代码检索和 Prompt 能力。支持两种接入方式：

官方服务 ：前往 augmentcode.com 注册获取 Token
中转服务 ： linux.do 社区提供免费中转，无需注册

(若跳过配置，/ccg:workflow 的前两个阶段会自动跳过，不影响其他命令使用)

🧠 推荐全局提示词（可选增强）

为了进一步提升 Claude 对 ace-tool MCP 和多 CLI 的调度能力，可在 ~/.claude/CLAUDE.md 中追加专属全局提示词。 (注：CCG 工作流内部已封装完整提示词，此项为锦上添花的可选增强)

❓ 常见问题排雷指南

Q1：提示 codeagent-wrapper: command not found？ PATH 环境变量未生效。

Mac/Linux ：执行 source ~/.zshrc 或重启终端。
Windows：重启 PowerShell 窗口。

Q2：如何卸载或更新？

复制代码

# 更新（通用）
npx ccg-workflow@latest -> 选择 "更新工作流"

# 卸载
npx ccg-workflow -> 选择 "卸载工作流"
# 若曾使用 npm 全局安装，需额外执行：npm uninstall -g ccg-workflow

Q3：Claude Code 执行任务时提示超时？ 修改 ~/.claude/settings.json，拉高超时阈值：

复制代码

{
  "env": {
    "CODEX_TIMEOUT": "7200",
    "BASH_DEFAULT_TIMEOUT_MS": "600000",
    "BASH_MAX_TIMEOUT_MS": "3600000"
  }
}

Q4：Codex 任务卡住，获取不到生成结果？ 原因：这是 Codex CLI v0.80.0 在 --json 模式下的已知 Bug，进程输出完毕后不会自动退出。对策：设置环境变量，让 wrapper 在检测到输出后 1 秒强制终止进程。

复制代码

# Mac/Linux (加入 ~/.zshrc 或 ~/.bashrc)
export CODEAGENT_POST_MESSAGE_DELAY=1

# Windows PowerShell (执行以下命令写入用户环境变量)
[Environment]::SetEnvironmentVariable("CODEAGENT_POST_MESSAGE_DELAY", "1", "User")

(或者在上述提到的 ~/.claude/settings.json 的 env 字段中添加该变量亦可)

本文由mdnice多平台发布