Subagent 工作流

Subagent（子 Agent）工作流允许 Codex 通过生成并行的子 Agent 来处理复杂任务，每个 Agent 专注于不同方面。

工作原理

Codex 负责跨 Agent 的编排，包括生成新子 Agent、路由后续指令、等待结果和关闭 Agent 线程。

当多个 Agent 同时运行时，Codex 等待所有请求的结果都可用，然后返回汇总的响应。

Codex 只在你明确要求时才会生成新 Agent。

使用示例

从以下角度审查当前 PR（相比 main 分支）：
1. 安全问题
2. 代码质量
3. Bug
4. 竞态条件
5. 测试稳定性
每个角度启动一个 Agent，等待所有结果后汇总。

管理子 Agent

• 在 CLI 中使用 /agent 切换和查看 Agent 线程
• 直接告知 Codex 可停止某个 Agent 或关闭已完成线程

配置

[agents]
max_threads = 6       # 最大并发线程数（默认 6）
max_depth = 1         # Agent 嵌套深度（默认 1）
job_max_runtime_seconds = 1800  # 每个任务超时时间

自定义 Agent

在 ~/.codex/agents/ 或 .codex/agents/ 目录下创建 TOML 文件，定义：

• name：Agent 名称
• description：用途说明
• developer_instructions：核心指令