li
1cbcabd6fb
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.
100 lines
2.1 KiB
Markdown
100 lines
2.1 KiB
Markdown
# 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](/en/guide/workflows).
|
|
|
|
## 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
|
|
|
|
```bash
|
|
npx ccg-workflow
|
|
```
|
|
|
|
First run asks you to pick a language. After that, it remembers.
|
|
|
|
### Installing jq
|
|
|
|
::: code-group
|
|
|
|
```bash [macOS]
|
|
brew install jq
|
|
```
|
|
|
|
```bash [Debian / Ubuntu]
|
|
sudo apt install jq
|
|
```
|
|
|
|
```bash [RHEL / CentOS]
|
|
sudo yum install jq
|
|
```
|
|
|
|
```bash [Windows]
|
|
choco install jq
|
|
# or
|
|
scoop install jq
|
|
```
|
|
|
|
:::
|
|
|
|
### Installing Claude Code
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# Update
|
|
npx ccg-workflow@latest
|
|
|
|
# Uninstall
|
|
npx ccg-workflow # Select "Uninstall"
|
|
```
|
|
|
|
## What's next
|
|
|
|
- [Command Reference](/en/guide/commands) — All 28 commands
|
|
- [Workflow Guide](/en/guide/workflows) — Which workflow for which scenario
|
|
- [MCP Configuration](/en/guide/mcp) — Smarter code search
|