CCG = Claude Code (编排) + Codex CLI (后端) + Gemini CLI (前端)
一个让 Claude Code 专注于编排决策，把具体代码生成交给专业模型的多模型协作系统：
- 前端任务 → Gemini（擅长 UI/CSS/组件）
- 后端任务 → Codex（擅长逻辑/算法/调试）
- 全栈整合 → Claude（工作流控制、代码主权）
- ✅ 智能路由 - 前端 → Gemini，后端 → Codex，自动选择
- ✅ 多模型并行 - Codex ∥ Gemini 同时分析，交叉验证减少错误
- ✅ 零写入权限 - 外部模型只返回 Patch，Claude 保持代码主权
- ✅ Token 优化 - ROLE_FILE 动态注入，专家提示词零消耗
- ✅ Web UI 实时输出 - 自动打开浏览器，流式显示思考过程、命令执行、生成结果
- ✅ 一键安装 - npx 运行，自动安装全部 15 个命令
必需：
- Claude Code CLI
- Node.js 18+
可选（根据需求安装）：
- Codex CLI - 用于后端任务
- Gemini CLI - 用于前端任务
💡 只装 Claude Code 也能用！ 系统会自动降级为纯 Claude 工作流
npx ccg-workflow安装流程：
- 选择是否配置 ace-tool MCP（可跳过）
- 确认安装
- 自动安装全部 15 个命令
- 配置 PATH（如需要）
就这么简单！无需选择语言、模型、命令预设。
| 项目 | 配置 |
|---|---|
| 前端模型 | Gemini |
| 后端模型 | Codex |
| 协作模式 | smart |
| 命令数量 | 15 个（全部安装） |
# 在 Claude Code 中执行
/ccg:workflow 实现用户登录功能
# 自动执行 6 阶段工作流：
# 阶段 1: 研究 - Prompt 增强 + 上下文检索
# 阶段 2: 构思 - 多模型分析 (Codex ∥ Gemini)
# 阶段 3: 计划 - 多模型规划 + 用户确认
# 阶段 4: 执行 - 代码实施
# 阶段 5: 优化 - 多模型审查
# 阶段 6: 评审 - 质量检查/ccg:workflow # 完整任务（6 阶段工作流）
/ccg:feat # 新功能开发（自动规划）
/ccg:frontend # 纯前端任务（Gemini 主导，更快）
/ccg:backend # 纯后端任务（Codex 主导，更快）| 命令 | 用途 | 模型 |
|---|---|---|
/ccg:workflow |
完整 6 阶段开发工作流 | Codex ∥ Gemini |
/ccg:frontend |
前端专项（快速模式） | Gemini |
/ccg:backend |
后端专项（快速模式） | Codex |
/ccg:feat |
智能功能开发 | 规划 → 实施 |
/ccg:enhance |
Prompt 增强（ace-tool） | MCP |
/ccg:analyze |
技术分析（仅分析不改代码） | Codex ∥ Gemini |
/ccg:debug |
问题诊断 + 修复 | Codex ∥ Gemini |
/ccg:optimize |
性能优化 | Codex ∥ Gemini |
/ccg:test |
测试生成 | 智能路由 |
/ccg:review |
代码审查（无参数自动审查 git diff） | Codex ∥ Gemini |
| 命令 | 用途 |
|---|---|
/ccg:commit |
智能提交（自动生成 conventional commit） |
/ccg:rollback |
交互式回滚 |
/ccg:clean-branches |
清理已合并分支 |
/ccg:worktree |
Worktree 管理 |
| 命令 | 用途 |
|---|---|
/ccg:init |
初始化项目 CLAUDE.md |
12 个专家提示词（Codex 6 + Gemini 6），零 token 消耗：
Codex 专家（后端）：
architect.md- 后端架构师analyzer.md- 技术分析师debugger.md- 调试专家optimizer.md- 性能优化师reviewer.md- 代码审查员tester.md- 测试工程师
Gemini 专家（前端）：
frontend.md- 前端架构师analyzer.md- UI/UX 分析师debugger.md- 前端调试专家optimizer.md- 前端性能优化reviewer.md- 代码审查员tester.md- 前端测试工程师
工作原理：
- 每个命令自动注入对应角色提示词
- 通过
codeagent-wrapper子进程读取 - 不占用主会话 token
- 用户可自定义修改（路径：
~/.claude/.ccg/prompts/）
~/.claude/
├── commands/ccg/ # 15 个斜杠命令
├── agents/ccg/ # 4 个子智能体
├── skills/ # 暂无
├── bin/
│ └── codeagent-wrapper # Go 多后端调用工具
└── .ccg/
├── config.toml # 主配置
└── prompts/ # 12 个专家提示词
├── codex/
└── gemini/
┌─────────────────────────────────────────────────┐
│ Claude Code CLI (主导编排) │
│ 决策、编排、代码实施、质量把控 │
└──────────────┬──────────────────────────────────┘
│
┌───────┴────────┐
│ │
↓ ↓
┌─────────────┐ ┌─────────────┐
│ Codex CLI │ │ Gemini CLI │
│ 后端专家 │ │ 前端专家 │
│ 逻辑算法 │ │ UI 组件 │
└─────────────┘ └─────────────┘
│ │
└────────┬───────┘
↓
Unified Diff Patch
(零写入权限，仅返回补丁)
信任规则：
- 后端问题 → 以 Codex 意见为准
- 前端问题 → 以 Gemini 意见为准
- 冲突时 → Claude 综合判断，向用户说明分歧
Q1: 只装了 Claude Code，没装 Codex/Gemini 能用吗？
✅ 可以！ 系统会自动降级为纯 Claude 工作流。
但会失去：
- 智能路由（前端/后端自动分配）
- 多模型并行（交叉验证）
- 专家角色系统（ROLE_FILE 注入）
建议至少安装 Codex 或 Gemini 其中一个以获得完整体验。
Q2: MCP 工具如何配置？
安装时配置（推荐）：
npx ccg-workflow
# 选择 "安装 ace-tool"ace-tool 两种方式：
-
官方服务：
- 注册地址：https://augmentcode.com/
- 获取 Token 后填写即可
-
中转服务（无需注册）⭐：
- 免费使用：https://linux.do/t/topic/1291730
- linux.do 社区提供
- 需填写 Base URL 和 Token
跳过 MCP：
跳过 MCP 后，命令中涉及 ace-tool 的步骤（代码检索、Prompt 增强）会失效，但其他功能正常工作。
Q3: 如何更新到最新版本？
npx ccg-workflow@latest
# 选择 "更新工作流"更新会自动：
- 检测 npm 最新版本
- 增量更新命令和提示词
- 保留 MCP 配置
Q4: `/ccg:workflow` 和 `/ccg:frontend`/`/ccg:backend` 有什么区别？
-
/ccg:workflow- 完整 6 阶段工作流- 每阶段都并行调用 Codex + Gemini
- 适合全栈任务、复杂任务
-
/ccg:frontend//ccg:backend- 专项快速模式- 只调用对应主导模型（更快）
- 适合明确的纯前端/纯后端任务
Q5: 安装后提示 "codeagent-wrapper: command not found"？
原因：PATH 未生效
解决方案：
Mac/Linux：
source ~/.zshrc
# 或
source ~/.bashrcWindows：
# 重新打开 PowerShellQ6: 如何卸载？
npx ccg-workflow
# 选择 "卸载工作流"会删除：
~/.claude/commands/ccg/- 命令文件~/.claude/agents/ccg/- 子智能体~/.claude/skills/- skills~/.claude/bin/codeagent-wrapper*- 二进制文件~/.claude/.ccg/- 配置目录（可选保留）
如果你曾经运行过 npm install -g ccg-workflow，需要两步卸载：
# 第 1 步：卸载工作流文件
npx ccg-workflow
# 选择 "卸载工作流"
# 第 2 步：卸载 npm 全局包（必须执行，否则 ccg 命令仍可用）
npm uninstall -g ccg-workflowv1.7.11 新增：系统会自动检测全局安装并提示第 2 步操作。
# 删除所有工作流文件
rm -rf ~/.claude/commands/ccg
rm -rf ~/.claude/agents/ccg
rm -rf ~/.claude/skills/multi-model-collaboration
rm -rf ~/.claude/bin/codeagent-wrapper*
rm -rf ~/.claude/.ccg
# 如果是全局安装，还需执行
npm uninstall -g ccg-workflow
# 清理 MCP 配置（如果安装了 ace-tool）
# 手动编辑 ~/.claude.json 删除 ace-tool 相关配置如果卸载后重新安装仍使用旧版本，清理 npx 缓存：
# 清理 npx 缓存
npx clear-npx-cache
# 或
rm -rf ~/.npm/_npx
# 然后重新安装
npx ccg-workflow@latest感谢以下开源项目的贡献：
- cexll/myclaude - codeagent-wrapper 多后端调用工具
- UfoMiao/zcf - Git 工具与 MCP 配置逻辑
- GudaStudio/skills - 智能路由设计理念
- ace-tool MCP - 轻量级代码检索和 Prompt 增强
- linux.do 社区 - 活跃的 Vibe Coding 技术交流社区
- GitHub Issues: 提交问题
- 讨论社区: linux.do - CCG 讨论帖
本项目采用 MIT License 开源协议。
Copyright (c) 2025 fengshao1227
版本: v1.7.10 | 最后更新: 2026-01-09
Made with ❤️ by the CCG Community