【开源】CCG v1.7.55 : Claude Code 编排三 CLI 协作 | Codex + Gemini + Claude

问题描述：

GitHub: GitHub - fengshao1227/ccg-workflow: 多模型协作开发工具集 - 基于 Claude Code CLI，整合 Codex/Gemini 后端能力，提供智能路由、代码审查、Git 工具等 17+ 个命令
觉得好用请留下你的 Star

OpenSpec 规范驱动已发布

新增 5 个 /ccg:spec-* 命令，把需求变成约束，让 AI 没法自由发挥。适合复杂功能开发。
查看新帖：CCG + OpenSpec：让 AI 不再自由发挥

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

---

v1.7.55：修复第三方 Gemini API 无法使用的问题

问题背景：
之前用第三方 Gemini API（比如中转 API）时，因为模型名称不匹配会报错。现在可以自己指定模型了！

更新内容：

• 所有 Gemini 命令默认使用 gemini-3-pro-preview 模型（Google 官方最新模型）
• 支持 --gemini-model 参数，可以自定义模型名称（感谢 @xuebkgithub 的 PR #42）
• 14 个命令模板全部更新，兼容第三方 API

使用场景：

• 用 Google 官方 API？默认就行，自动用最新模型
• 用第三方中转 API？可以指定他们支持的模型名称
• 想用其他 Gemini 模型？加个参数就行

如何更新：

npx ccg-workflow@latest # 选择 "更新工作流"

影响的命令：

• 核心工作流：/ccg:frontend, /ccg:workflow, /ccg:plan, /ccg:execute
• 开发工具：/ccg:analyze, /ccg:debug, /ccg:optimize, /ccg:review, /ccg:test, /ccg:feat

---

推荐全局提示词配置

如果你想更好地使用 ace-tool MCP 和 Codex/Gemini CLI，可以在 ~/.claude/CLAUDE.md 中添加以下全局提示词（CCG 工作流本身已封装完整提示词，此配置为可选增强）：

点击展开查看完整配置

直接复制以下内容到 ~/.claude/CLAUDE.md：

# CCG 工作流增强配置 ## 1. Prompt 增强 (每次对话自动触发) **执行时机**：用户发送消息时 **工具调用**：调用 mcp__ace-tool__enhance_prompt **作用**：将模糊需求转化为结构化、可执行的任务描述 ## 2. 上下文全量检索 (生成代码前必须执行) **执行时机**：在生成任何建议或代码之前 **工具调用**：调用 mcp__ace-tool__search_context **检索策略**： - 禁止基于假设 (Assumption) 回答 - 使用自然语言构建语义查询 (Where/What/How) - 完整性检查：必须获取相关类、函数、变量的完整定义与签名 - 若上下文不足，触发递归检索直至信息完整 **需求对齐**：若检索后需求仍有模糊空间，必须向用户输出引导性问题列表，直至需求边界清晰（无遗漏、无冗余）。 ## 3. 工作流执行原则 1. 先检索，后生成：永远不要在没有调用 search_context 的情况下编写代码 2. 增强需求：对于复杂任务，先调用 enhance_prompt 明确需求边界 3. 智能路由：根据任务类型自动选择 Codex/Gemini/Claude 4. 交叉验证：关键决策使用双模型并行分析 5. 代码主权：Codex/Gemini 仅负责分析、规划、审查，禁止直接修改文件；所有代码实现由 Claude 完成

（可选）多模型协作调用规范：如果你安装了 Codex/Gemini CLI，可以追加以下内容：

## 多模型协作调用规范 ### Codex CLI 调用 (后端任务) 调用方式：codeagent-wrapper --backend codex - [工作目录] <<'EOF' ... EOF 适用场景：后端逻辑、算法实现、数据库操作、API 开发、性能优化、调试分析 ### Gemini CLI 调用 (前端任务) 调用方式：codeagent-wrapper --backend gemini - [工作目录] <<'EOF' ... EOF 适用场景：UI/UX 组件开发、CSS 样式、响应式布局、前端交互逻辑 ### 会话复用 每次调用返回 SESSION_ID: xxx，后续阶段用 resume xxx 复用上下文，保持对话连贯性。 新会话调用：codeagent-wrapper --backend <codex|gemini> - [工作目录] <<'EOF' ... EOF 复用会话调用：codeagent-wrapper --backend <codex|gemini> resume <SESSION_ID> - [工作目录] <<'EOF' ... EOF ### 并行调用 使用 run_in_background: true 启动后台任务，用 TaskOutput 等待结果。必须等所有模型返回后才能进入下一阶段。 并行启动示例： Bash({ command: "codeagent-wrapper --backend codex ...", run_in_background: true, timeout: 3600000 }) Bash({ command: "codeagent-wrapper --backend gemini ...", run_in_background: true, timeout: 3600000 }) 等待后台任务：TaskOutput({ task_id: <TASK_ID>, block: true, timeout: 600000 })

配置后效果：

• 每次对话自动增强 Prompt，减少需求模糊
• 代码生成前强制检索上下文，避免幻觉
• 多模型协作规范化，提升代码质量

---

快速开始

30 秒了解

CCG = Claude Code (主导编排) + Codex CLI (后端原型) + Gemini CLI (前端原型)

核心理念：让 Claude 专注于编排决策，把具体代码生成交给专业模型

• 前端任务 → Gemini（擅长 UI/CSS/组件）
• 后端任务 → Codex（擅长逻辑/算法/调试）
• 全栈整合 → Claude（编排决策、质量把控）

一键安装

npx ccg-workflow

安装流程：

1. 选择 “初始化工作流”
2. 配置 ace-tool MCP（可选，可跳过）
3. 自动安装 16 个命令
4. 重启终端生效

第一个命令

# 在 Claude Code 中执行 /ccg:workflow 实现用户登录功能

自动执行 6 阶段工作流：Prompt增强 → 代码检索 → 并行分析 → 原型生成 → 实施 → 审计

---

核心特性

特性	说明
Web UI 实时输出	自动打开浏览器，流式显示思考过程、命令执行、生成结果
固定路由	前端→Gemini，后端→Codex，全栈→Claude
多模型并行	Codex ∥ Gemini 同时调用，交叉验证
6阶段工作流	Prompt增强 → 检索 → 分析 → 原型 → 实施 → 审计
12个专家提示词	ROLE_FILE 零 token 动态注入
16个斜杠命令	开发工作流 + Git 工具 + 项目管理
跨平台支持	macOS / Linux / Windows × Intel / ARM

架构图

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

---

命令参考（16 个）

日常开发只需记住这几个

/ccg:workflow # 完整流程，复杂任务用这个 /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	多模型规划（Phase 1-2）	Codex ∥ Gemini
/ccg:execute	多模型执行（Phase 3-5）	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 工具（4 个）

命令	用途
/ccg:commit	智能提交，自动生成 conventional commit
/ccg:rollback	交互式回滚
/ccg:clean-branches	清理已合并分支
/ccg:worktree	Worktree 管理

项目管理（1 个）

命令	用途
/ccg:init	初始化项目 CLAUDE.md

---

前置要求

必需：

• Claude Code CLI
• Node.js 18+

可选（按需安装）：

• Codex CLI - 不装的话后端任务降级成 Claude
• Gemini CLI - 不装的话前端任务也降级

只有 Claude Code 也能用，就是没有多模型协作了

---

ace-tool MCP 配置

安装时可选配置，用于代码检索和 Prompt 增强。

两种方式：

1. 官方服务 - https://augmentcode.com/ 注册获取 Token
2. 中转服务 - linux.do 社区提供，无需注册：https://linux.do/t/topic/1291730

跳过也行，/ccg:workflow 的 Phase 0 和 Phase 1 会跳过，其他命令正常工作。

---

常见问题

Q: codeagent-wrapper: command not found？

PATH 未生效，重启终端或执行：

# Mac/Linux source ~/.zshrc # Windows # 重新打开 PowerShell

Q: 如何更新？

# npx 安装用户（所有平台通用，包括 Windows） npx ccg-workflow@latest # 选择 "更新工作流" # npm 全局安装用户 npm install -g ccg-workflow@latest

Q: 如何卸载？

npx ccg-workflow # 选择 "卸载工作流" # 如果之前用 npm install -g 安装过，还需执行： npm uninstall -g ccg-workflow

Q: Claude Code 任务超时？

修改 ~/.claude/settings.json：

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

变量	说明
CODEX_TIMEOUT	codeagent-wrapper 执行超时（秒），默认 7200
BASH_DEFAULT_TIMEOUT_MS	Bash 命令默认超时（毫秒）
BASH_MAX_TIMEOUT_MS	Bash 命令最大超时（毫秒）

Q: Codex 任务卡住，获取不到结果？

这是 Codex CLI 0.80.0 的已知 bug，--json 模式下进程完成输出后不会自动退出。

解决方案：设置环境变量让 codeagent-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": { "CODEAGENT_POST_MESSAGE_DELAY": "1" } }

设置后重启终端生效。

---

鸣谢

• cexll/myclaude - codeagent-wrapper 多后端调用工具
• UfoMiao/zcf - Git 工具 + MCP 配置逻辑
• GudaStudio/skills - 智能路由设计理念
• ace-tool MCP - 代码检索和 Prompt 增强
• linux.do 社区 - Vibe Coding 技术交流社区

---

反馈

• GitHub Issues: GitHub · Where software is built
• 或者直接在下面回复

---

版本: v1.7.55 | 最后更新: 2026-02-01

网友解答：

---

--【壹】--：

牛逼支持明天试试

---

--【贰】--：

看到标题没绷住

---

--【叁】--：

好的，谢谢大佬

---

--【肆】--：

memorys里面的claude.md，在这里改就行啦，
在### Phase 3: 原型获取这个阶段，可以改一下，前端

Route A: 前端/UI/样式 → Gemini+codex

然后给他调用工具的命令

---

--【伍】--：

佬太强了 造福佬友

---

--【陆】--：

大自然的缝合怪，用了社区好多佬的工作流项目，各有千秋，

---

--【柒】--： 生活磨平棱角的风:

Skills 仓库

这必须得强烈推荐啊…一直认为多模型混合才是王道.

---

--【捌】--： 生活磨平棱角的风:

但我在 macOS 上用的时候发现个问题：脚本用的是 python 命令，macOS 默认是 python3，需要手动改才能跑。

这个 alias 不就好了嘛

---

--【玖】--：

大佬们都是夜猫子嘛

---

--【拾】--：

大佬，这样直接分前后端如果我希望前端或者后端也要多模型协作呢？我说的是三模型都要协作

---

--【拾壹】--：

简单直接hh，CCG

---

--【拾贰】--：

小白问一下用大佬这个需要吧原来安装的孙佬那个卸载么 还是直接安装就行

---

--【拾叁】--：

可以改提示词，用的codeagent-wrapper，支持调用cc+codex+gemini，你改一下提示词就可以前端同时调用codex和gemini了，甚至可以在cc里面调用cc

---

--【拾肆】--：

非常有意思。支持了！

---

--【拾伍】--：

帮你@一下作者

feng_li:

@cexllcexll

@benchen

feng_li:

@UfoMiao

@MiaoDa

---

--【拾陆】--：

直接安装即可，然后想用的时候输入指令/ccg:
即可，不打指令的情况下默认不使用
我用孙佬的，有时候就像正常使用cc就得切换提示词，这样的方式我感觉方便点

---

--【拾柒】--：

太厉害了

---

--【拾捌】--：

## v2.0 更新

重构了提示词系统，从手动设置改为动态角色注入：

• 新增 12 个专业角色文件（Codex 6个 + Gemini 6个）
• 每个命令自动注入对应角色（architect/debugger/tester/reviewer/optimizer/analyzer）
• 不再需要手动配置全局提示词

已更新主楼内容，旧版提示词部分已标记删除线。

---

觉得有用的话，欢迎 GitHub ~

---

---

--【拾玖】--：

思路来了挡不住，上头了就一直在写了