0%

Claude Code 进阶：CCG-Workflow 多模型协作实战指南

Posted on In , ,
Symbols count in article: 5.3k Reading time ≈ 5 mins.

Claude Code 进阶：CCG-Workflow 多模型协作实战指南

📝 前言

在之前的 Claude Code 基础配置指南 中，我们解决了"怎么让 Claude Code 跑起来"的问题。但光跑起来还不够，怎么真正提升开发效率，才是后续的核心。

最近发现了一套叫 CCG-Workflow 的多模型协作系统——简单来说，就是让 Claude 负责指挥调度，让 Codex 专注后端，让 Gemini 专注前端。三个 AI 各取所长，协作效率提升非常明显。

一、项目概述

CCG-Workflow（Claude + Codex + Gemini）是一个多模型协作系统，旨在提供智能路由和开发工作流程优化。它将不同 AI 模型的优势结合起来，为开发过程的各个阶段提供支持。

项目地址: https://github.com/fengshao1227/ccg-workflow 项目版本: v1.7.74 npm 包名: ccg-workflow

二、快速开始

2.1 30 秒了解

概念 说明
CCG Claude Code (主导编排) + Codex CLI (后端原型) + Gemini CLI (前端原型)
核心理念 让 Claude 专注于编排决策，把具体代码生成交给专业模型
智能路由 前端任务 → Gemini（擅长 UI/CSS/组件），后端任务 → Codex（擅长逻辑/算法/调试），全栈整合 → Claude（编排决策，质量把控）

2.2 一键安装

1
npx ccg-workflow

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

2.3 第一个命令

1
2
# 在 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

四、命令参考（16 个）

4.1 日常开发只需记住这几个

命令 用途 模式
/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 快速模式 Gemini
/ccg:backend 纯后端，Codex 快速模式 Codex

4.2 完整命令列表

开发工作流（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

五、使用场景

场景 1：项目初始化

1
2
3
/ccg:init "这是一个基于 React 和 Node.js 的电商平台"
/ccg:plan "实现用户注册和登录功能"
/ccg:analyze .

场景 2：功能开发

1
2
3
/ccg:feat "实现购物车功能"
/ccg:enhance src/
/ccg:test src/

场景 3：代码审查和部署

1
2
3
/ccg:review src/
/ccg:debug "修复登录页面的密码验证问题"
/ccg:analyze .

六、架构图

graph TD
    A[Claude Code CLI
主导编排] -->|任务分发| B[Codex CLI
后端原型]
    A -->|任务分发| C[Gemini CLI
前端原型]
    B -->|返回结果| D[Patch 审核]
    C -->|返回结果| D
    D -->|应用到代码库| E[代码实施]

七、前置要求

类型 要求
必需 Claude Code CLI，Node.js 18+
可选（按需安装） Codex CLI - 不装的话后端任务降级成 Claude，Gemini CLI - 不装的话前端任务也降级

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

八、高级配置

8.1 ace-tool MCP 配置

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

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

8.2 推荐全局提示词配置

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# 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，减少需求模糊 - ✅ 代码生成前强制检索上下文，避免幻觉 - ✅ 多模型协作规范化，提升代码质量

九、常见问题

Q: codeagent-wrapper: command not found？

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

1
2
3
4
5
# Mac/Linux
source ~/.zshrc

# Windows
# 重新打开 PowerShell

Q: 如何更新？

1
2
3
4
5
6
# npx 安装用户（所有平台通用）
npx ccg-workflow@latest
# 选择 "更新工作流"

# npm 全局安装用户
npm install -g ccg-workflow@latest

Q: 如何卸载？

1
2
3
4
5
npx ccg-workflow
# 选择 "卸载工作流"

# 如果之前用 npm install -g 安装过，还需执行：
npm uninstall -g ccg-workflow

Q: Claude Code 任务超时？

修改 ~/.claude/settings.json：

1
2
3
4
5
6
7
{
  "env": {
    "CODEX_TIMEOUT": "7200",
    "BASH_DEFAULT_TIMEOUT_MS": "600000",
    "BASH_MAX_TIMEOUT_MS": "3600000"
  }
}

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

这是 Codex CLI 0.80.0 的已知 bug。设置环境变量让 codeagent-wrapper 检测到完成后 1 秒强制终止进程。

1
2
3
4
5
# Mac/Linux - 添加到 ~/.zshrc 或 ~/.bashrc
export CODEAGENT_POST_MESSAGE_DELAY=1

# Windows PowerShell - 添加到用户环境变量
[Environment]::SetEnvironmentVariable("CODEAGENT_POST_MESSAGE_DELAY", "1", "User")

十、总结

CCG-Workflow 是一个功能强大的多模型协作系统，它将 Claude Code、Codex 和 Gemini 的优势结合起来，提供了完整的开发工作流程优化。通过智能路由和专业分工，开发者可以更高效地完成各种编程任务，从项目初始化到代码部署的整个过程都能得到 AI 的全方位支持。

🔗 相关链接： - CCG-Workflow GitHub - Claude Code 基础配置指南

下篇预告：03-Claude Code 核心功能全解析 - 深入探讨 Claude Code 的核心功能和使用技巧

-------------This blog is over! Thanks for your reading-------------