CCG Workflow 多模型协作开发完整指南：10 分钟跑通你的第一个任务-开发者社区

CCG Workflow 多模型协作开发完整指南：10 分钟跑通你的第一个任务

【免费下载链接】ccg-workflow多模型协作开发系统 - Claude 编排 + Codex 后端 + Gemini 前端，28 个命令覆盖开发全流程，一键安装零配置项目地址: https://gitcode.com/fengshao1227/ccg-workflow

如果你还在多个 AI 编码工具之间手动复制粘贴结果，或者只依赖单一模型、UI 细节和后端架构都没人把关，CCG Workflow 就是用来省掉这些步骤的：它是一个多模型协作开发系统，你只用一句自然语言描述任务，Claude Code 作为编排中心，把后端任务路由给 Codex、前端任务路由给 Gemini，规划、审批、交叉审查全自动完成。

🚀 极速跑通：环境自检、安装与第一个协作任务

30 秒环境自检

前置要求：Node.js 20+、Claude Code CLI；jq 建议一并装上，自动授权 Hook 依赖它。

node -v && claude --version && jq --version

一条命令安装并体检

首次运行会让你选语言，然后进入 4 步交互向导，一路选默认即可，约 60 秒装完；装完跑一次健康检查，全绿就继续：

npx ccg-workflow # 安装 npx ccg-workflow doctor # 环境健康检查

第一个多模型协作任务怎么跑起来

在任意项目目录执行claude启动，然后输入：

/ccg:go 给这个 API 加一个 JWT 认证

/ccg:go 是智能入口，你不需要记命令。引擎先读 git 状态、技术栈和目录结构，把任务分类（功能 / 修 bug / 重构 / 调研 / 优化 / 审查 / git），再从 10 个内置策略中挑一个：小任务走 direct-fix 或 quick-implement，不启动外部模型，秒级完成；中大型任务会并行调用 Codex 与 Gemini 分析，产出计划后硬停等你审批，批准后才动代码，收尾时自动跑双模型交叉审查。

🧠 拆解原理：任务路由与模型编排机制

意图分类

动词决定类型——"加一个"是功能，"修一下"是修 bug，"对比"是调研，"提交"直接走 git 策略，你描述得越具体，分类越准。

策略与模型路由

分类结果映射到 10 个策略之一，从 direct-fix 到 full-collaborate。每个阶段用哪个模型由~/.claude/.ccg/config.toml的[routing]区块决定，默认后端任务走 Codex、前端任务走 Gemini，全栈任务两者并行；实际调用由 Go 编译的codeagent-wrapper二进制桥接完成，源码见 codeagent-wrapper/。

上下文保持

4 个 Hook 每轮向会话注入任务状态、在上下文压缩后恢复项目信息、给子代理的 prompt 直接附上 spec、按关键词注入领域知识。长任务中途不会"失忆"，子代理出生就带着规范。

📁 文件落盘位置：安装后系统里多了哪些文件

全局配置在用户目录，项目内每个中大型任务占一个持久目录：

~/.claude/ ├── commands/ccg/ # 斜杠命令 ├── hooks/ccg/ # 状态注入 Hook 脚本 ├── skills/ccg/ # 质量关卡 + 10 个领域知识 ├── .ccg/config.toml # 模型路由配置 └── bin/codeagent-wrapper # 多模型桥接二进制 .ccg/tasks/add-jwt-auth/ # 项目内 ├── task.json # 状态、策略、阶段 ├── plan.md # 已审批的计划 └── review.md # 审查结果

想复盘任务为什么走到某个分支，直接翻这两个位置。

🎛️ 调优与切换：环境变量、工作模式与高级玩法

性能环境变量怎么配

在~/.claude/settings.json里加：

{ "env": { "CODEAGENT_POST_MESSAGE_DELAY": "1", "CODEX_TIMEOUT": "7200" } }

前者把任务结束后的收尾等待从 5 秒压到 1 秒，后者给长任务留足外部模型超时。想让 Agent Teams 并行干活，再设CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS为1。

两种工作模式怎么切换

模式	谁写代码	适合
默认	Claude	重要功能，逐行看改动
Codex 主导	Codex，Claude + Gemini 交叉审查	目标明确的常规任务，省 Claude token

npx ccg-workflow codex-mode install # 切到 Codex 主导 npx ccg-workflow codex-mode uninstall # 切回默认

规划执行分离与规范驱动开发

先规划后执行：/ccg:plan 实现购物车生成计划存到.claude/plan/，你改完再/ccg:execute <计划文件>执行；
复杂项目走规范驱动：/ccg:spec-init→/ccg:spec-research→/ccg:spec-plan→/ccg:spec-impl；
Git 流程：/ccg:commit生成 Conventional Commit，/ccg:rollback交互式回滚。