CCG - Claude + Codex + Gemini Multi-Model Collaboration

Claude Code 编排 Codex + Gemini 的多模型协作开发系统。前端任务路由至 Gemini，后端任务路由至 Codex，Claude 负责编排决策和代码审核。

安装

npx ccg-workflow

要求：Claude Code CLI、Node.js 20+

重要：本项目依赖 ora@9.x 和 string-width@8.x，这些包要求 Node.js >= 20。使用 Node.js 18 会导致 SyntaxError: Invalid regular expression flags 错误。请确保升级到 Node.js 20 或更高版本。

可选：Codex CLI（后端）、Gemini CLI（前端）

命令

命令	说明
/ccg:workflow	6 阶段完整工作流
/ccg:plan	多模型协作规划 (Phase 1-2)
/ccg:execute	多模型协作执行 (Phase 3-5)
/ccg:feat	新功能开发
/ccg:frontend	前端任务 (Gemini)
/ccg:backend	后端任务 (Codex)
/ccg:analyze	技术分析
/ccg:debug	问题诊断
/ccg:optimize	性能优化
/ccg:test	测试生成
/ccg:review	代码审查
/ccg:commit	Git 提交
/ccg:rollback	Git 回滚
/ccg:clean-branches	清理分支
/ccg:worktree	Worktree 管理
/ccg:init	初始化 CLAUDE.md
/ccg:enhance	Prompt 增强

注意：v1.7.52 起，/ccg:spec-* 命令已迁移到 OPSX 架构。请使用 /opsx:* 命令代替：

• /opsx:init - 初始化 OPSX 环境
• /opsx:research - 需求 → 约束集
• /opsx:plan - 约束 → 零决策计划
• /opsx:impl - 按计划执行 + 归档
• /opsx:review - 双模型交叉审查

OPSX 规范驱动（v1.7.52+）

集成 OPSX 架构，把需求变成约束，让 AI 没法自由发挥：

# 初始化
/opsx:init

# 研究需求 → 输出约束集
/opsx:research 实现用户认证

# 并行分析 → 零决策计划
/opsx:plan

# 按计划执行
/opsx:impl

# 独立审查（随时可用）
/opsx:review

重要：v1.7.52 起，旧的 /ccg:spec-* 命令已废弃，请使用 /opsx:* 命令。每阶段之间可 /clear，状态存在 opsx/ 目录，不怕上下文爆。

规划与执行分离

v1.7.39 新增 /ccg:plan 和 /ccg:execute 命令，将规划与执行解耦：

# 1. 生成实施计划
/ccg:plan 实现用户认证功能

# 2. 审查计划（可修改）
# 计划保存至 .claude/plan/user-auth.md

# 3. 执行计划（新会话也可执行）
/ccg:execute .claude/plan/user-auth.md

配置

目录结构

~/.claude/
├── commands/ccg/       # 斜杠命令
├── agents/ccg/         # 子智能体
├── bin/codeagent-wrapper
└── .ccg/
    ├── config.toml
    └── prompts/{codex,gemini}/

环境变量

变量	说明	默认值
CODEAGENT_POST_MESSAGE_DELAY	Codex 完成后等待时间（秒）	5
CODEX_TIMEOUT	codeagent-wrapper 执行超时（秒）	7200
BASH_DEFAULT_TIMEOUT_MS	Claude Code Bash 默认超时（毫秒）	120000
BASH_MAX_TIMEOUT_MS	Claude Code Bash 最大超时（毫秒）	600000

配置方式（~/.claude/settings.json）：

{
  "env": {
    "CODEAGENT_POST_MESSAGE_DELAY": "1",
    "CODEX_TIMEOUT": "7200",
    "BASH_DEFAULT_TIMEOUT_MS": "600000",
    "BASH_MAX_TIMEOUT_MS": "3600000",
    "GEMINI_API_KEY": "your-gemini-api-key",
    "GOOGLE_API_KEY": "your-google-api-key"
  }
}

VSCode 插件用户注意：VSCode 启动的子进程不会继承终端环境变量，必须在 settings.json 中配置 API 密钥，否则 Gemini 会报退出码 41（授权失败）。

MCP 配置

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

Token 获取：https://augmentcode.com/

更新 / 卸载

# 更新
npx ccg-workflow@latest          # npx 用户
npm install -g ccg-workflow@latest  # npm 全局用户

# 卸载
npx ccg-workflow  # 选择 "卸载工作流"
npm uninstall -g ccg-workflow  # npm 全局用户需额外执行

已知问题

Codex CLI 0.80.0 进程不退出

--json 模式下 Codex 完成输出后进程不会自动退出。

解决：设置 CODEAGENT_POST_MESSAGE_DELAY=1

架构

Claude Code (编排)
       │
   ┌───┴───┐
   ↓       ↓
Codex   Gemini
(后端)   (前端)
   │       │
   └───┬───┘
       ↓
  Unified Patch

外部模型无写入权限，仅返回 Patch，由 Claude 审核后应用。

致谢

• cexll/myclaude - codeagent-wrapper
• UfoMiao/zcf - Git 工具
• GudaStudio/skills - 路由设计
• ace-tool - MCP 工具

Star History

License

MIT

---

v1.7.52 | Issues