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

痛点解决：之前使用第三方 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 审核校验后应用)

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 中静静观看三个模型协同工作的全过程。
 

🌟 日常开发"黄金 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 个）

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

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

🔧 ace-tool MCP 配置（可选）

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

1. 官方服务 ：前往 augmentcode.com 注册获取 Token
2. 中转服务 ： 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": "", "BASH_MAX_TIMEOUT_MS": "" 
 
            
} }
 
           

 
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多平台发布