Codex 进阶教程：如何拉起一支 AI 团队？Subagents 模式全解析

在 Codex 的最新版本中，最令人兴奋的功能莫过于 Subagents（子智能体） 模式。它不再是让一个 AI 串行地帮你干活，而是允许你“一句话拉起一支团队”，让多个子智能体在相互隔离的沙箱中并行处理复杂的工程任务。

如果你还在纠结设置里找不到“开关”，那是因为 Subagents 的逻辑已经从“手动开启”进化到了“按需配置与指令触发”。

1. 核心配置：在 config.toml 中调优

Subagents 在 v26.x 版本中默认已内置，但要发挥其最大威力，你需要根据硬件和 Token 预算在 ~/.codex/config.toml 中进行微调：

1
2
3
4
5
6
7
8
9
10
11
12
[agents]
# 最大并行线程数（建议设置在 4-8 之间）
max_threads = 6

# 嵌套深度（1 表示主智能体可以派生子智能体，建议保持为 1 以防递归爆炸）
max_depth = 1

# 子智能体的默认推理强度 (low, medium, high, xhigh)
default_reasoning_effort = "high"

# 自动审批模式 (manual: 需手动确认, notify: 执行并通知, full-auto: 完全自动)
approval_mode = "notify"

2. 如何触发 Subagents？（Prompt 语法）

Subagents 并不会自发启动，它们需要你的明确授权。以下是几种高效的触发姿势：

  • 并行任务拆解：

    “请重构当前项目的 Auth 模块。派生 (Spawn) 三个子智能体：一个负责代码逻辑，一个负责编写单元测试，一个进行安全审计。完成后汇总报告。”

  • 角色化委派：

    “让 explorer 智能体去分析项目结构，同时让 coder 智能体开始修复 Issue #12。”

  • 批量处理 (CSV 模式)：

    “调用 spawn_agents_on_csv 工具，根据 tasks.csv 中的列表并行处理 10 个文件的代码审查。”

3. 管理你的“AI 团队”

当多个 Agent 同时在后台“卷”起来时，你可以通过以下方式掌控全局：

  • CLI 命令 /agent：在终端输入此命令，可以列出所有活跃的 Agent 线程及其状态。
  • 切换焦点：使用 /agent <名称> 可以跳转到特定子智能体的对话上下文，查看它的详细日志或给予直接指导。
  • 审批流：在交互模式下，如果某个子智能体需要执行敏感操作，界面会弹出提示。按下 o 键可以打开该智能体的专属线程进行审核。

4. 为什么要用 Subagents？ (vs 标准模式)

特性 标准模式 Subagents 模式
执行效率 串行，一次只能干一件事 并行，多项任务同步进行
上下文质量 易受无关干扰 (Context Rot) 隔离，每个 Agent 拥有纯净的任务上下文
专业性 通才，但容易顾此失彼 专才，可以为不同 Agent 定制不同的人格
安全性 共享工作区 沙箱隔离，每个子任务在独立容器运行

总结

Subagents 是 Codex 从“对话机器人”向“自动化工程引擎”进化的标志。它不再需要你在 UI 里点点点，而是通过 config.toml 定规则，通过 Prompt 下指令。

现在，去试着给你的 Codex 下达第一条“团队委派”指令吧！

参考资料：