安装指南

前置依赖

依赖	版本	必要性	说明
Node.js	20+	必须	运行 CCG CLI
Claude Code CLI	最新	必须	CCG 的宿主环境
jq	任意	必须	Hook 脚本中用于解析 JSON
Codex CLI	最新	可选	启用后端分析路由
Gemini CLI	最新	可选	启用前端分析路由

安装方式

推荐：npx 直接运行

npx ccg-workflow

首次运行会自动进入安装向导。无需全局安装。

全局安装（可选）

npm install -g ccg-workflow
ccg-workflow

安装向导

安装器会引导你完成以下步骤：

步骤 1：语言选择

首次启动时选择界面语言（中文 / English）。

步骤 2：API 配置

配置外部模型的 API 访问方式：

官方登录：直接使用 Codex / Gemini CLI 的官方认证
API Key：填入第三方 API Key
跳过：暂不配置，后续可通过交互菜单补充

步骤 3：模型路由

选择启用的外部模型：

Codex CLI（后端分析）
Gemini CLI（前端分析）
两者都启用（推荐，获得完整的双模型协作能力）

步骤 4：MCP 工具

选择要配置的 MCP 服务：

fast-context — 自然语言代码检索
ace-tool — 语义代码搜索
context7 — 库文档实时查询

步骤 5：性能模式

标准模式：适合大多数项目
高性能模式：启用 Agent Teams 并行执行（需设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1）

安装产物

安装完成后，以下文件被写入 ~/.claude/：

~/.claude/
├── commands/ccg/           # 13 个斜杠命令（.md 文件）
├── hooks/ccg/              # 4 个 Hook 脚本（.js 文件）
│   ├── workflow-state.js
│   ├── session-start.js
│   ├── subagent-context.js
│   └── skill-router.js
├── .ccg/
│   ├── config.toml         # 模型路由、MCP、性能配置
│   ├── engine/             # 策略文件 + 模型路由器
│   └── prompts/            # 专家提示词
├── skills/ccg/             # 质量关卡 + 领域知识文件
├── bin/codeagent-wrapper   # 多模型执行桥（Go 二进制）
└── settings.json           # Hook 注册 + 环境变量（追加写入）

验证安装

安装完成后，在 Claude Code 中输入：

/ccg:go hello

如果看到引擎开始分析意图，说明安装成功。

更新

npx ccg-workflow@latest

安装器检测到已有配置时，会自动运行增量更新，不会覆盖你的自定义配置。

卸载

npx ccg-workflow
# 在交互菜单中选择「卸载」

卸载会移除 CCG 安装的所有文件（命令、Hook、配置），但不会影响 Claude Code CLI 本身。