140 lines
3.6 KiB
Markdown
140 lines
3.6 KiB
Markdown
# CCG - Claude + Codex + Gemini Multi-Model Collaboration
|
||
|
||
<div align="center">
|
||
|
||
[](https://www.npmjs.com/package/ccg-workflow)
|
||
[](https://opensource.org/licenses/MIT)
|
||
[](https://claude.ai/code)
|
||
|
||
</div>
|
||
|
||
Claude Code 编排 Codex + Gemini 的多模型协作开发系统。前端任务路由至 Gemini，后端任务路由至 Codex，Claude 负责编排决策和代码审核。
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
npx ccg-workflow
|
||
```
|
||
|
||
**要求**：Claude Code CLI、Node.js 18+
|
||
|
||
**可选**：Codex CLI（后端）、Gemini CLI（前端）
|
||
|
||
## 命令
|
||
|
||
| 命令 | 说明 |
|
||
|------|------|
|
||
| `/ccg:workflow` | 6 阶段完整工作流 |
|
||
| `/ccg:feat` | 新功能开发 |
|
||
| `/ccg:frontend` | 前端任务 (Gemini) |
|
||
| `/ccg:backend` | 后端任务 (Codex) |
|
||
| `/ccg:analyze` | 技术分析 |
|
||
| `/ccg:debug` | 问题诊断 |
|
||
| `/ccg:optimize` | 性能优化 |
|
||
| `/ccg:test` | 测试生成 |
|
||
| `/ccg:review` | 代码审查 |
|
||
| `/ccg:commit` | Git 提交 |
|
||
| `/ccg:rollback` | Git 回滚 |
|
||
| `/ccg:clean-branches` | 清理分支 |
|
||
| `/ccg:worktree` | Worktree 管理 |
|
||
| `/ccg:init` | 初始化 CLAUDE.md |
|
||
| `/ccg:enhance` | Prompt 增强 |
|
||
|
||
## 配置
|
||
|
||
### 目录结构
|
||
|
||
```
|
||
~/.claude/
|
||
├── commands/ccg/ # 斜杠命令
|
||
├── agents/ccg/ # 子智能体
|
||
├── bin/codeagent-wrapper
|
||
└── .ccg/
|
||
├── config.toml
|
||
└── prompts/{codex,gemini}/
|
||
```
|
||
|
||
### 环境变量
|
||
|
||
| 变量 | 说明 | 默认值 |
|
||
|------|------|--------|
|
||
| `CODEAGENT_POST_MESSAGE_DELAY` | Codex 完成后等待时间（秒） | 5 |
|
||
| `CODEX_TIMEOUT` | codeagent-wrapper 执行超时（秒） | 7200 |
|
||
| `BASH_DEFAULT_TIMEOUT_MS` | Claude Code Bash 默认超时（毫秒） | 120000 |
|
||
| `BASH_MAX_TIMEOUT_MS` | Claude Code Bash 最大超时（毫秒） | 600000 |
|
||
|
||
配置方式（`~/.claude/settings.json`）：
|
||
|
||
```json
|
||
{
|
||
"env": {
|
||
"CODEAGENT_POST_MESSAGE_DELAY": "1",
|
||
"CODEX_TIMEOUT": "7200",
|
||
"BASH_DEFAULT_TIMEOUT_MS": "600000",
|
||
"BASH_MAX_TIMEOUT_MS": "3600000"
|
||
}
|
||
}
|
||
```
|
||
|
||
### MCP 配置
|
||
|
||
ace-tool 用于代码检索和 Prompt 增强，安装时可选配置。
|
||
|
||
Token 获取：https://augmentcode.com/
|
||
|
||
## 更新 / 卸载
|
||
|
||
```bash
|
||
# 更新
|
||
npx ccg-workflow@latest # npx 用户
|
||
npm install -g ccg-workflow@latest # npm 全局用户
|
||
|
||
# 卸载
|
||
npx ccg-workflow # 选择 "卸载工作流"
|
||
npm uninstall -g ccg-workflow # npm 全局用户需额外执行
|
||
```
|
||
|
||
## 已知问题
|
||
|
||
**Codex CLI 0.80.0 进程不退出**
|
||
|
||
`--json` 模式下 Codex 完成输出后进程不会自动退出。
|
||
|
||
解决：设置 `CODEAGENT_POST_MESSAGE_DELAY=1`
|
||
|
||
## 架构
|
||
|
||
```
|
||
Claude Code (编排)
|
||
│
|
||
┌───┴───┐
|
||
↓ ↓
|
||
Codex Gemini
|
||
(后端) (前端)
|
||
│ │
|
||
└───┬───┘
|
||
↓
|
||
Unified Patch
|
||
```
|
||
|
||
外部模型无写入权限，仅返回 Patch，由 Claude 审核后应用。
|
||
|
||
## 致谢
|
||
|
||
- [cexll/myclaude](https://github.com/cexll/myclaude) - codeagent-wrapper
|
||
- [UfoMiao/zcf](https://github.com/UfoMiao/zcf) - Git 工具
|
||
- [GudaStudio/skills](https://github.com/GuDaStudio/skills) - 路由设计
|
||
- [ace-tool](https://linux.do/t/topic/1344562) - MCP 工具
|
||
|
||
## Star History
|
||
|
||
[](https://www.star-history.com/#fengshao1227/ccg-workflow&type=timeline&legend=top-left)
|
||
|
||
## License
|
||
|
||
MIT
|
||
|
||
---
|
||
|
||
v1.7.24 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues)
|