夜雨聆风关注◆ AI一手 ◆探索AI时代的一手实战玩法
关于这个 codex app 接入第三方模型我都写了好几篇文章了，跟着我你总有办法能找到一个接入的办法。
不过这次为什么又写一篇呢？是因为 codex app 官方支持第三方模型了。
所以我这边继续来根据官方支持的写一篇纯手动更改的文章，不需要任何第三方软件。
之前那篇 codex app transfer 有一点小瑕疵，我那篇文章还说了一下。
Codex 桌面版（Codex Desktop）现在官方真的支持接入第三方模型了。OpenAI 在官方文档 Advanced Configuration 里专门加了一节 「Custom model providers」，
原话是：在配置文件里定义 model_providers，指定 base URL 和认证方式，就能把推理请求打到你自己的 API 端点。
看着很简单，但真操作起来有几个坑。我用一个直连 OpenAI 的第三方 API 服务，这个是跟官方的GPT的模型一模一样的。
需要服务的可以进群找我。
然后跑了一遍完整的接入 → 使用 → 切回 GPT 的流程，照着做就行。
第 1 步 找到配置文件
Codex 的配置文件叫 config.toml，默认在用户目录下的 .codex 文件夹里，也就是 ~/.codex/config.toml。
但这里有个坑。如果你之前设过 CODEX_HOME 这个环境变量，配置目录就不在默认位置了。我本机就被改到了 D:\codex，一开始改的 ~/.codex/config.toml 完全不生效，排查了好一会儿才发现。
确认方法很简单，PowerShell 里跑一行命令：
[Environment]::GetEnvironmentVariable('CODEX_HOME','User')有返回值就用那个路径，没有就是默认的 ~/.codex/。
确认好路径之后，在那个目录下找到或新建 config.toml。
第 1 步完成。
第 2 步 写配置文件
打开 config.toml，
把下面这段加进去：
model = "gpt-5.5"model_provider = "ofapp"[model_providers.ofapp]name = "ofapp"base_url = "https://你的API地址/v1"env_key = "OFAPP_API_KEY"wire_api = "responses"解释一下几个关键字段。
model 填你要用的模型名，取决于你的 API 服务商支持哪些模型。
model_provider = "ofapp" 是整个切换的开关。有这一行就走第三方 API，删掉这一行就走官方 GPT。后面来回切换就靠它。ofapp 就是我这边第三方API的名称。
wire_api = "responses" 必须写。Codex 现在只支持 Responses API 格式，不支持 /chat/completions。你的 API 服务商必须支持这个格式才能接上。
env_key 是你的 API Key 对应的环境变量名。写完配置之后，还要把 Key 设到这个环境变量里。PowerShell 里跑一行：
[Environment]::SetEnvironmentVariable('OFAPP_API_KEY','你的key','User')设成用户级的环境变量，这样 App 重启后也能读到。
第 2 步完成。
第 3 步 重启 Codex 桌面版
改完配置，必须完全退出再重新打开。注意，只关窗口不算。要去右下角系统托盘找到 Codex 图标，右键点 「退出」，或者直接在任务管理器里结束所有 Codex 进程。
重新打开 App 之后，点底部的模型选择器看一眼——模型列表变了，显示的是你第三方 API 服务商提供的模型。我这边应该是官方openAI直连，所以模型和官方基本一致的。
推理档位（低 / 中 / 高 / 超高）也能正常选。
第 3 步完成。
第 4 步 发条消息验证
随便发一条，比如 「你好，报一下你是什么模型」。正常收到回复就说明已经接通了，推理走的是你的第三方 API。
并且我用 cursor 帮我验证了下这个codex 到底走的是不是走的真正的第三方模型，确定了是的，到这里，接入就完成了。
第 4 步完成。
第 5 步 切回官方 GPT
想切回你的 ChatGPT / Pro 账号，操作非常简单：打开 config.toml，把 model_provider = "ofapp" 这一行删掉或者注释掉。
其他内容不用动。下面的 [model_providers.ofapp] 段落留着也没关系，只要顶部没有 model_provider 这一行，Codex 就会自动走你的 ChatGPT 登录。
改完同样需要完全退出再重启。
重启后你会看到模型选择器恢复成官方的模型列表，用量也回到你的 Pro 额度。
第 5 步完成。
第 6 步 再切回第三方
想再用第三方？把 model_provider = "ofapp" 加回来，重启就行。
我来回切了几轮，都正常工作。之前的对话记录也不会丢——不管你用哪个 provider 聊的天，数据都存在本地，切换不影响。左侧对话列表里，之前的记录都还在。
有一个地方可以看是否切换第三方了，看设置的地方，没有剩余用量就代表不是官方的了。
第 6 步完成。
踩坑记录
跑完全流程，记一个大坑。
网上有些教程说，想让第三方模型显示在选择器里，要在 provider 配置里加一行 requires_openai_auth = true。
我加了。然后 App 重启后一直卡着打不开。
翻日志一看，满屏 401 Unauthorized: Your authentication token has been invalidated。这行配置会让 App 把你的 ChatGPT 登录凭证用到不该用的地方，OpenAI 那边直接把你的登录态注销了。
自救方法：结束所有 Codex 进程，把配置里的 requires_openai_auth 删掉，把配置目录下的 auth.json 移走，重开 App 重新登录 ChatGPT。登录态会恢复，历史记录不受影响。
所以这行不要加。 只要你的 API 服务商提供了模型列表接口，Codex 选择器就能自动拉到，根本不需要这个配置。
总结
四句话。
接入，在 config.toml 里加一个 provider 段，写上 API 地址和 Key，顶部加一行 model_provider，重启。
切回，把 model_provider 那一行删掉，重启。就这一行的事。
记录，来回切不丢历史，数据都在本地。
避坑，别加 requires_openai_auth = true，会让你账号被注销、App 卡死。
觉得有用,点赞、在看、转发三连,让更多想切换第三方模型的朋友看到。
我们下篇见。
