Codex 的多智能体协作适合把互不依赖的代码库调查分开做：一个子智能体查调用路径，另一个查测试缺口，主任务再汇总证据。开始时不必先创建自定义角色；当前本地 Codex 版本默认支持子智能体，直接在任务中明确要求分工即可。要固定角色或限制并发时，再配置项目级或用户级设置。
先用内置子智能体完成一次只读排查
在已有 Git 项目中打开 Codex，输入这段示例指令：
请用两个子智能体并行排查当前项目的登录失败问题。
第一个只读追踪登录请求从入口到服务层的路径；第二个只读找相关测试和缺口。
各自列出文件路径、函数或测试名、可复现证据；主任务最后合并结论。
不要修改文件，不要声称未运行的测试已经通过。这次任务的可核对结果不是“已修复”，而是两个分工结论能指向真实文件和测试。CLI 用户可用 /agent查看和切换子智能体线程；桌面端可从子智能体活动查看细节。OpenAI 子智能体文档说明了这些入口、默认内置角色和主任务汇总方式。
需要固定角色时怎样配置
项目团队可在仓库的 .codex/agents/创建一个独立的 TOML 文件，例如 .codex/agents/login_explorer.toml。下面只是可改写的配置示例，并非已在你的项目运行：
name = "login_explorer"
description = "只读检查登录调用路径与边界"
developer_instructions = "只读查找入口、鉴权中间件和服务调用。给出文件路径与证据，不修改代码。"官方文档要求自定义代理至少写明 name、description和 developer_instructions。个人通用角色放在 ~/.codex/agents/，只对当前项目生效的角色放在 .codex/agents/。随后在任务里点名让 Codex 使用该角色；若角色不可用，先确认文件位置、TOML 语法及当前客户端是否支持，而不是假定配置已经加载。
若需要限制同时工作的子智能体数量，可在适用范围的 config.toml中使用官方列出的设置：
[agents]
enabled = true
max_concurrent_threads_per_session = 2这个数值是演示用的并发上限，不是官方推荐值。改配置前先查看现有设置，避免覆盖用户已有配置；不熟悉配置时，先使用默认行为即可。
怎样验收协作结果
- 检查每个子智能体是否回答了自己的问题，证据中的路径在仓库里确实存在。
- 检查主任务有没有把两个结论对上同一版本的代码；若存在冲突，让它列出冲突点和待查文件。
- 若下一步是修复，单独给出修改范围、可运行的测试命令和失败时的停止条件；修改后亲自核对 diff 与测试输出。
多智能体会增加模型与工具调用量，且多个写任务同时改同一文件容易产生冲突。本文示例只排查、不做并发写入；没有在你的项目上实测登录问题。子智能体的可用性、权限继承和配置字段以 2026 年 10 月 1 日核对的 官方文档为依据。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/29781.html
