Codex Subagents 适合把彼此独立的调查、测试和审查分给多个子代理，再由主代理汇总。任务有依赖或多人修改同一文件时，增加代理往往增加协调工作。本文给出可直接调整的拆分提示和验收方法，不把设计示例当成提速实测。
当前版本怎样触发子代理
截至 2026 年 10 月 12 日，官方文档说明当前本地 Codex 版本默认启用子代理能力，并在桌面端、CLI 和 IDE 展示活动。实际委派由明确的用户请求或适用的 AGENTS.md、Skill 指令触发；只说“做完这个任务”不等于要求并行。
提示中写明“启动两个子代理”，说明各自范围、是否等齐结果以及汇总格式。看到活动后可以打开子代理线程检查进度，也可以明确要求停止某个分支。旧版本或组织策略可能限制功能，入口缺失时先核对版本与配置，不能靠改任务描述修复加载问题。
用三个问题判断能不能并行
输入是否已确定？子任务是否需要另一分支先产出结论？交付物能否独立验证？三个条件都满足，才值得并行。例如同一提交上的安全审查和测试覆盖审查可各自读取代码；数据库字段尚未确定时，依赖它的 API 和界面实现应等设计完成后再开始。
官方建议先用于代码探索、测试、问题分类和总结等读取较多的任务。测试也可能生成文件或占用端口，分配前仍要说明运行目录和资源边界。涉及共享数据库、同一构建目录或限流服务的测试不能自动视为互不影响。
一份可直接调整的并行审查提示
在已明确比较基准的仓库中使用以下提示；把 MAIN_REF 替换为实际分支或提交。引用的文件位置必须来自仓库，不能只给泛泛建议。
请针对当前分支与 MAIN_REF 的差异启动两个子代理，等待全部返回后汇总。子代理 A 只审查认证、数据泄露和权限风险；子代理 B 只审查测试遗漏、边界条件和回归风险。两者仅阅读，不修改文件，不提交，不部署。每个发现返回文件路径、位置、触发条件、影响和最小修复建议；没有发现也说明检查范围。遇到缺少比较基准或无法运行必要检查时，返回未完成项，不猜测结果。主代理核对证据、合并重复项，按严重程度输出。
这份提示适合审查，不能直接套到实现任务。若希望子代理修改代码，还要另写允许修改的文件、验收命令和合并负责人。
实现任务怎样分配文件所有权
假设新增一个表单：主代理先确定接口和字段；A 只修改表单组件；B 只修改对应测试文件。共享类型、依赖清单和路由配置由主代理维护。两分支需要修改同一共享文件时，先报告需求，由负责人集中处理。这个分工是示例，不代表特定项目已经测试成功。
一个文件指定一个写入者，其他代理可以读取和提建议。不同 worktree 能隔离工作目录，但仍可能产生合并冲突，也不会隔离共享数据库或外部服务。最终合并后必须跑整体检查，不能把两个局部通过拼成整体通过。
主代理怎样收回并验收
要求每个子代理返回已检查范围、发现与证据、实际修改、检查结果和未完成项。主代理核对来源和文件位置，处理相互矛盾的结论，再检查跨模块影响。若测试失败，说明是原有失败、环境限制还是新修改引入的问题。
子代理交付“完成”后仍可能需要追问；不要把它的总结直接当作测试记录。关键断言应有来源、命令结果或明确的代码路径。
并发数量与成本怎么判断
每个子代理都会消耗模型与工具资源，官方指出其 Token 用量高于可比的单代理运行。先从两个独立分支开始，记录从派发到汇总的总时间、主代理返工、重复工作和用量，再与同类串行任务比较。没有统一任务和记录，不能推断“开四个快四倍”。
若团队通过第三方 API 使用多个模型，可在 AICodeWith 查看相应请求记录；这属于模型接入和用量管理，不会替代任务拆分，也不会避免文件冲突。
可用同一条记录模板保存每次评估：仓库提交、任务与验收命令、并行分支和写入路径、开始/汇总时间、用量、重复发现、合并冲突、人工修订和最终检查结果。先用相同提交上的同类任务建立串行参照，再评估并行收益；以下是记录结构，不是实测结果。
任务 / 基准提交：
执行方式：串行或并行；子代理数量：
完成耗时 / 用量：
重复工作 / 冲突 / 人工修订：
最终验收命令与结果：
AICodeWith 请求记录只能辅助核对模型用量，不能自动判断哪个子任务有效或把共享 Key 的所有请求归因于一个分支。需要归因时，结合任务时间、独立测试 Key 和本地任务记录比对；不把用量下降直接写成任务质量提高。
常见问题
为什么没有自动开子代理？先明确要求委派，并核对当前客户端和配置；agents.enabled 可以影响可用性。已有可用入口时，再检查任务是否有清楚的独立分支。
子代理写冲突了怎么办？停止继续写入，保留双方改动，由主代理确定合并版本并重新运行相关检查。不要让两个分支反复互相覆盖。
是否必须指定不同模型？不必。官方支持继承父代理设置，也支持自定义代理；先明确任务边界，再按可用模型与工作难度选择，不凭模型名字推断效果。
结论与相关资料
把输入、文件边界和验收写清，再决定是否并行。对同一任务，最终完成时间、返工和成本记录比代理数量更能说明方案是否适用。