Claudecode Codex Subagents

Codex Subagents - Claude Code Plugin

中文 | English

通过并行委托多个 Codex 代理来编排复杂任务，然后合并和审查结果的 Claude Code 插件。

功能特点

- 🚀 并行处理: 将复杂任务分解为可并行执行的单元（每批最多3个代理）
- 🔗 链式处理: 超过3个任务时自动进行链式批量处理
- 📊 实时进度: 使用 TodoWrite 实时显示任务执行进度
- 📝 详细日志: 所有子代理活动记录到 .codex-temp/[时间戳]/ 目录
- 🤖 智能委托: 通过 MCP 服务器自动委托给多个 Codex 子代理
- 🔄 智能合并: 自动检测冲突并应用最佳合并策略
- ✅ 质量验证: 包含编译、测试、代码质量等多重验证关卡

快速安装

方式 1：一键安装脚本（推荐）

适合：首次使用，希望全自动安装

安装脚本会自动完成：
- ✅ 检测并自动安装缺失的依赖（Python 3, uv, Codex CLI）
- ✅ 安装 Plugin 到 ~/.claude/plugins/
- ✅ 复制命令到 ~/.claude/commands/ 以确保直接可用
- ✅ 配置 MCP 服务器（无需手动安装）
- ✅ 自动安装中英文双版本命令
- ✅ 验证安装完整性

方式 2：通过 Claude Code Plugin 系统安装

适合：熟悉 Claude Code plugin 系统，希望使用 plugin 管理

步骤 1：添加 Plugin Marketplace

在 Claude Code 中运行：

在 ~/.claude/settings.json 中添加：

步骤 2：安装 Plugin

步骤 3：配置 MCP 服务器

手动在 ~/.claude/mcp_settings.json 中添加：

步骤 4：重启 Claude Code

步骤 5：验证安装

方式对比

前置要求：
- Python 3 (macOS 通常自带，脚本会自动检测)
- uv (脚本会提示并自动安装)
- Codex CLI >= 0.46.0 (脚本会提示并自动安装)
- Claude Code CLI
💡 提示: 如果缺少依赖，安装脚本会自动检测并询问是否安装，无需手动准备！

安装完成后，重启 Claude Code 即可使用。

使用方法

基本用法

示例

示例 1: 创建 React 组件

示例 2: 重构代码

示例 3: 添加功能

工作流程

1. 任务分析 (30秒): 理解任务范围和依赖关系
2. 任务分解 (1分钟): 将任务拆分为并行单元（每批最多3个）
3. 初始化日志: 创建 .codex-temp/[timestamp]/ 目录用于记录
4. 设置进度跟踪: 使用 TodoWrite 创建任务列表
5. 链式执行:
   - 如果 ≤3 个代理：直接并行执行
   - 如果 >3 个代理：分批链式执行（每批3个）
6. 实时进度更新: 每批完成后更新 TodoWrite 并向用户报告
7. 详细日志记录: 每个代理的输出记录到独立的日志文件
8. 收集结果: 解析每个代理的输出并检测冲突
9. 应用合并策略:
   - 直接合并: 无冲突时
   - 顺序集成: 有依赖关系时
   - 冲突解决: 有重叠更改时
   - 增量验证: 高风险时
10. 质量验证: 运行编译、lint、类型检查和测试
11. 生成报告: 提供全面的执行报告（包含日志目录路径）

任务分解策略

基于文件 (File-Based)
独立文件 → 每组文件一个代理

基于功能 (Feature-Based)
完整功能 → 每个功能一个代理

基于分层 (Layer-Based)
架构层 → 每层一个代理

链式处理与日志记录

批量处理策略
当任务需要超过3个代理时，系统会自动启用链式处理：

示例：7个代理的任务

日志目录结构

日志内容格式
每个日志文件包含：
- 代理任务描述
- 完整的提示词
- 代理输出内容
- 修改的文件列表
- 执行状态和时长
- 错误信息（如有）

进度跟踪
使用 TodoWrite 实时显示：
- 当前批次执行状态
-…