CCG

CCG（Claude + Codex + Gemini）是一个基于 Claude Code CLI 构建的多模型协作开发框架。它不依赖单一 AI 模型，而是通过智能分工，让每个模型在其擅长领域发挥最大效能：

• 前端任务 → 交由 Gemini（UI、CSS、组件生成）
• 后端任务 → 交由 Codex（逻辑、算法、调试）
• 整体流程控制与代码主权 → 由 Claude Code 主导

这种“编排 + 专家执行”的架构，既提升了生成质量，又保障了开发者对代码的最终控制权。

为什么需要多模型协作？

当前主流 AI 编码助手大多采用单一模型处理全栈任务。但现实是：

• Gemini 在前端语义理解、响应式布局、React/Vue 组件生成上表现优异；
• Codex（或其开源替代）在复杂逻辑、数据库交互、性能调优方面更可靠；
• 而 Claude 在长上下文推理、任务拆解、跨文件协调上具备优势。

CCG 的设计哲学是：不强求一个模型通吃一切，而是让专业模型做专业事。

核心特性

✅ 智能路由

自动识别任务类型：

• /ccg:frontend → 调用 Gemini
• /ccg:backend → 调用 Codex
• /ccg:workflow → 同时调用两者，协同完成全栈任务

✅ 多模型并行 & 交叉验证

Codex 与 Gemini 可同时分析同一需求，输出结果经 Claude 对比、融合或提示冲突，显著降低幻觉风险。

✅ 零写入权限，保障代码主权

外部模型仅返回 Unified Diff 补丁，不直接修改文件。最终是否应用、如何合并，由开发者或 Claude 决策。

✅ Token 优化：ROLE_FILE 动态注入

系统内置 12 个专家角色提示词（如“前端架构师”、“性能优化师”），通过 codeagent-wrapper 子进程动态加载，不占用主会话 token，实现“零成本专家模式”。

✅ Web UI 实时反馈

执行命令时自动打开浏览器，流式展示：

• 模型思考过程
• 命令执行日志
• 代码生成与审查结果

✅ 一键安装，开箱即用

npx ccg-workflow

自动安装全部 15 个命令，并配置环境路径。即使只安装 Claude Code，也能降级运行基础工作流。

快速开始

前置依赖

• 必需：Claude Code CLI + Node.js 18+
• 可选：Codex CLI（后端）、Gemini CLI（前端）

💡 未安装 Codex 或 Gemini？系统会自动回退到纯 Claude 模式，功能完整但失去多模型优势。

第一个命令

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

系统将自动执行 6 阶段工作流：

1. 研究：增强 Prompt + 检索项目上下文
2. 构思：Codex 与 Gemini 并行分析
3. 计划：生成实施步骤，等待用户确认
4. 执行：生成前后端代码（通过补丁形式）
5. 优化：多模型联合审查与性能建议
6. 评审：最终质量检查与文档建议

命令体系（15 个，分三类）

开发工作流

Git 工具

• /ccg:commit：生成符合 Conventional Commits 的提交信息
• /ccg:rollback：交互式回滚
• /ccg:clean-branches：清理已合并分支
• /ccg:worktree：Worktree 管理

项目工具

• /ccg:init：初始化项目元数据（CLAUDE.md）

专家角色系统

系统预置 12 个专家提示词，按领域划分：

• Codex（后端）：架构师、分析师、调试员、优化师、审查员、测试工程师
• Gemini（前端）：前端架构师、UI/UX 分析师、前端调试员、前端优化师、审查员、测试工程师

这些角色通过 ~/.claude/.ccg/prompts/ 目录加载，用户可自行修改或扩展。

架构图解

┌─────────────────────────────────────────────────┐
│          Claude Code CLI (主导编排)              │
│        决策、编排、代码实施、质量把控             │
└──────────────┬──────────────────────────────────┘
               │
       ┌───────┴────────┐
       │                │
       ↓                ↓
┌─────────────┐  ┌─────────────┐
│  Codex CLI  │  │ Gemini CLI  │
│  后端专家   │  │  前端专家   │
│  逻辑算法   │  │  UI 组件    │
└─────────────┘  └─────────────┘
       │                │
       └────────┬───────┘
                ↓
      Unified Diff Patch
    (仅返回补丁，不写文件)

信任规则：

• 后端问题以 Codex 为准
• 前端问题以 Gemini 为准
• 出现分歧时，Claude 综合判断并向用户说明

常见问题解答

Q1：只装了 Claude Code，能用吗？

✅ 可以。系统自动降级为单模型工作流，但会失去智能路由、并行验证和专家角色功能。建议至少安装 Codex 或 Gemini 其一。

Q2：MCP 工具（如 ace-tool）怎么配？

安装时可选择配置：

• 官方服务：注册 augmentcode.com 获取 Token
• 中转服务（免注册）：使用 linux.do 社区提供地址

跳过 MCP 不影响核心功能，仅禁用代码检索与 Prompt 增强。

Q3：如何更新？

npx ccg-workflow@latest

支持增量更新，保留原有配置。

Q4：/ccg:workflow 和专项命令有何区别？

• workflow：全栈、6 阶段、双模型并行，适合复杂任务
• frontend/backend：单模型、快速响应，适合明确边界的小任务

Q5：提示 “codeagent-wrapper: command not found”？

请重新加载 shell 配置：

• Mac/Linux：source ~/.zshrc 或 source ~/.bashrc
• Windows：重启 PowerShell

Q6：如何彻底卸载？

推荐通过安装器卸载：

npx ccg-workflow  # 选择“卸载工作流”

若曾全局安装（npm install -g），还需额外执行：

npm uninstall -g ccg-workflow