0 Fork 0

Files

T

li 1cbcabd6fb docs: clarify code authorship — Claude writes code by default, codex-exec as alternative

Make it clear that Codex/Gemini are analyzers, not code writers.
Default: Claude writes code (transparent, no black box).
codex-exec: Codex writes code + multi-model review.

2026-03-12 14:09:54 +08:00

2.1 KiB

Raw Blame History

Getting Started

What is CCG

In short: Codex and Gemini analyze. Claude writes the code. Fully transparent.

Your request
   │
   ↓
Claude Code (orchestration + code writing)
   │
   ├── Backend related → sent to Codex for analysis
   ├── Frontend related → sent to Gemini for analysis
   │
   ↓
Codex/Gemini return analysis (patches / proposals)
   │
   ↓
Claude synthesizes and writes the code ← you see every change

The key point: by default, Claude is the one writing code — not a black box. You see the full process in Claude Code. Codex and Gemini are "advisors" that never directly touch your files.

There's also codex-exec mode: Codex writes the code instead, then Claude + Gemini do multi-model cross-review. Good for well-defined tasks with lower token cost. See Workflow Guide.

What you need

Node.js 20+ — Below 20 will break (ora@9.x requires it)
Claude Code CLI — Nothing works without this
jq — For the auto-authorization hook
Codex CLI — Optional. Enables backend routing
Gemini CLI — Optional. Enables frontend routing

Install

npx ccg-workflow

First run asks you to pick a language. After that, it remembers.

Installing jq

::: code-group

brew install jq

sudo apt install jq

sudo yum install jq

choco install jq
# or
scoop install jq

:::

Installing Claude Code

npx ccg-workflow menu  # Look for "Install Claude Code"

Works with npm, homebrew, curl, powershell, and cmd.

Try it out

After installing, type this in Claude Code:

/ccg:frontend add a dark mode toggle to the login page

If you see Gemini being called, you're good.

Updating and uninstalling

# Update
npx ccg-workflow@latest

# Uninstall
npx ccg-workflow  # Select "Uninstall"

What's next

Command Reference — All 28 commands
Workflow Guide — Which workflow for which scenario
MCP Configuration — Smarter code search

2.1 KiB Raw Blame History