Codex VSCode插件配置开启Ultra模式方法

背景

Codex 是一款广受开发者欢迎的 VSCode 插件，它通过集成大型语言模型提供代码补全、智能对话等功能。近期，Codex 推出了包含更高推理能力的「Ultra 模式」（对应 GPT-5.6 Sol 模型），但许多用户在 VSCode 插件界面上发现无法直接开启该模式。与此同时，社区中流传出通过修改底层配置文件来解锁 Ultra 模式的方法，并在 LINUX DO 论坛上引发了讨论。

核心内容

要启用 Codex 插件的 Ultra 模式，需要直接修改其 TOML 格式的配置文件 config.toml。该文件在不同操作系统中的存放路径如下：

• Linux：~/.codex/config.toml
• Windows：%USERPROFILE%\.codex\config.toml

打开该文件后，添加或修改以下关键配置项：

1. 设置模型推理努力程度为 "ultra"：

   model_reasoning_effort = "ultra"
   

2. 启用多代理（multi‑agent）功能并指定最大并发线程数：

   [features.multi_agent_v2]
   enabled = true
   max_concurrent_threads_per_session = 16
   

需要注意的是，上述 max_concurrent_threads_per_session 参数与另一配置项 agents.max_threads 存在冲突。若同时设置了两个参数，可能导致子代理数量被强制限制（例如上限被锁定为 3），从而无法获得 Ultra 模式的真正并行能力。因此，使用本配置时应避免再设置 agents.max_threads。

该配置方法基于 Codex 从版本 0.142.0 到 0.143.0 的配置项变更，相关讨论亦参考了 LINUX DO 论坛中关于「Codex 子代理上限被强制限制为 3」的帖子。

关键要点

• 配置文件路径：Linux 下为 ~/.codex/config.toml，Windows 下为 %USERPROFILE%\.codex\config.toml。
• 核心参数：model_reasoning_effort = "ultra" 用于激活 Ultra 模式；[features.multi_agent_v2] 下的 enabled = true 和 max_concurrent_threads_per_session = 16 用于开启并控制多代理并发数。
• 冲突警告：max_concurrent_threads_per_session 与 agents.max_threads 不能同时使用，否则会引发子代理上限被不期望地限制。
• 资料来源：本方法来源于 LINUX DO 论坛的实测反馈和 Codex 0.142.0 → 0.143.0 版本的配置变更说明，以及关于子代理上限的专项讨论。

意义与影响

这一配置技巧让用户绕过了 VSCode 插件界面中对 Ultra 模式的可见性限制，直接通过底层配置激活了更强大的推理模型。对于需要高并发代码分析、复杂任务拆解的用户而言，multi_agent_v2 配合 16 个并发线程可以显著提升响应速度和任务处理能力。同时，该案例也揭示了插件配置参数之间的隐性冲突——开发者未来在更新 Codex 时，应更加注意参数间的兼容性，避免用户因配置错误而无法获得预期性能。社区层面的深度挖掘与共享，则进一步增强了 Codex 在高级用户中的可定制性和透明度。