Install CCG Workflow - Multi-Model AI Coding Setup Guide

CCG Workflow installs as a set of hooks, commands, and configuration files into your Claude Code environment. The setup wizard handles everything in under a minute.

Prerequisites

Dependency	Version	Required	Purpose
Node.js	20+	Yes	Runs CCG CLI and hooks
Claude Code CLI	Latest	Yes	Host environment for CCG
jq	Any	Yes	JSON parsing in hook scripts
Codex CLI	Latest	Optional	Enables backend analysis routing
Gemini CLI	Latest	Optional	Enables frontend analysis routing

Tip

CCG works without Codex CLI or Gemini CLI installed, but strategies involving external models will automatically downgrade. For example, full-collaborate falls back to guided-develop when external models are unavailable.

Installation

Recommended: Run with npx

npx ccg-workflow

The first run launches the interactive setup wizard. No global install needed.

Global Install (Optional)

npm install -g ccg-workflow
ccg-workflow

Setup Wizard

The installer guides you through the following steps:

Step 1: Language Selection

Choose your interface language on first launch (Chinese / English).

Step 2: API Configuration

Configure how external models authenticate:

• Official login — Use Codex / Gemini CLI’s built-in authentication
• API Key — Enter a third-party API key
• Skip — Configure later through the interactive menu

Step 3: Model Routing

Select which external models to enable:

• Codex CLI (backend analysis)
• Gemini CLI (frontend analysis)
• Both (recommended for full dual-model collaboration)

Step 4: MCP Tools

Choose MCP services to configure:

• fast-context — Natural language code retrieval
• ace-tool — Semantic code search
• context7 — Live library documentation queries

Step 5: Performance Mode

• Standard mode — Suitable for most projects
• High-performance mode — Enables Agent Teams parallel execution (requires CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)

Note

New users see a streamlined 2-step flow (language + one-click install) with sensible defaults. Advanced options can be adjusted later through the npx ccg-workflow interactive menu.

What Gets Installed

After installation, the following files are written to ~/.claude/:

~/.claude/
├── commands/ccg/           # 13 slash commands (.md files)
├── hooks/ccg/              # 4 hook scripts (.js files)
│   ├── workflow-state.js
│   ├── session-start.js
│   ├── subagent-context.js
│   └── skill-router.js
├── .ccg/
│   ├── config.toml         # Model routing, MCP, performance config
│   ├── engine/             # Strategy files + model router
│   └── prompts/            # Expert prompts for external models
├── skills/ccg/             # Quality gates + domain knowledge files
├── bin/codeagent-wrapper   # Multi-model execution bridge (Go binary)
└── settings.json           # Hook registration + env vars (appended)

Verify Installation

After installation, type the following in a Claude Code session:

/ccg:go hello

If the engine begins analyzing your intent, the installation was successful.

Updating

npx ccg-workflow@latest

When the installer detects an existing configuration, it performs an incremental update without overwriting your custom settings.

Uninstalling

npx ccg-workflow
# Select "Uninstall" from the interactive menu

Uninstallation removes all CCG-installed files (commands, hooks, config) but does not affect the Claude Code CLI itself.