deploy-dual-ai

一键部署 Claude Code + Codex 双AI协作开发环境。

这是什么

在任意项目目录下一键生成双AI协作所需的全部配置文件（.mcp.json、CLAUDE.md、AGENTS.md、standard-workflow 命令），支持两种协作模式：

模式	主AI	辅助AI	适用场景
claude-lead	Claude Code	Codex (GPT-5)	Claude 规划+编码，Codex 分析+审查
codex-lead	Codex (GPT-5)	Claude Code	Codex 规划+编码，Claude 协调+执行本地命令

前置条件

• Claude Code 已安装
• Codex CLI 已安装，且 codex mcp-server 可用
• Codex 已配置好 API（~/.codex/config.toml）

快速开始

git clone https://github.com/LaugHan/deploy-dual-ai.git
cd deploy-dual-ai

# Claude 主导模式（默认）
bash deploy.sh /path/to/your/project

# Codex 主导模式
bash deploy.sh /path/to/your/project codex-lead

部署后验证

cd /path/to/your/project
claude                    # 启动 Claude Code
/mcp list                 # 确认 codex server 状态为 connected
/standard-workflow 测试   # 触发双AI协作流程

生成的文件

your-project/
├── .mcp.json                          # Codex MCP Server 注册
├── CLAUDE.md                          # Claude Code 开发准则与协作规则
├── AGENTS.md                          # Codex 操作手册与职责定义
└── .claude/
    └── commands/
        └── standard-workflow.md       # /standard-workflow 快捷命令

协作架构

Claude 主导模式 (claude-lead)

用户 → Claude Code（规划+编码） → Codex MCP（分析+审查）
                ↓                         ↓
          直接写代码              .claude/context-*.json
          运行测试               .claude/review-report.md

Codex 主导模式 (codex-lead)

用户 → Claude Code（协调） → Codex MCP（规划+编码+审查）
              ↓                        ↓
        转发任务/执行本地命令     直接写代码+审查
        运行测试/报告进度       .claude/review-report.md

关键设计决策

MCP 非流式拆分：MCP 协议不支持流式输出，单次调用中断会丢失全部内容。因此强制要求每次 Codex 调用只做一件事（prompt ≤500字，代码 ≤200行）。

conversationId 机制：通过 [TASK_MARKER] + [CONVERSATION_ID] 实现 Codex 多轮会话，避免每次调用都丢失上下文。

路径隔离：所有工作文件写入项目本地 .claude/ 目录，不污染全局 ~/.claude/。

自定义

编辑 deploy.sh 顶部的配置区：

# 修改 codex 二进制路径
CODEX_BIN="/your/path/to/codex"

如需更精细的规则定制，部署后直接编辑项目下的 CLAUDE.md 和 AGENTS.md。

致谢

灵感来源：linux.do 双AI协作帖 的 CLAUDE.md + AGENTS.md 协作框架。

License

MIT