Codex: Codex 子代理
最后更新：2026-08-31
子代理让 Codex 能够将复杂任务拆解并委派给专门的代理并行执行，大幅提升效率。
📋 前置知识：了解 Codex 工作流模式与 Agent Skills
1. 你将学到
- 子代理概念与工作原理
- 任务委派策略
- 并行执行与协调
- 子代理 vs 单代理
2. 什么是子代理
子代理是主 Codex Agent 创建的辅助代理，每个子代理负责一个子任务。
graph TB
A[主 Agent] --> B[子代理 1: 前端]
A --> C[子代理 2: 后端]
A --> D[子代理 3: 测试]
B --> B1[修改 UI 组件]
C --> C1[添加 API 端点]
D --> D1[编写测试用例]
B1 --> E[主 Agent 汇总]
C1 --> E
D1 --> E
| 特性 | 说明 |
|---|---|
| 独立运行 | 每个子代理独立沙箱 |
| 并行执行 | 多个子代理同时运行 |
| 自动协调 | 主 Agent 汇总结果 |
| 专业分工 | 每个子代理可使用不同 Skill |
3. 使用场景
(1) 多模块并行开发
TEXT
📖 仅展示
> 为电商网站添加商品评论功能：
> - 前端：评论组件 + 评论列表 + 评分星星
> - 后端：评论 API + 评分聚合
> - 测试：前后端测试
# Codex 自动拆解为子代理：
# Subagent 1: 前端组件开发
# Subagent 2: 后端 API 开发
# Subagent 3: 测试编写
# 三个子代理并行执行
(2) 多语言同步
TEXT
📖 仅展示
> 将 README.md 翻译为日语、葡萄牙语和阿拉伯语
# Codex 创建三个子代理并行翻译
# Subagent 1: zh → ja
# Subagent 2: zh → pt-br
# Subagent 3: zh → ar
▶ 示例 1: Alice 的多模块开发
TEXT
📖 仅展示
# Alice 添加完整的支付功能
> 添加 Stripe 支付：
> 1. 支付页面 UI
> 2. 支付 API 端点
> 3. Webhook 处理
> 4. 订单管理
> 5. 所有模块的测试
# Codex 拆解为 4 个子代理：
🔄 Subagent 1: 支付页面 UI + 订单管理页面
🔄 Subagent 2: 支付 API + Webhook 端点
🔄 Subagent 3: 订单模型 + 数据库迁移
🔄 Subagent 4: 集成测试
# 并行执行，总时间约 15 分钟
# 串行执行需要约 50 分钟
4. 任务委派策略
(1) 可并行的条件
| 条件 | 说明 |
|---|---|
| 修改不同文件 | 子代理不操作同一文件 |
| 无数据依赖 | 子代理间不需要共享状态 |
| 独立可验证 | 每个子任务可独立验证 |
(2) 不可并行的情况
| 情况 | 说明 |
|---|---|
| 修改同一文件 | 可能产生冲突 |
| 有顺序依赖 | 后一步需要前一步的结果 |
| 共享数据库 | 可能产生竞争条件 |
(3) 拆解原则
TEXT
📖 仅展示
1. 按功能模块拆解（前端 / 后端 / 测试）
2. 按文件目录拆解（src/auth/ / src/api/ / src/utils/）
3. 按任务类型拆解（实现 / 测试 / 文档）
4. 确保每个子任务边界清晰
5. 子代理协调
(1) 自动协调
主 Agent 自动管理子代理的生命周期：
TEXT
📖 仅展示
1. 分析任务，拆解为子任务
2. 为每个子任务创建子代理
3. 分配独立沙箱环境
4. 监控执行进度
5. 汇总结果，处理冲突
6. 执行集成验证
(2) 结果合并
TEXT
📖 仅展示
# 子代理完成后，主 Agent 合并结果：
✅ Subagent 1: 前端组件完成（3 文件）
✅ Subagent 2: 后端 API 完成（2 文件）
✅ Subagent 3: 测试完成（4 文件）
# 主 Agent 执行集成测试
→ Running integration tests...
→ All 15 tests passed ✓
# 处理冲突（如有）
→ No conflicts detected
→ Ready for review
6. 子代理 vs 单代理
| 维度 | 子代理 | 单 Agent |
|---|---|---|
| 执行速度 | 快（并行） | 慢（串行） |
| 资源消耗 | 高（多沙箱） | 低（单沙箱） |
| 协调复杂度 | 高 | 低 |
| 冲突风险 | 有 | 无 |
| 适用场景 | 独立子任务 | 有依赖的任务 |
❓ 常见问题
Q 子代理会自动创建吗？
A 在 App/Web 版本中，Codex 会根据任务复杂度自动创建子代理。CLI 中需要显式指定或通过 Skills 触发。
Q 子代理数量有限制吗？
A 取决于订阅计划。Free 最多 1 个，Plus 最多 3 个，Pro 最多 10 个，Business 最多 20 个。
Q 子代理之间如何通信？
A 子代理通过主 Agent 协调，不直接通信。主 Agent 收集结果后决定后续步骤。
Q 子代理失败会影响其他代理吗？
A 不会。每个子代理独立运行，单个失败不影响其他。主 Agent 会处理失败的子任务。
Q 如何手动创建子代理？
A 在 Prompt 中明确拆解任务，Codex 会识别并创建子代理。也可以使用 Skills 定义子代理工作流。
📖 小节
- 子代理是主 Agent 创建的辅助代理，独立运行
- 适用场景：多模块并行、多语言翻译、批量处理
- 拆解原则：按模块/目录/类型，确保边界清晰
- 主 Agent 自动协调、汇总结果、处理冲突
- 并行提速但增加资源消耗和冲突风险
📝 作业
- 基础题（难度⭐）：让 Codex 自动拆解一个中等复杂度任务为子代理执行。
- 进阶题（难度⭐⭐）：设计一个多模块功能，确保各模块可并行开发，观察子代理执行过程。
- 挑战题（难度⭐⭐⭐）：对比同一任务用单 Agent 串行和子代理并行的效率差异，写一份性能报告。
