Codex 通过修改配置实现20个子代理并发

背景

在 AI 编程助手领域，Codex 是一款备受开发者关注的工具，其核心能力之一是通过子 agent（subagent）并发执行多个任务，从而提升代码生成、调试或重构的效率。然而，官方默认的子 agent 并发上限仅为 6，对于一些需要大幅并行处理复杂项目的用户来说，这个限制可能成为瓶颈。最近，LINUX DO 社区的一位用户分享了一个简单而有效的技巧：通过修改 Codex 的本地配置文件 config.toml，可以手动提高并发线程数，甚至直接调整为 20，从而让 Codex 一次性「召唤」最多 20 个子 agent。

核心内容

该技巧的核心是编辑 Codex 的配置文件 config.toml，修改或添加一个名为 max_threads 的配置项。具体操作步骤如下：

1. 定位配置文件：配置文件通常位于用户主目录下的 .codex/config.toml（即 ~/.codex/config.toml）。
2. 修改配置项：用文本编辑器打开 config.toml，在文件末尾或已有 [agents] 节中添加以下内容：

   [agents]
   max_threads = 10
   

   如果文件中已经存在 [agents] 节（可能包含其他配置），不要重复写入第二个 [agents]，只需在该节内部添加一行 max_threads = 10（或期望的数值）即可。
3. 调整上限：想尝试更高的并发数，例如 20，只需将数值改为 20：

   [agents]
   max_threads = 20
   

4. 使修改生效：修改完配置文件后，必须完全退出 Codex 应用程序（在 macOS 上使用 Cmd + Q 彻底退出），然后重新打开 Codex。旧 thread 会沿用之前的配置（无法热加载），需要新建一个 thread 来测试新的并发上限效果。

关键要点

• 官方默认的并发上限为 6，该改动用 max_threads 配置项直接覆盖此限制。
• 配置文件路径固定为 ~/.codex/config.toml，修改前建议先备份原文件。
• [agents] 节只能出现一次；若已有该节，只在其中追加 max_threads 一行，不要重复写 [agents] 头部。
• 修改后必须完全退出 Codex 进程（包括强制退出），再重启应用，否则新配置不会生效。
• 旧 thread 无法动态加载新配置，只有新创建的 thread 才会使用调整后的并发数。
• 该技巧已知可在 Linux、macOS 等系统上使用，Windows 路径可能类似（需用户自行确认 ~/.codex 对应位置）。

意义与影响

这一发现对重度使用 Codex 的开发者有直接价值：通过简单修改一个数值，就能将并发子 agent 数量从 6 提升到 10 甚至 20，显著加快并行任务处理速度。在实际工作流中，例如同时生成多个函数、批量重构代码文件或处理大型 monorepo 项目时，更高的并发意味着更短的等待时间和更高的吞吐量。

此外，该技巧反映了 Codex 的本地配置文件具有高度可定制性——官方虽未在 UI 中直接暴露并发调节选项，但底层配置留给用户一定控制空间。这也提醒开发者关注本地配置文件中的其他潜在可调参数（如内存限制、缓存行为等），可能进一步优化使用体验。不过，过高的并发数可能加剧系统资源消耗（CPU、内存），用户需根据自己机器性能进行合理调整。