CCG - Claude + Codex + Gemini Multi-Model Collaboration

简体中文 | English

♥️ Sponsor

302.AI is a pay-as-you-go enterprise AI resource hub that offers the latest and most comprehensive AI models and APIs on the market, along with a variety of ready-to-use online AI applications.

n1n.ai — Global LLM API Gateway. One API Key to access 500+ top AI models (GPT-5, Claude 4.5, Gemini 3 Pro, and more).

A multi-model collaboration development system where Claude Code orchestrates Codex + Gemini. Frontend tasks route to Gemini, backend tasks route to Codex, and Claude handles orchestration and code review.

Why CCG?

• Zero-config model routing — Frontend tasks automatically go to Gemini, backend tasks to Codex. No manual switching.
• Security by design — External models have no write access. They return patches; Claude reviews before applying.
• 29+ slash commands — From planning to execution, git workflow to code review, all accessible via /ccg:*.
• Spec-driven development — Integrates OPSX to turn vague requirements into verifiable constraints, eliminating AI improvisation.

Architecture

Claude Code (Orchestrator)
       │
   ┌───┴───┐
   ↓       ↓
Codex   Gemini
(Backend) (Frontend)
   │       │
   └───┬───┘
       ↓
  Unified Patch

External models have no write access — they only return patches, which Claude reviews before applying.

🎬 See CCG in action → — Real multi-model collaboration demo on X

Quick Start

Prerequisites

| Dependency | Required | Notes | |------------|----------|-------| | Node.js 20+ | Yes | ora@9.x requires Node >= 20. Node 18 causes SyntaxError | | Claude Code CLI | Yes | Install guide | | jq | Yes | Used for auto-authorization hook (install) | | Codex CLI | No | Enables backend routing | | Gemini CLI | No | Enables frontend routing |

Installation

npx ccg-workflow

On first run, CCG prompts you to select a language (English / Chinese). This preference is saved for all future sessions.

Install jq

# macOS
brew install jq

# Linux (Debian/Ubuntu)
sudo apt install jq

# Linux (RHEL/CentOS)
sudo yum install jq

# Windows
choco install jq   # or: scoop install jq

Install Claude Code

npx ccg-workflow menu  # Select "Install Claude Code"

Supports: npm, homebrew, curl, powershell, cmd.

Commands

Development Workflow

| Command | Description | Model | |---------|-------------|-------| | /ccg:workflow | Full 6-phase development workflow | Codex + Gemini | | /ccg:plan | Multi-model collaborative planning (Phase 1-2) | Codex + Gemini | | /ccg:execute | Multi-model collaborative execution (Phase 3-5) | Codex + Gemini + Claude | | /ccg:codex-exec | Codex full execution (plan → code → review) | Codex + multi-model review | | /ccg:feat | Smart feature development | Auto-routed | | /ccg:frontend | Frontend tasks (fast mode) | Gemini | | /ccg:backend | Backend tasks (fast mode) | Codex |

Analysis & Quality

| Command | Description | Model | |---------|-------------|-------| | /ccg:analyze | Technical analysis | Codex + Gemini | | /ccg:debug | Problem diagnosis + fix | Codex + Gemini | | /ccg:optimize | Performance optimization | Codex + Gemini | | /ccg:test | Test generation | Auto-routed | | /ccg:review | Code review (auto git diff) | Codex + Gemini | | /ccg:enhance | Prompt enhancement | Built-in |

OPSX Spec-Driven

| Command | Description | |---------|-------------| | /ccg:spec-init | Initialize OPSX environment | | /ccg:spec-research | Requirements → Constraints | | /ccg:spec-plan | Constraints → Zero-decision plan | | /ccg:spec-impl | Execute plan + archive | | /ccg:spec-review | Dual-model cross-review |

Agent Teams (v1.7.60+)

| Command | Description | |---------|-------------| | /ccg:team-research | Requirements → constraints (parallel exploration) | | /ccg:team-plan | Constraints → parallel implementation plan | | /ccg:team-exec | Spawn Builder teammates for parallel coding | | /ccg:team-review | Dual-model cross-review |

Prerequisite: Enable Agent Teams in settings.json: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Git Tools

| Command | Description | |---------|-------------| | /ccg:commit | Smart commit (conventional commit format) | | /ccg:rollback | Interactive rollback | | /ccg:clean-branches | Clean merged branches | | /ccg:worktree | Worktree management |

Project Setup

| Command | Description | |---------|-------------| | /ccg:init | Initialize project CLAUDE.md | | /ccg:context | Project context management (.context/ init, log, compress, history) |

Workflow Guides

Planning & Execution Separation

# 1. Generate implementation plan
/ccg:plan implement user authentication

# 2. Review the plan (editable)
# Plan saved to .claude/plan/user-auth.md

# 3a. Execute (Claude refactors) — fine-grained control
/ccg:execute .claude/plan/user-auth.md

# 3b. Execute (Codex does everything) — efficient, low Claude token usage
/ccg:codex-exec .claude/plan/user-auth.md

OPSX Spec-Driven Workflow

Integrates OPSX architecture to turn requirements into constraints, eliminating AI improvisation:

/ccg:spec-init                          # Initialize OPSX environment
/ccg:spec-research implement user auth  # Research → constraints
/ccg:spec-plan                          # Parallel analysis → zero-decision plan
/ccg:spec-impl                          # Execute the plan
/ccg:spec-review                        # Independent review (anytime)

Tip: /ccg:spec-* commands internally call /opsx:*. You can /clear between phases — state is persisted in the openspec/ directory.

Agent Teams Parallel Workflow

Leverage Claude Code Agent Teams to spawn multiple Builder teammates for parallel coding:

/ccg:team-research implement kanban API  # 1. Requirements → constraints
# /clear
/ccg:team-plan kanban-api               # 2. Plan → parallel tasks
# /clear
/ccg:team-exec                          # 3. Builders code in parallel
# /clear
/ccg:team-review                        # 4. Dual-model cross-review

vs Traditional Workflow: Team series uses /clear between steps to isolate context, passing state through files. Ideal for tasks decomposable into 3+ independent modules.

Configuration

Directory Structure

~/.claude/
├── commands/ccg/       # 29+ slash commands
├── agents/ccg/         # Sub-agents
├── skills/ccg/         # Quality gates + multi-agent orchestration
├── bin/codeagent-wrapper
└── .ccg/
    ├── config.toml     # CCG configuration
    └── prompts/
        ├── codex/      # 6 Codex expert prompts
        └── gemini/     # 7 Gemini expert prompts

Environment Variables

Configure in ~/.claude/settings.json under "env":

| Variable | Description | Default | When to change | |----------|-------------|---------|----------------| | CODEAGENT_POST_MESSAGE_DELAY | Wait after Codex completion (sec) | 5 | Set to 1 if Codex process hangs | | CODEX_TIMEOUT | Wrapper execution timeout (sec) | 7200 | Increase for very long tasks | | BASH_DEFAULT_TIMEOUT_MS | Claude Code Bash timeout (ms) | 120000 | Increase if commands time out | | BASH_MAX_TIMEOUT_MS | Claude Code Bash max timeout (ms) | 600000 | Increase for long builds |

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

MCP Configuration

npx ccg-workflow menu  # Select "Configure MCP"

Code retrieval (choose one):

• ace-tool (recommended) — Code search via search_context. Official | Third-party proxy
• fast-context (recommended) — Windsurf Fast Context, AI-powered search without full-repo indexing. Requires Windsurf account
• ContextWeaver (alternative) — Local hybrid search, requires SiliconFlow API Key (free)

Optional tools:

• Context7 — Latest library documentation (auto-installed)
• Playwright — Browser automation / testing
• DeepWiki — Knowledge base queries
• Exa — Search engine (requires API Key)

Auto-Authorization Hook

CCG automatically installs a Hook to auto-authorize codeagent-wrapper commands (requires jq).

Add to ~/.claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",