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 增强 |
/ccg:spec-init |
初始化 OPSX 环境 |
/ccg:spec-research |
需求 → 约束集 |
/ccg:spec-plan |
约束 → 零决策计划 |
/ccg:spec-impl |
按计划执行 + 归档 |
/ccg:spec-review |
双模型交叉审查 |
/ccg:team-research |
Agent Teams 需求 → 约束集 |
/ccg:team-plan |
Agent Teams 约束 → 并行计划 |
/ccg:team-exec |
Agent Teams 并行实施 |
/ccg:team-review |
Agent Teams 双模型审查 |
集成 OPSX 架构，把需求变成约束，让 AI 没法自由发挥：
# 初始化 OPSX 环境
/ccg:spec-init
# 研究需求 → 输出约束集
/ccg:spec-research 实现用户认证
# 并行分析 → 零决策计划
/ccg:spec-plan
# 按计划执行
/ccg:spec-impl
# 独立审查（随时可用）
/ccg:spec-review说明：/ccg:spec-* 命令是 CCG 对 OPSX 的封装，内部调用 /opsx:* 命令。每阶段之间可 /clear，状态存在 openspec/ 目录，不怕上下文爆。
利用 Claude Code Agent Teams 实验特性，spawn 多个 Builder teammates 并行写代码：
# 1. 需求研究 → 约束集（复杂项目推荐，简单项目可跳过）
/ccg:team-research 实现实时协作看板 API
# 2. /clear 后规划 → 零决策并行计划
/ccg:team-plan kanban-api
# 3. /clear 后并行实施 → Builder teammates 并行写代码
/ccg:team-exec
# 4. /clear 后审查 → 双模型交叉审查
/ccg:team-review前置条件：需手动启用 Agent Teams（settings.json 中设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1）
vs 传统工作流：Team 系列每步 /clear 隔离上下文，通过文件传递状态。Builder 并行实施，适合可拆分为 3+ 独立模块的任务。
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"
}
}代码检索 MCP（二选一）：
- ContextWeaver（推荐）- 本地混合搜索，需要硅基流动 API Key（免费）
- ace-tool（收费）- Augment 官方，Token 获取：https://augmentcode.com/
辅助工具 MCP（可选）：
- Context7 - 获取最新库文档
- Playwright - 浏览器自动化/测试
- DeepWiki - 知识库查询
- Exa - 搜索引擎（需 API Key）
# 配置 MCP
npx ccg-workflow menu # 选择「配置 MCP」npx ccg-workflow menu # 选择「实用工具」- ccusage - Claude Code 用量分析
- CCometixLine - 状态栏工具（Git + 用量跟踪）
npx ccg-workflow menu # 选择「安装 Claude Code」支持多种安装方式：npm、homebrew、curl、powershell、cmd
# 更新
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 工具
MIT
v1.7.60 | Issues
