Codex 子代理怎么并行？任务拆分、角色配置与结果验收指南

适用人群：任务能拆开，但主线容易被日志淹没

本文适合需要同时探索多个模块、检查不同风险、运行多组测试或整理多来源资料的开发者。若任务只有一个文件、一个明确修改点，单代理通常更简单；若多个步骤彼此依赖，也不应为了看起来更快而强行并行。

核验日期为 2026 年 9 月 9 日。OpenAI 当前说明，ChatGPT Work 与 Codex 可以启动专业化子代理并在主线程汇总结果；本地 Codex 客户端还可配置不同模型与说明。子代理会各自进行模型和工具工作，因此通常比同等的单代理流程消耗更多 Token。

第一原则：按独立结果拆分，不按人数拆分

一个好的工作包可以独立完成，并能用简短证据交付。例如“梳理认证模块的调用链”“运行支付相关测试并记录失败”“只检查本次差异中的权限风险”彼此边界清楚。相反，“你也看一遍整个仓库”会让多个代理重复读取、重复下结论。

官方建议先从读取较多的工作开始并行，例如探索、测试、分诊和摘要；多个代理同时大量写代码更容易造成冲突。需要改动时，可以先并行研究，再由一个负责人实施，或者为确实独立的目录分配不同工作区。

主代理与子代理分别负责什么

主代理应保留需求、约束和最终决定：先拆任务，分配边界，跟踪阻塞，等待必要结果，解决冲突并完成验收。子代理只负责被分配的范围，返回压缩后的结论、证据和未决问题，不把整段终端日志原样塞回主线程。

这个分层能减少主对话的噪声，但并不会自动保证正确。主代理仍要确认子代理检查的是同一提交、同一环境和同一目标。若其中一个结果来自旧代码，汇总得再整齐也不能作为最终证据。

• 主代理：定义共同目标、禁止事项、输入版本和验收标准。
• 研究代理：返回关键文件、调用关系与不确定点，不直接大范围修改。
• 测试代理：记录命令、环境、通过与失败项，以及是否可复现。
• 审查代理：按风险类型列出文件位置、影响和建议优先级。
• 实施代理：只在获分配的目录或工作区写入，并说明实际差异。

一条可复用的并行任务提示怎么写

直接说明要启动几个角色、每个角色的范围、是否等待全部完成，以及主线程最终如何汇总。官方文档给出的思路是让安全、测试和可维护性等角色分别审查，等待三者结束后再按类别合并。你可以根据项目改成模块、平台或证据类型。

示例结构可以写成：“请并行启动三个子代理。A 只追踪登录调用链；B 只运行认证测试并记录命令；C 只检查本次差异的权限风险。三者都不得修改文件。等待全部完成后，按已确认事实、冲突结论、待验证项汇总，并标注文件路径。”

并行写代码时，怎样避免互相覆盖

最稳妥的办法仍是减少同时写同一片代码。如果确实要并行实施，先按目录、组件或独立提交划分所有权，并确认接口契约不在多个工作包里同时变化。每个代理提交前都要说明修改文件和依赖的基准版本。

Git Worktree 可以为不同修改提供隔离工作目录，但它解决的是文件与分支隔离，不会自动解决架构冲突。合并前仍要检查公共接口、迁移顺序和测试覆盖。相关操作可阅读Codex 与 Git Worktree 并行开发实践。

• 不要让两个代理同时编辑同一个配置文件或数据库迁移。
• 共享接口先确定契约，再分配独立实现。
• 每个结果注明基准提交，避免在旧版本上继续工作。
• 合并时由一个负责人重新运行关联测试。
• 冲突无法自动判断时，保留双方证据并明确交给人工决定。

成本与速度：更多代理不一定更快

子代理需要分别读取上下文、调用工具和生成结果，所以会增加 Token 与协调成本。任务太小、输入高度重叠或必须按顺序完成时，并行可能比单线程更慢。开始前先估算能否真正同时进行，以及汇总工作是否小于节省的等待时间。

一个实用起点是两到三个子代理，并限制每个角色的输入和输出。先在一次可计时的真实任务上比较：单代理耗时、子代理总耗时、Token 使用、重复发现、最终缺陷。只有质量或速度明显改善，才把该拆分方式写进团队规则或 Skill。

主线程最终验收：不能只拼接摘要

主代理需要识别重复、矛盾和遗漏。先确认所有结果针对同一版本，再把发现按影响合并；同一问题只保留一条主记录，并附上不同代理的证据。若两个结果冲突，重新检查原文件或运行最小验证，不要用多数投票替代事实。

完成标准应包含差异检查、必要测试、失败说明和回滚方式。对发布或生产变更，还要确认目标系统状态，而不是只看命令返回成功。可配合Codex 工程工作流建立统一交付格式。

• 版本一致：所有代理基于同一提交或明确说明差异。
• 证据可复查：结论附文件路径、命令或可观察结果。
• 冲突已处理：不一致项已经验证或明确留待决定。
• 测试有效：测试覆盖本次变更，而不是只运行无关全量命令。
• 最终输出精简：保留决定、风险和下一步，不复制全部日志。

风险提示与结论

不要把访问令牌、生产数据或完整客户资料复制给多个子代理来换取速度。每个角色只获得完成任务所需的最小范围；涉及外部写入、删除、付款或发布时，仍应遵守明确授权和审批边界。子代理卡住时应返回阻塞原因，不能自行扩大权限。

有效并行的顺序是：判断是否可独立 → 按结果拆工作包 → 给每个角色明确权限与输出 → 等待必要结果 → 主线程去重、验证和验收。更多 Codex 技术内容可从 GPTUPCN 首页查看。本站为第三方中文信息与服务入口，非 OpenAI 官方；子代理可用性、界面和账号范围以当前客户端及官方说明为准，ChatGPT Plus、ChatGPT Pro 会员充值或续费不代表固定的代理数量、速度或 Token 消耗。