CCG - Claude + Codex + Gemini Multi-Model Collaboration

简体中文 | English | Documentation

♥️ Sponsor

Gamma Remover — Free browser-local Gamma watermark remover for PDF & PPTX. No signup, instant results, 100% private. Your files never leave your device.

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.

What is CCG?

CCG is a workflow engine for Claude Code. It turns Claude into a multi-model orchestrator — Claude stays in control while dispatching specialized work to Codex (OpenAI), Gemini (Google), and Grok (xAI) through a Go binary bridge.

One command. Describe what you want. The engine handles the rest.

npx ccg-workflow    # Install in 60 seconds

Architecture

Claude Code is the lead orchestrator. It analyzes your intent, selects a strategy, and manages the entire workflow. The Hook Engine injects state every turn so Claude never loses context — even after compaction. The codeagent-wrapper (a compiled Go binary) bridges Claude to external models for parallel analysis and review.

How It Works

You: /ccg:go add JWT authentication to this API

CCG Engine:
  1. Reads project context (git status, tech stack, file structure)
  2. Classifies: feature / L complexity / backend / high risk
  3. Selects strategy: full-collaborate
  4. Creates .ccg/tasks/add-jwt-auth/task.json
  5. Launches dual-model analysis (Codex + Gemini in parallel)
  6. Produces plan → HARD STOP for your approval
  7. Spawns Agent Teams Builders for parallel implementation
  8. Runs quality gates + dual-model cross-review
  9. Reports results

Every turn, a hook injects:
  <ccg-state>
  Task: add-jwt-auth (in_progress)
  Strategy: full-collaborate
  Phase: 4-implementation
  </ccg-state>

10 Built-in Strategies

The engine auto-selects the right strategy based on task type and complexity:

Simple tasks run fast with zero overhead. Complex tasks get the full engine.

Core Features

Hook Engine — Never Lose Context

4 JavaScript hooks inject state into every Claude Code session:

Context survives compaction. Sub-agents born with spec in their prompt. Zero state loss.

Task System — Persistent Lifecycle

Medium+ complexity tasks get a persistent directory:

.ccg/tasks/add-jwt-auth/
├── task.json         # Status, strategy, phase, gate
├── requirements.md   # Enhanced requirements
├── plan.md           # Approved implementation plan
├── context.jsonl     # Spec files for sub-agent injection
├── review.md         # Review results
└── research/         # Persisted research findings

Quality Gates — Built-in Security & Quality

100+ Domain Knowledge Files

When your message mentions security, caching, RAG, Kubernetes, etc., the relevant knowledge file is auto-injected. 10 domains, 61 files:

Security · Architecture · DevOps · AI/MLOps · Development · Frontend Design · Infrastructure · Mobile · Data Engineering · Orchestration

Commands

Core (v3.0 default: 13 commands)

OpenSpec Integration

Legacy Mode (18 additional commands)

Includes /ccg:workflow, /ccg:plan, /ccg:execute, /ccg:frontend, /ccg:backend, /ccg:analyze, /ccg:debug, /ccg:optimize, /ccg:test, /ccg:review, /ccg:team, and more.

Quick Start

# Install (interactive 4-step wizard)
npx ccg-workflow

# Or non-interactive with defaults
npx ccg-workflow init --skip-prompt

Requires Node.js 20+ and Claude Code CLI. Codex CLI, Gemini CLI, and Grok CLI are optional (enable multi-model features).

CLI Commands

npx ccg-workflow                          # Interactive menu
npx ccg-workflow init                     # 4-step install wizard
npx ccg-workflow doctor                   # Environment health check
npx ccg-workflow status                   # Installation overview
npx ccg-workflow codex-mode install       # Install Codex-Led mode
npx ccg-workflow codex-mode uninstall     # Uninstall Codex-Led mode
npx ccg-workflow uninstall                # Uninstall CCG
npx ccg-workflow config mcp               # Configure MCP tokens
npx ccg-workflow diagnose-mcp             # Diagnose MCP issues

Configuration

~/.claude/
├── commands/ccg/          # Slash commands
├── hooks/ccg/             # Hook scripts (5 files)
├── skills/ccg/            # Quality gates + 100+ domain knowledge
├── rules/                 # Auto-trigger rules
├── .ccg/
│   ├── config.toml        # Model routing, MCP, performance
│   ├── engine/            # 10 strategy files + model router
│   └── prompts/           # Expert prompts (codex/gemini/claude)
└── bin/codeagent-wrapper  # Multi-model bridge (Go binary)

Environment Variables

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

Update / Uninstall

npx ccg-workflow@latest     # Update to latest
npx ccg-workflow doctor     # Check health after update
npx ccg-workflow uninstall  # Clean uninstall

Credits

• cexll/myclaude — codeagent-wrapper inspiration
• [UfoMiao/zcf](https://g