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

CCG-workflow：

• 零配置模型路由
• — 前端任务自动走 Gemini，后端任务自动走 Codex，无需手动切换。
• 安全设计
• — 外部模型无写入权限，仅返回 Patch，由 Claude 审核后应用。
• 27 个斜杠命令
• — 从规划到执行、Git 工作流到代码审查，通过 /ccg:* 一站式访问。
• 规范驱动开发
• — 集成 OPSX，将模糊需求变成可验证约束，让 AI 没法自由发挥。

架构

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

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

快速开始

前置条件

安装

●●●bash
npx ccg-workflow

首次运行会提示选择语言（简体中文 / English），选择后自动保存，后续无需再选。

安装 jq

●●●bash
# macOS
brew install jq

# Linux (Debian/Ubuntu)
sudo apt install jq

# Linux (RHEL/CentOS)
sudo yum install jq

# Windows
choco install jq   # 或: scoop install jq

安装 Claude Code

●●●bash
npx ccg-workflow menu  # 选择「安装 Claude Code」

支持：npm、homebrew、curl、powershell、cmd。

命令

开发工作流

分析与质量

OPSX 规范驱动

Agent Teams（v1.7.60+）

前置条件：需在 settings.json 中启用：
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Git 工具

项目管理

工作流指南

规划与执行分离

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

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

# 3a. 执行计划（Claude 重构）— 精细控制
/ccg:execute .claude/plan/user-auth.md

# 3b. 执行计划（Codex 全权）— 高效执行，Claude token 极低
/ccg:codex-exec .claude/plan/user-auth.md

OPSX 规范驱动工作流

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

●●●bash
/ccg:spec-init                       # 初始化 OPSX 环境
/ccg:spec-research 实现用户认证        # 研究需求 → 输出约束集
/ccg:spec-plan                       # 并行分析 → 零决策计划
/ccg:spec-impl                       # 按计划执行
/ccg:spec-review                     # 独立审查（随时可用）

提示：/ccg:spec-* 命令内部调用 /opsx:*。每阶段之间可 /clear，状态存在 openspec/ 目录，不怕上下文爆。

Agent Teams 并行工作流

利用 Claude Code Agent Teams 实验特性，spawn 多个 Builder teammates 并行写代码：

●●●bash
/ccg:team-research 实现实时协作看板 API  # 1. 需求 → 约束集
# /clear
/ccg:team-plan kanban-api               # 2. 规划 → 并行计划
# /clear
/ccg:team-exec                          # 3. Builder 并行写代码
# /clear
/ccg:team-review                        # 4. 双模型交叉审查

vs 传统工作流：Team 系列每步 /clear 隔离上下文，通过文件传递状态。适合可拆分为 3+ 独立模块的任务。

配置

目录结构

●●●code
~/.claude/
├── commands/ccg/       # 27 个斜杠命令
├── agents/ccg/         # 子智能体
├── skills/ccg/         # 质量关卡 + 多 Agent 协同
├── bin/codeagent-wrapper
└── .ccg/
    ├── config.toml     # CCG 配置
    └── prompts/
        ├── codex/      # 6 个 Codex 专家提示词
        └── gemini/     # 7 个 Gemini 专家提示词

环境变量

在 ~/.claude/settings.json 的 “env” 中配置：

settings.json 示例

●●●json
{
  "env": {
    "CODEAGENT_POST_MESSAGE_DELAY": "1",
    "CODEX_TIMEOUT": "7200",
    "BASH_DEFAULT_TIMEOUT_MS": "600000",
    "BASH_MAX_TIMEOUT_MS": "3600000"
  }
}

MCP 配置

●●●bash
npx ccg-workflow menu  # 选择「配置 MCP」

代码检索（多选一）：

●ace-tool（推荐）— 代码检索 search_context 可用。官方 | 第三方中转

●fast-context（推荐）— Windsurf Fast Context，AI 驱动搜索，无需全量索引。需 Windsurf 账号

●ContextWeaver（备选）— 本地混合搜索，需要硅基流动 API Key（免费）

辅助工具（可选）：

●Context7 — 获取最新库文档（自动安装）

●Playwright — 浏览器自动化 / 测试

●DeepWiki — 知识库查询

●Exa — 搜索引擎（需 API Key）

自动授权 Hook

CCG 安装时自动写入 Hook，自动授权 codeagent-wrapper 命令（需 jq）。

实用工具

●●●bash
npx ccg-workflow menu  # 选择「实用工具」

●ccusage — Claude Code 用量分析

●CCometixLine — 状态栏工具（Git + 用量跟踪）

更新 / 卸载

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

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