Codex 接入开源模型完整配置指南

Codex 接入开源模型这件事，OpenAI 上个月正式宣布支持第三方模型了。但很多朋友跟着文档配完发现根本连不上，原因很简单：Codex 用的是 OpenAI 的 Responses API，国产模型走的是 Chat Completions API，两种协议不互通，直接改 config.yaml 不解决问题。解决方法是用 CC Switch，一个开源本地代理工具，在中间做协议转换。工作流程：Codex → CC Switch（本地代理加协议转换）→ DeepSeek 或通义 API。Codex 以为自己连的是官方接口，实际请求被 CC Switch 转发给了第三方模型。

下面从零开始，一步步教你配通。

第一步：安装 Codex

CLI 版（推荐开发者用）：确保你已经装了 Node.js，去 nodejs.org 下载 LTS 版。然后打开终端：Mac/Linux 运行 sudo npm install -g @openai/codex，Windows 以管理员身份打开 PowerShell 运行 npm install -g @openai/codex。装完运行 codex –version 验证，看到版本号就说明装好了。

装完后配置文件位置：Mac/Linux 在 ~/.codex/config.yaml，Windows 在 C:\Users\你的用户名.codex\config.yaml。

桌面版（新手推荐）：直接去 codex.openai.com 下载安装包，双击安装，按提示登录就行。

第二步：拿 API Key

以 DeepSeek 为例，去 platform.deepseek.com 注册账号，左侧菜单找到 API Keys，点创建，复制以 sk- 开头的 key。新用户有免费额度，够你试很久。用通义千问的话去 dashscope.aliyun.com，流程一样。

第三步：安装 CC Switch

项目地址：github.com/farion1231/cc-switch。各平台安装方式：Windows 去 Releases 页面下载 .msi 安装包双击安装；macOS 运行 brew install –cask cc-switch；Linux 下载 .deb 包运行 sudo dpkg -i CC-Switch-*.deb。装完启动，CC Switch 在系统托盘运行。

第四步：配置 DeepSeek

打开 CC Switch，顶部切换到 Codex 标签页。左边 Providers 区域，点 + Add Provider。在预设列表搜索 DeepSeek，选择内置预设：DeepSeek V4 Flash（速度快成本低，适合日常）或 DeepSeek V4 Pro（能力强，适合复杂任务）。填入你的 DeepSeek API Key，其他字段保持默认。开启 Needs Local Routing 开关（默认就是开的），点击保存。

第五步：开启本地路由

点 CC Switch 左上角齿轮图标，进设置，选路由（Routing）。打开本地路由开关，按钮变绿就行。确认下方显示 Codex 路由记录。

第六步：测试是否通

完全重启 Codex（关掉所有 Codex 窗口和终端进程），重新打开 Codex，在模型选择列表应该能看到 DeepSeek V4 Flash 或 V4 Pro。发一条测试消息，比如写一个 Hello World，回到 CC Switch 路由页面看请求计数有没有增加，增加就说明走代理成功了。

注意：切换模型直接在 CC Switch Providers 里改模型名，保存就生效，不需要重启 Codex。想切回官方模型，关掉 CC Switch 的路由开关就行。

常见问题排查

看不到模型列表：确认路由开关打开且绿色，确认完全重启了 Codex，检查 CC Switch 端口是否被占用。400/404 错误：DeepSeek V4 需要协议转换，CC Switch 预设已处理好，不要手动填模型名。请求不走代理：检查 CC Switch 路由记录有没有计数，重启终端让环境变量生效。图片和 Computer Use 不能用：第三方模型不支持这些 OpenAI 独有的功能，属于正常降级。

实测数据

我自己跑了几天：DeepSeek V4 Flash 响应速度和 GPT-5 差不多，日常写代码改 bug 完全够用。DeepSeek V4 Pro 复杂项目重构效果好，但比 Flash 慢一些。本地 Qwen 35B 不用联网，敏感数据安全，但复杂推理差一截。

推荐组合方案

日常写代码用 DeepSeek V4 Flash，涉及敏感数据换本地模型，复杂架构项目切回 GPT。

高级技巧

CC Switch 支持多工具隔离配置，Codex 的配置不会影响 Claude Code。可以同时添加多个提供商，比如 DeepSeek 加通义，随时切换。所有配置存在本地，API Key 安全。

收藏这条，配置的时候翻出来对着抄就行，有问题评论区见。