Codex App自定义模型教程：本地Sub2API中转接入GPT 5.6 Sol

背景

随着 AI 编程助手 Codex App 的普及，许多用户希望突破官方订阅模型的限制，通过本地中转服务接入更强大的模型（如 GPT 5.6 Sol）。Sub2API 是一款可以将订阅 API 转换为本地兼容接口的工具，允许用户自定义模型提供商。然而，实际配置过程中常出现“表面成功、实际未生效”的问题——例如配置了 GPT 5.6 Sol，重启后却仍然走官方订阅链路。本文基于 LINUX DO 论坛的一篇教程，系统梳理了从部署 Sub2API 到在 Codex App 中成功启用自定义模型的全流程，重点解决了“切换不生效”的痛点。

核心内容

教程面向新手，完整拆解了以下步骤：

1. 部署 Sub2API
   下载并运行 Sub2API 服务，确保其能正常启动并监听本地端口（通常为 localhost:XXXX）。作者强调先确认 Sub2API 自身健康状态，例如通过访问其健康检查端点或查看日志是否无报错。

2. 配置 Codex App 的自定义模型
   在 Codex App 的设置中，需要将 model 和 review_model 两个参数均设置为 gpt-5.6-sol。同时，必须将 model_provider 从默认的官方提供商切换为本地 provider（即指向 Sub2API 的地址）。

3. 关键验证方法

   • 配置完成后，彻底退出 Codex App（而非仅关闭窗口），再重新启动。
   • 启动后，必须打开一个新会话（而非沿用之前的会话）。
   • 如果新会话顶部显示 Custom 标识，不必惊慌——这是正确的自定义模式标志。最终确认方式是在 Sub2API 日志中查看 model 字段：若日志显示的 model 值为 gpt-5.6-sol，则说明自定义链路已生效。

4. 常见失败原因
   很多用户配置后重启仍像官方订阅，问题不在 Sub2API 或 GPT 5.6 Sol 本身，而是 Codex 的 provider 没有真正切过去（例如未彻底退出、未开新会话、或 provider 指向错误）。

5. 重度用户推荐方案
   对于高频使用 Codex 的用户，官方的 5 小时窗口限制容易打断工作流。作者在自家店铺推广了 “BugTeam 账号”，提供 240 美元额度、无 5 小时窗口限制，适合连续运行 GPT 5.6 或 Codex 任务。教程及详细配置思路已发布在 X 文章中，建议收藏按步骤操作。

关键要点

• 部署 Sub2API 后务必先验证自身健康，否则后续排查困难。
• model 和 review_model 必须同时设置为 gpt-5.6-sol，缺一不可。
• model_provider 必须强制切换为本地 provider，默认官方 provider 不会自动生效。
• 修改配置后必须彻底退出 Codex（杀掉进程），而非仅最小化或关闭窗口。
• 重启后必须创建全新会话，旧会话可能缓存了之前的 provider 设置。
• 新会话显示 Custom 是正常现象，不要误以为失败。
• 唯一可靠验证方式：查看 Sub2API 日志中请求的 model 字段是否为 gpt-5.6-sol。
• 若遇到频繁中断，官方 5 小时窗口限制可考虑使用 BugTeam 账号（240 美元额度、无窗口限制）替代。

意义与影响

该教程为 Codex App 用户提供了一条低成本、可复现的自定义模型接入路径，尤其适合需要高并发或长时段使用 GPT 5.6 Sol 的开发者。通过本地 Sub2API 中转，用户不仅能绕开官方模型选择限制，还可灵活切换不同模型来源。此外，文中提及的 BugTeam 账号方案直接回应了重度使用者的痛点——连续工作流不被 5 小时窗口打断。这一配置思路的公开分享，降低了门槛，让更多人能够自行搭建专属的 AI 编程环境，同时也推动了 Sub2API 这类中转工具在社区中的实际应用验证。