夜雨聆风关注◆ AI一手 ◆探索AI时代的一手实战玩法
先说一下声明，本文是基于mac的实操教程。切到deepseek没有问题，并且可以正常访问，但是如果切回gpt有一点小问题，所以如果你不打算切回gpt，并且是mac，可以继续看我的文章。我后面会持续死磕codex app切换国产模型系列，继续出windows版本的教程。
力争让大家都能用上codex app加国产模型并且自由切换。因为爆肝时间有限，先发这篇。
这篇文章只解决一个问题。
让你的 Codex 桌面版用上 DeepSeek 等国产大模型,而且插件、computer use 这些功能一个都不少。
对于普通人来说，国产模型是最容易接触到的，并且随着国产大模型的不断快速发展，模型的能力在日常工作任务上都能轻松应对了。比如最近的GLM-5.2的大模型已经和最顶尖的opus4.8模型相接近了。
说点实在的。之前我写过一篇用 cc-switch 给 Codex 桌面版切模型的教程：
后台和评论区一堆人报错;
我又专门补了一篇排错指南：
结果……还是各种新错往外冒。换模型成功的有,但卡住的更多。折腾下来我的结论很简单:cc-switch 这套用在 Codex 桌面版上,坑实在太多。
所以这次我不修修补补了,直接换一套全新的、更省心的方式。最后亲手在 Mac 上把 deepseek-v4-pro 和 deepseek-v4-flash 两个模型都跑通了。
先把这套新方式的好处给你摆出来,看完你就知道值不值得:
省钱:用 DeepSeek 等国产模型,按量计费,比官方 OpenAI 便宜一大截; 不用额外网络工具:DeepSeek 国内直连,普通网络就能聊——这正是 cc-switch 时代一堆人卡死的地方; 功能不残:Codex 的插件、computer use 这些一个都不少; 随时可逆、记录不丢:DeepSeek 和官方 GPT 一键来回切,之前的对话记录一条不少; 桌面版 + 命令行版通吃:改一处配置,App 和终端里的 codex同时生效;比 cc-switch 稳:告别"一换就报错、排错指南都救不过来"的日子。
照着做,3分钟内你也能跑通,而且比 cc-switch 明显更稳。
先赞后看,腰缠万贯~
先搞懂:为什么 Codex 桌面版不能像 Claude Code 那样直接换模型
动手之前,先用 30 秒把认知对齐,不然后面踩坑你都不知道踩在哪。
Claude Code 换模型很简单,改几个环境变量、或者用 cc-switch 点一下就行。但 Codex 桌面版是另一套东西,它有三个"硬骨头":
第一,Codex 桌面版走的是 OpenAI 的 Responses API,而且它的图形界面只认内置的那几个 OpenAI 模型(gpt-5.5 / gpt-5.4 之类),这点其实和不少工具一样——GUI 本来就不负责加第三方模型,真正换模型靠的是下面第二条说的配置。
第二,你可能听说过改 ~/.codex/config.toml、往里加 model_providers。对桌面版没用。 那套 model_providers / wire_api 只对命令行版的 codex 生效,桌面版直接无视。
第三,DeepSeek 这些国产模型走的是 Chat Completions API,跟 Responses 协议根本不兼容。就算你把地址硬填进去,两边也对不上话。
所以你直接填是行不通的。核心矛盾就一句话:Codex 说的是"Responses 语",DeepSeek 说的是"Chat 语",中间缺一个翻译。
这个翻译,就是今天的主角——一个叫 Codex App Transfer 的"桥"。
Part 1 方案选型:为什么用"桥",不用 cc-switch
给 Codex 桌面版换模型,市面上就三种思路,我直接帮你排好雷:
思路一:直接改 config.toml 加 model_providers。 前面说了,桌面版不认,无效。 思路二:cc-switch。 它确实是个好工具(我讲 Claude desktop 时还推荐过),但它本质是帮你改配置文件,Codex 桌面版那套 Responses 协议 + 内置模型限制它处理不干净,所以一换就容易报错——这正是我那篇排错指南都救不全的原因。 思路三:本地网关"桥" Codex App Transfer。 ✅ 这就是我实测跑通、且最稳的方式。
三种方式拉个表,一目了然:
桥到底是怎么把活干成的? 用大白话讲:
它在你电脑本机起一个"网关",地址是 127.0.0.1:18080。然后它做两件事:
把 Codex 发出去的 Responses 请求,翻译成 Chat Completions,转发给 DeepSeek——这就是"翻译"。 而 Codex 那些插件、computer use、账号相关的调用(走 /backend-api),它原样转发回 chatgpt.com——所以你的插件和 computer use 一个都不会少。
一句话:cc-switch 是给你换把锁,桥是给你接了根能同时通两头的"转接线"——模型走 DeepSeek,功能还连着官方。
不是 Codex 不让你用国产模型,是 cc-switch 这根线接错了;换上对的"转接头",一次就通。
Part 2 动手前:先备份,给自己留后路
改任何配置文件前,先备份,这是铁律。
好消息是,这个桥很贴心——它在你点"应用"之前,会自动给 ~/.codex/config.toml 和 auth.json 拍一份快照,还提供一个"还原 Codex 原配置"按钮和"完整性检查"。所以即使你什么都不做,它自己也兜了一层底。
但我还是建议你手动再备份一次,双保险更踏实。Mac 上打开终端,一行命令:
cp ~/.codex/config.toml ~/.codex/config-backup-$(date +%F).toml这样就在原地存了一份带日期的备份,改坏了随时还原:
cp ~/.codex/config-backup-2026-06-16.toml ~/.codex/config.tomlPart 3 安装"桥"Codex App Transfer(Mac)
去 GitHub 仓库 Cmochance/codex-app-transfer 的 Releases 页,
下对应你机器的安装包。Apple 芯片的 Mac 下，最新版本是2.3.4。
Codex-App-Transfer-v<版本>-macOS-arm64.dmg(Intel 芯片选 macOS-x64.dmg。)
下完双击 dmg,把 App 拖进"应用程序"。
🛑 首次打开的小关卡(Gatekeeper):这个软件没做苹果的代码签名,首次打开 macOS 会拦一下,提示"未知开发者"。放行方式分系统版本:
macOS 15 / 26 及以上:苹果把"右键→打开"那个入口去掉了。正确姿势是:先把 App 拖进"应用程序"→ 双击一次让它弹出拦截提示 → 关掉 → 去 系统设置 → 隐私与安全性,拉到最下面点「仍要打开」。macOS 14 及更早:右键 App →「打开」,确认一次即可。
实在嫌麻烦,也可以终端一行清掉隔离属性:
xattr -dr com.apple.quarantine "/Applications/Codex App Transfer.app"Part 4 在桥里填上 DeepSeek
打开 Codex App Transfer,点右上角的「**+**」添加供应商。右侧有一排"快捷预设",直接选 DeepSeek,它会帮你把地址带出来。
然后确认/填三样东西:
提供商名称:DeepSeek(预设已填好) API Base URL: https://api.deepseek.comAPI Key:你自己去 DeepSeek 开放平台创建一个,粘进来 协议类型:选 **OpenAI Chat(Responses ↔ Chat 本地协议转换)**——这就是那个"翻译"
🛑 提前避坑:
Key 一定要填对、别带多余空格; DeepSeek 账户没余额会报 402,先去充一点; Base URL 只填到 https://api.deepseek.com就行,别把/chat/completions这种后缀也粘进去,否则会拼成两段路径导致 404。
Part 5 配多个模型(pro + flash)——这里有个坑注意一下
往下找到「在 Codex 中显示的模型」。这里直接列出你想在 Codex 选择器里看到的模型,最多 5 个,第一个是默认。我配了两个:
deepseek-v4-pro(旗舰,设为默认)deepseek-v4-flash(快、便宜,日常够用)
填好之后,后端会自动把它们映射到 Codex 的槽位(gpt-5.5 / gpt-5.4 …),你不用手动指定槽位,省心。
🛑 核心大坑(我就栽在这):DeepSeek 的模型名区分大小写,必须全小写!
我当时这里被自动补全填成了大写的 Deepseek-v4-flash(首字母 D 大写),结果 flash 怎么都跑不通,报这个错:
supported API model names are deepseek-v4-pro or deepseek-v4-flash,but you passed Deepseek-v4-flash一个大写字母。所以逐字检查,全部小写:deepseek-v4-pro、deepseek-v4-flash。
Part 6 点"启用" + 必须关掉的那个开关(network_proxy)
模型配好,点桥上的「启用 / 应用」。它会做三件事:保存配置 → 把 Codex 的 openai_base_url / chatgpt_base_url 指向本机网关 → 把 Codex 连过来。卡片上出现绿色的「正在应用」就对了。
🛑 关键坑(我当时所有报错的真凶):如果你之前为了访问外面的环境给 Codex 配过网络代理,~/.codex/config.toml 里很可能有这么一段:
[features]network_proxy = true # ← 问题就在这[network_proxy]proxy_url = "http://127.0.0.1:10808"它会把发往本机网关 127.0.0.1:18080 的请求也一并劫走、丢给上游代理——结果就是连不上、发送报错、转发页"总请求"一直是 0。
解决:把 network_proxy 关掉。 改成下面这样:
[features]network_proxy = false # ← 关掉[network_proxy]allow_upstream_proxy = false改完保存。这一步不做,后面发消息百分百报错。
Part 7 重启 Codex,再在 Codex 里切模型
必须重启 Codex 才生效。Codex 是在启动时读取模型清单的;
Cmd+Q 退出 Codex,再打开。重启后,点 Codex 右下角的模型选择器,展开模型列表,这时 deepseek-v4-flash 就能正常选中了,选择器会显示「deepseek-v4-flash 超高」。
Part 8 验证三连:怎么确认"真的在用 DeepSeek"
配完别急着干活,先做三个验证,确认是真通了还是假通了。
验证一:发条消息试水。 随便发一句,比如:
你好,请只回复"收到"两个字。
能正常、快速回个"收到",基本就通了。
验证二:看转发日志(这是铁证)。 回到桥的「转发」页,日志里出现这几行,就说明请求真的以小写 flash 打到了 DeepSeek 并成功返回:
request: POST /responsesmodel alias: gpt-5.4 → deepseek-v4-flashforwarding → https://api.deepseek.com/chat/completionsmodel: deepseek-v4-flash → deepseek-v4-flashupstream status 200看到 api.deepseek.com + 200,收工。
验证三:看计数。 转发页的"总请求/成功"在涨。
🛑 重要提醒:别拿"你是什么模型"去问它。 这些模型经常自称 GPT 或 Claude——一是训练数据里混了别家的料,二是 Codex 还会往里塞自己的系统提示。判断它用没用 DeepSeek,不看它嘴上说什么,看转发日志往哪儿发。
另外说句实在话:桥的作者自己也标注了,DeepSeek 这类供应商"未做长期真机回归测试"(他重点测的是 Kimi、小米)。但这次是我真机实测跑通的,日志为证,放心用;真遇到偶发问题,翻到最后的 FAQ。
番外 ｜ 几个很多人担心、但这套都没问题的点
(都是 cc-switch 时代被问爆的,这套实测没坑)
一、不用额外网络工具,DeepSeek 也连得上。 DeepSeek 模型走的是国内直连(api.deepseek.com),普通网络环境就能聊。我专门测过:把本机的网络环境关掉,DeepSeek 照样正常对话、正常返回。以前用 cc-switch 时,不少朋友卡在"模型连不上、各种报错",这套方案没有这个问题。
二、切模型不丢记录,随时切得回 GPT。 Codex 的对话历史是存在本地的、跟你用哪个模型无关——在 DeepSeek 和 GPT 之间来回切,你之前所有对话都原样还在。想切回官方 GPT 也简单:桥上点「还原 Codex 原配置」,模型就变回 gpt-5.5,完全可逆、不动聊天记录。我实测从 DeepSeek 切回官方 GPT、再重启,所有对话一条没少。
三、命令行版 Codex CLI 也一起搞定。 这套改的是 config.toml 里的网关地址,所以桌面版和命令行版(终端里跑 codex)同时生效。在 CLI 的模型选单里,你会看到 gpt-5.5 / gpt-5.4,但每一行后面都标着「Routed through Codex App Transfer (DeepSeek) as deepseek-v4-pro / deepseek-v4-flash」——别被 gpt 标签骗了,底层跑的就是 DeepSeek。(CLI 还会提示一句 "OpenAI base URL is overridden to 127.0.0.1:18080",那是本机网关地址,正常现象。)
Part 9 Windows 用户怎么办
这个桥官方就是跨平台的——系统托盘、常见问题、打包命令都覆盖 Windows,文档里也给了 Windows 安装包的命名(Codex-App-Transfer-v<版本>-Windows-x64-Setup.exe 推荐版 / .msi 企业版)。装好之后,Windows 上的操作和 Mac 几乎一模一样:填 Key → 配模型(同样全小写)→ 点应用 → 重启 Codex。
结论:Mac 用户照本文跑通没问题;Windows 用户思路一致。
Part 10 踩坑合集 / FAQ(把我踩过的坑一次性给你)
network_proxy = false,重启转发 | ||
deepseek-v4-flash | ||
Cmd+Q 重开 | ||
404 ... /responses | ||
stream disconnected before completion | resp_... 而非 chatcmpl-...,更新桥 | |
关于"完全退出桥":关掉窗口它只是缩到系统托盘继续跑,右键托盘选"退出"才是真的关。
写在最后
这套方案的价值,一句话总结:省钱(用国产模型按量计费)、稳(不靠 cc-switch 那套易错路径)、功能不残(插件 + computer use 全在)。
如果你之前被 cc-switch 切 Codex 模型折磨过,这次真的可以换条路了。
别只收藏,现在就去把那根"转接头"装上——3分钟,你的 Codex 就用上 DeepSeek等国产大模型了。
觉得有用,点赞、在看、转发三连,让更多被报错折磨的朋友看到。
我们下篇见。
