概述

Codex 使用 OpenAI Responses API，而 DeepSeek 使用 Chat Completions API，两者接口协议不兼容。通过 codex-bridge 本地代理进行协议转换，配合 CC-Switch 一键切换配置，即可在 Codex 中使用 DeepSeek 模型。

Codex CLI / VSCode 插件
        |
        v
  %USERPROFILE%\.codex\config.toml  <- CC-Switch 自动写入
  %USERPROFILE%\.codex\auth.json    <- CC-Switch 自动写入
        |
        v
  http://127.0.0.1:4000/v1          <- codex-bridge 代理
        |
        v
  https://api.deepseek.com/v1       <- DeepSeek API

前置环境

工具	说明
Node.js 18+	运行 codex-bridge 代理
Git	克隆源码或直接下载 ZIP

一、安装 codex-bridge

1. 获取源码

git clone https://github.com/wujfeng712-ui/codex-bridge.git
cd codex-bridge

或直接打开 https://github.com/wujfeng712-ui/codex-bridge -> Code -> Download ZIP 解压。

2. 配置环境变量

cp env.example .env

编辑 .env，至少配置两项：

PROXY_AUTH_KEY=sk-proxy-local-<随机48位hex>
DEEPSEEK_API_KEY=sk-你的DeepSeek密钥

DeepSeek API Key 从 https://platform.deepseek.com/api_keys 获取。

3. 生成 PROXY_AUTH_KEY

node -e "console.log('sk-proxy-local-' + require('crypto').randomBytes(24).toString('hex'))"

将输出的值填入 .env 的 PROXY_AUTH_KEY= 后面。

二、启动代理

cd <codex-bridge所在目录>
node --env-file=.env proxy.mjs

成功启动后显示：

[codex-bridge] Listening on http://localhost:4000
[codex-bridge] Deepseek: https://api.deepseek.com/v1
[codex-bridge] Inbound : auth required (1 key loaded)

注意：小黑窗不能关，每次使用 Codex + DeepSeek 前都要先启动代理。

三、在 CC-Switch 中配置

1. 打开 CC-Switch

双击 cc-switch.exe 启动。

2. 切换到 Codex 面板

在界面顶部的应用切换栏中，点击 Codex。

3. 添加供应商

点击右上角 + 按钮，填写：

配置项	值
名称	codex-bridge
API 地址 (Base URL)	http://127.0.0.1:4000/v1
API Key	与 .env 中 PROXY_AUTH_KEY 的值一致

4. 获取模型列表

添加后，点击供应商卡的编辑按钮 -> 点击 获取模型列表，会自动显示 DeepSeek 可用模型。选择合适的模型后保存。

5. 启用

回到主界面，在 codex-bridge 供应商卡片上点击 启用。

四、在 VSCode 中使用

VSCode 的 Codex 插件与 Codex CLI 共用 %USERPROFILE%\.codex\ 下的配置文件，CC-Switch 已自动写入，无需额外设置。

1. 在 VSCode 扩展商店搜索安装 Codex - OpenAI’s coding agent
2. 点击侧边栏 Codex 图标，直接使用即可

切换供应商后需要重启 VSCode 终端或重新打开 Codex 面板才能生效。

五、模型选择建议

场景	模型	特点
日常编码	deepseek-v4-flash	速度快、便宜
复杂重构	deepseek-v4-pro	推理能力强

六、切回官方 Codex

在 CC-Switch 的 Codex 面板中，选择 default 配置文件并启用即可。

七、常见问题

Q: 启动代理报错 EADDRINUSE :4000

端口已被占用，先关闭之前的代理进程再启动。

Q: node --env-file=.env 提示 .env: not found

需要在 codex-bridge 目录下运行命令，或直接双击 start-codex-bridge.cmd 一键启动：

cd <codex-bridge所在目录>
node --env-file=.env proxy.mjs

Q: 切换后 Codex 没反应

关闭并重新打开终端/VSCode Codex 面板，配置才会重新加载。

Q: 代理启动后 Codex 报 401

.env 中的 PROXY_AUTH_KEY 与 CC-Switch 中填写的 API Key 不一致，确认两者相同。

---

工具信息

工具	开源性	协议	仓库
CC-Switch	免费开源 MIT	-	https://github.com/farion1231/cc-switch
codex-bridge	免费开源 MIT	-	https://github.com/wujfeng712-ui/codex-bridge