文章目录
ToggleCodex 桌面客户端 + CC-switch 使用国产 DeepSeek 模型教程
背景
最近 OpenAI 推出的 Codex 桌面客户端(Codex App)火了起来,它把 AI 编程助手集成到图形界面里,点点鼠标就能让 AI 写代码、改 Bug、解释项目。但 Codex 默认调用的是 OpenAI 的模型,对国内用户来说访问不太方便,使用成本也比较高。
本文介绍一种更接地气的方案:Codex 桌面客户端 + cc-switch,让 Codex 走国产的 DeepSeek 大模型。
效果
配置完成后:
- 你可以正常打开 Codex 桌面客户端;
- 客户端里的 AI 对话、代码补全等功能实际调用的是 DeepSeek 模型(例如
deepseek-chat或deepseek-reasoner); - 不需要一直开着VPN挂着国外网络,只要 DeepSeek API 能访问即可;
具体方法
1. 下载 & 安装 Codex 桌面客户端
Codex 桌面客户端支持 macOS 和 Windows(具体以官方发布为准)。
- 访问 OpenAI Codex 官方页面 官方下载页面或应用商店下载安装包:
- 根据自己的系统下载对应版本:
- macOS:下载
.dmg安装包,双击后拖到“应用程序”文件夹。 - Windows:下载
.exe或.msi安装包,双击按向导安装。
- macOS:下载
- 安装完成后,从“应用程序”或“开始菜单”启动 Codex。
2. 登录 Codex 桌面客户端
首次打开 Codex 客户端,会提示登录。
Codex 客户端通常支持两种登录方式:
方式一:使用 ChatGPT / OpenAI 账号登录(需要翻墙)
- 在登录界面选择“使用 OpenAI 账号登录”。
- 客户端会弹出浏览器窗口,让你用 OpenAI / ChatGPT 账号授权。
- 授权完成后,客户端自动进入主界面。
注意:这种方式需要开启VPN科学上网工具并且IP非中国大陆地区,才能正常访问 OpenAI。
方式二:使用 API Key 登录
- 在登录界面选择“使用 API Key 登录”或“自定义 API 设置”。
- 先填入一个占位 API Key(例如
sk-cc-switch),后续会改成指向 cc-switch 本地服务。 - 稍等片刻之后,Codex正常打开
3. 下载 & 安装 cc-switch
cc-switch 是一个 GitHub 上的开源项目,具体方法为:
3.1 访问 GitHub
打开浏览器,访问GitHub地址https://github.com/farion1231/cc-switch
备注:Github有时会被墙,如果打不开的话,请开启VPN科学上网工具。
3.2 下载对应的安装包
| 系统 | 推荐下载文件 |
|---|---|
| macOS | .dmg, 例如 CC-Switch-v3.16.4-macOS.dmg |
| Windows | .msi, 例如 CC-Switch-v3.16.4-Windows.msi |
3.3 安装对应的软件
macOS 安装
- 下载
.dmg后双击,按提示拖到“应用程序”文件夹即可。
Windows 安装
- 下载
.msi后双击安装,按照提示选择相应的安装路径,完成安装。
4. 配置 cc-switch
cc-switch 安装好后,需要进行两项核心配置:指定 DeepSeek API Key,以及开启对 Codex 客户端请求的路由。
4.1 配置模型(DeepSeek)
-
注册 DeepSeek 账号并获取 API Key
- 访问 DeepSeek 开放平台。
- 注册/登录账号。
- 进入“API Keys”页面,点击“创建 API Key”。
- 复制生成的 Key(通常是
sk-开头)。

-
在 cc-switch 中配置 DeepSeek API Key
4.2 开启 cc-switch 的路由功能
cc-switch 的核心作用是把 Codex 客户端发向 OpenAI 的请求“拦截”并转发到 DeepSeek。所以,需要开启路由功能,具体方法:
5. 重启 Codex 客户端并验证
-
完成上述配置后,重启 Codex 桌面客户端。
常见问题:
1、提示API-KEY无效,请检查Deepseek的API-key,确认无误后重启Codex。
2、cc-switch的路由未生效,请确认路由中的相关功能都开启,同时重启Codex。
3、如果想使用原有的ChatGPT账号,只需要在CC-swtich中重新启用OpenAI Official即可。
小结
通过 Codex 桌面客户端 + cc-switch + DeepSeek,你可以在图形界面里享受 Codex 的编程辅助能力,同时调用国产、便宜的 DeepSeek 模型。整个流程可以概括为:
- 安装 Codex 桌面客户端;
- 用 API Key 方式完成 Codex 登录;
- 下载并安装
farion1231/cc-switch; - 在 cc-switch 中填入 DeepSeek API Key,启动本地路由;
- 重启客户端验证。












