Codex Multi-Agent V2 的 Terra 子代理默认配置

一句话结论

将 Multi-Agent V2 缩小为最多 4 个并发线程、以 Terra 高推理作为子代理默认，并把“何时委托”留给 AGENTS.md/根提示，是一个可复用的额度与容量控制起点。

适用场景

• 适合的任务：Codex CLI 多代理 V2、可并行且有边界的工程子任务。

• 不适合的任务：强依赖共享状态的串行变更、未设置并发/写入隔离的生产任务。

• 适用的模型版本：GPT-5.6 Terra；原帖还说明可按有界任务覆盖模型/推理级别。

• 适用的客户端、Agent 或 API：Codex CLI 0.145.0 及支持 Multi-Agent V2 的版本（原帖引用 Codex Releases）。

• 推荐的推理档位和参数：子代理默认 high；最多 4 个并发；max_depth = 1 仅为 V1 兼容性保留。

可直接使用的内容

原帖公开的是配置意图和字段，不是完整 config.toml。可按当前 Codex 版本映射为以下检查清单：

Multi-Agent V2：启用
暴露每次生成的模型覆盖和推理覆盖
最大并发线程：4
子代理默认模型：GPT-5.6 Terra
子代理默认推理：high
保留中断上下文
max_depth = 1（仅 V1 兼容，不作为 V2 委托深度控制）
委托时由根 Agent/AGENTS.md 决定模型和推理覆盖

使用步骤

1. 在支持 Multi-Agent V2 的 Codex CLI 中启用 V2。

2. 把默认子代理模型设为 Terra、默认 effort 设为 high，并将并发上限设为 4。

3. 不依赖 max_depth 控制 V2 委托深度；在 AGENTS.md 或根提示中写清委托条件。

4. 对有界任务按需覆盖模型/推理级别，并保留中断上下文。

5. 观察额度、失败重试、并发冲突和子任务产物，再调整上限。

适用边界

• 原帖没有公开完整配置文件、硬件、任务集、运行次数或额度消耗，不能声称这组设置是最优解。

• “容量由配置控制、何时委托由指令控制”是作者经验，不是 Codex 官方保证。

• 具体字段名和可用模型应以当前 CLI 版本为准，不要盲目复制不存在的配置键。