乐于分享
好东西不私藏

codex app国内也能畅快使用,接入国产模型(附保姆级实操和避坑教程)

codex app国内也能畅快使用,接入国产模型(附保姆级实操和避坑教程)

关注◆ AI一手 ◆探索AI时代的一手实战玩法

Codex App最近真的非常火,完全有超过 Claude code 的势头,特别是在桌面端做的更加人性化和智能化。

我以前也写过很多关于 codex app windows 的使用教程,不过都是用的内置的 GPT 模型。

OpenAI做的这个桌面端Agent,直接在本地项目里帮你写代码、跑命令、装依赖、修bug,不用复制粘贴,不用来回切窗口,体验确实比在网页里聊天强太多了。

但国内用户想用,卡在一个很现实的问题上,充值Plus不方便,OpenAI的API也不是随便就能连上的。折腾半天,不是支付过不去就是网络不通,眼睁睁看着别人用。

现在这个问题可以解决了。Codex App支持切换模型,你可以把它接到国产大模型上,不充Plus,不用OpenAI的API,一样能用。

这篇教程就帮你把这条路跑通。用CC Switch把Codex的模型切到DeepSeek、Kimi这些国内能直连的服务商,用Codex++把插件功能解锁,以后从Codex++启动就行。

Codex CLI也能用CC Switch切模型,老玩家应该早就在用了。

先赞后看,腰缠万贯~

先说清楚一件事

这不是OpenAI官方说「Codex国内可以直接用了」。

CC Switch和Codex++都是社区做的第三方工具。

它们做的事情是,让你可以把Codex的模型换成国产的,只要那个模型在国内能直连,Codex的请求就不走OpenAI了。

Codex还是那个Codex,界面没变,功能没变,只是干活的模型换了。

1 用CC Switch把Codex App的模型切到国产

CC Switch你可能听说过,之前很多人用它给Claude Code切模型。现在它也支持Codex了。

它干的事情很简单,帮你在Codex和国产模型之间搭一个桥。你在CC Switch里选好模型、填好Key,它会自动帮你改好Codex的配置,中间的格式转换它也帮你处理了,你不需要管。

下面一步一步来。

准备工作

你需要三样东西

第一,装好CC Switch。去 ccswitch.io 下载,Windows、macOS、Linux都有。如果你之前装过CC Switch,必须要升级到v3.16.0才行。

根据你的电脑系统来选择合适的包来升级你的 CC Switch。

Mac选择这个升级。

Windows选择这个重新安装。

Linux根据x86 或者 arm64 类型来升级。

这里避坑提醒一下:

只有 ccswitch.io 和 GitHub farion1231/cc-switch 是官方渠道,其他收费、要登录、要充值的网站可能是假冒。

第二,装好Codex App。去OpenAI官网下载桌面版,装完打开一次再关掉,让它把配置文件夹建好。

第三,准备一个国产模型的API Key。DeepSeek、Kimi、MiniMax、通义千问、硅基流动,随便哪个都行,选你有账号的。API Key一般在服务商的后台 → API管理 → 创建Key那里拿。

我这边用的DeepSeek的API。

第一步,在CC Switch里添加Codex的模型

打开CC Switch,看顶部的标签页,切到「Codex」。

点右上角的加号,添加供应商。

CC Switch内置了20多个预设,DeepSeek、Kimi、MiniMax、智谱GLM、硅基流动、阿里百炼、火山引擎这些都有,不需要你手动填地址。

选一个你要用的,比如DeepSeek。

点进去之后就一件事,把你的API Key填进去,保存。

其他的不用动,预设已经帮你配好了。

第二步,开启路由(必须要做的,很多人失败的原因)

这一步是让CC Switch在你电脑上起一个中间服务,帮Codex和国产模型之间做翻译。不开这个,Codex和国产模型说的「语言」不一样,接不上。

打开CC Switch的设置 → 路由 → 展开本地路由。

打开两个开关

第一个,「路由总开关」,把服务启动起来。

第二个,在「路由启用」里把Codex打开。

开了之后,CC Switch会自动帮你改Codex的配置文件,你的API Key也是CC Switch在管,不会明文暴露在Codex的配置里。

第三步,启用模型,重启Codex

回到CC Switch的Codex供应商列表,点你刚配好的DeepSeek(或者其他模型)右边的「启用」。

然后把Codex App关掉,重新打开。

这一步不能省。Codex启动的时候才会读配置,你改完不重启它还是用的旧的。

重启之后,随便打开一个项目,发一条消息试试。能收到回复,就说明跑通了。

这个我要重点说下切换成功后,codex 的一些看似不正常的现象:
1、插件不可用,后面会用 codex++ 来解决。
2、之前的会话记录没有了,这个比较坑,在切换的时候要考虑一下。
3、查看现在的模型到底是什么模型的时候依然回答gpt5,包括在codex cli命令行里面也是的,不过我验证了下模型确实已经改变成DeepSeek了,造成这种现象的原因是codex软件的系统提示词原因。不影响你的使用。
上面的图都是我验证模型已经更换到DeepSeek,并且我的DeepSeek账单也产生了API费用,所以到这里你的codex已经成功切换国产模型。

想换模型怎么办

回CC Switch,在Codex供应商列表里点另一个的「启用」,然后重启Codex。

但是模型切换后,会有一些非常草蛋的bug,不过在我第二次切换之后,这个问题好像又没了。再切换之前把本地路由先关闭。

设置里面一边是通过API密钥登陆,一边显示的是内置的模型了。

但是实际提问的时候根本没法用。说明切换回原来的内置模型还是有bug。

我把之前ccswitch配置的都去除了,包括DeepSeek模型配置和本地路由都去除了,但是还是不行,我只能求助Claude code来帮我修复了:

我重新登录一下就可以了。

2 用Codex++解锁插件

在开始这节之前我先说明一下,我刚刚第一次切换到DeepSeek的时候,确实出现了API模式下的插件不能用的情况:

但是在我第二次切回到DeepSeek的时候,我的设置里面显示的是我codex账号,然后插件是显示的。

并且我为什么确定我使用插件的时候也是用的DeepSeek的模型,我从几个方面一起验证的。

第一个:我用了一会插件,5个小时额度依然是100%,说明没走gpt5.5。

第二:我让Claude code也帮我排查了下到底用的什么模型。

第三:我的DeepSeek API账单一直在涨。

这个时候我在使用插件的使用是可以正常使用的,如果你也出现这样的情况,那么这一节你就不需要去看了。而如果你是出现我之前的插件不可用的情况,你再去使用下面的方法,不过因为我现在插件已经可以用了,复现不了之前插件不能用的情况,所以这一节就只能作为理论提供给大家,我在这里就不做实操了。

如果你那边显示API Key登录的Codex(不是用ChatGPT账号登录),你会发现插件那个入口是灰的,点进去让你登录ChatGPT。但你本来就是因为登不上ChatGPT才用API Key的,这不就死循环了嘛。

Codex++就是解决这个事的。

Codex++是什么

简单说,它是Codex App的一个增强启动器。

你以后不从原版Codex启动,改从Codex++启动。它会帮你把Codex打开,然后注入一些增强功能,比如插件解锁、会话删除这些。

它不会改Codex的原始文件,属于外挂式的增强,Codex更新了也不影响。

安装Codex++

需要你电脑上有Python 3.11或更高版本。没有的话先装一下,Windows去python.org下载安装包,macOS可以用 brew install python。

然后三步

第一步,下载项目

git clone https://github.com/BigPizzaV3/CodexPlusPlus.gitcd CodexPlusPlus

第二步,装依赖

python -m pip install -e .

第三步,生成启动入口

python -m codex_session_delete setup

Windows上桌面会多一个「Codex++」的快捷方式。macOS上会在 /Applications 下面生成一个 Codex++.app。

从Codex++启动Codex

双击Codex++(Windows)或者打开Codex++.app(macOS)。

它会自动帮你把Codex App启动起来,同时注入增强脚本。

启动之后看顶部菜单栏,会多出一个「Codex++」的菜单,点进去是配置面板。

解锁插件

在Codex++的配置面板里,把「插件选项解锁」打开。

打开之后回到Codex的插件页面,你会发现可以正常浏览和安装插件了。

如果有些插件还是装不上,试试再打开「特殊插件强制安装」这个开关。

顺便说一下会话删除

Codex原生只能归档会话,不能删。Codex++加了删除功能。

鼠标移到会话上面,会出现删除按钮,点了之后有确认弹窗,不小心删了还能撤销。

一个重要的习惯

以后打开Codex App,从Codex++启动,不要从原版Codex启动。只有从Codex++启动,插件解锁、会话删除这些增强功能才有效。

原版Codex还在你电脑上,不用卸载,但以后不从那儿启动了。

3 Codex CLI切模型

如果你是在终端里用Codex CLI的,CC Switch一样能用。其实CLI这边支持得更早,流程也更简单。

和上面Codex App的操作一样

在CC Switch里切到Codex标签 → 添加供应商 → 填API Key → 开路由 → 启用供应商。

然后关掉当前终端里的Codex,重新在项目目录里输入

codex

就会用你配好的国产模型了。

在CLI里可以输入 /model 查看和切换当前模型。也可以启动的时候直接指定

codex -m 你的模型名

改了模型映射之后记得重启CLI,不然模型列表不会刷新。

总结一下

整个配置路线就三件事

CC Switch负责模型切换,把Codex的请求转到国产模型。

Codex++负责增强功能,解锁插件入口,加上会话删除。(如果你可以使用插件,就不需要这一部分内容)

以后启动Codex App从Codex++启动就行。

切换模型后会话记录没了,我最后再提醒一下,这是非常大的坑。

希望后面随着cc switch的更新,能修复掉这个bug,也希望出现这个bug的朋友去官网提issue。

还有再进行类似这样对codex app魔改的时候,最好有一个其他的agent比如Claude code,如果出现问题,可以让Claude code帮你修复一下,不然软件bug的问题,我们普通人是不好去解决掉的。

并且要多去切换几次,说不定你之前出现的bug可能就没了,我自己实操下来是这些感受,希望给你带来一些避坑和解决思路。

好了,感谢你的耐心观看。

如果觉得不错,希望能点个赞、转发、收藏三连吧。

如果想第一时间收到推送,记得关注我哦!

你的关注是我更新的持续动力!

如果二维码失效,直接加我微信:gongfeifeiaaa,我拉你进群。