Codex如何接入DeepSeek?Codex桌面版接入DeepSeek-V4的完整指南

Codex如何接入DeepSeek?Codex桌面版接入DeepSeek-V4的完整指南需要先看清适用场景和关键步骤，避免只记结论却忽略实际限制。

一、背景

OpenAI 的 Codex 是目前主流的 AI 编程助手之一，提供 CLI 与桌面应用。DeepSeek V4 在代码场景下性价比高、API 成本低。

两者无法直接对接，根本原因是接口协议不一致：

若直接把 base_url 设为 https://api.deepseek.com/v1，通常会返回 400。

解决思路：在本机部署轻量代&理，在请求往返时做协议转换。

二、方案架构

数据流示意：

──────────────────┐ Responses API ┌─────────────────┐

│ Codex 桌面版 │ ──────────────────────────────▶│ codex-bridge │

│ (示例 v0.129.0) │ Authorization: Bearer │ localhost:4000 │

└──────────────────┘ └────────┬────────┘

│

Chat Completions API

│

▼

┌──────────────────┐

│ DeepSeek API │

│ api.deepseek.com│

└──────────────────┘

三、环境要求

1. 操作系统：Windows 10 或 11
2. Node.js 18+
3. Codex 桌面版（下载最新版即可，无需刻意降级）
4. DeepSeek API Key
5. 能使用 PowerShell 或 Git Bash 执行基本命令

四、操作步骤（按顺序执行）

步骤 1：确认环境

打开终端（推荐 Git Bash），执行：

步骤 2：获取 codex-bridge

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

说明：若访问 GitHub 不稳定，可改用镜像，例如：

git clone https://gitcode.com/wujfeng712-ui/codex-bridge.git ~/.codex/codex-bridge

步骤 3：配置代&理环境变量

编辑路径（将「你的用户名」换成实际用户名）：C:Users你的用户名.codexcodex-bridge.env

写入示例（请替换为自己的密钥）：

# === DeepSeek 上游密钥 ===DEEPSEEK_API_KEY=sk-你的DeepSeek密钥# === 暴露的模型列表 ===DEEPSEEK_MODELS=deepseek-v4-pro,deepseek-v4-flash,deepseek-reasoner# === 默认供应商 ===DEFAULT_PROVIDER=deepseek# === 日志级别 ===LOG_LEVEL=info

安全提示：密钥一般不要加引号，直接写 sk-xxx。.env 含明文密钥，勿提交到 Git。

步骤 4：配置 Codex

4.1 编辑配置文件用户目录.codexconfig.toml

cli_auth_credentials_store = "file"model = "deepseek-v4-pro"model_provider = "local_proxy"[model_providers.local_proxy]name = "local_proxy"base_url = "http://127.0.0.1:4000/v1"wire_api = "responses"requires_openai_auth = true

要点：cli_auth_credentials_store = "file" 让桌面版从文件读密钥，减少反复弹出浏览器登录的流程（具体行为以当前版本为准）。

4.2 编辑用户目录.codexauth.json

{  "auth_mode": "apikey",  "OPENAI_API_KEY": "sk-你的DeepSeek密钥"}

注意：即使用自定义后端，字段名仍须为 OPENAI_API_KEY，这是 Codex 侧约定。

4.3 初始化登录状态

echo "sk-你的DeepSeek密钥" | codex login --with-api-key

成功时通常可见：Successfully logged in

可再执行：

codex login status# 期望：Logged in using an API key - sk-***xxxx

步骤 5：启动代&理

cd ~/.codex/codex-bridgenode --env-file=.env proxy.mjs

出现类似输出即表示监听成功：

[codex-bridge] Listening on http://localhost:4000

[codex-bridge] Default provider: deepseek

[codex-bridge] Deepseek: https://api.deepseek.com/v1 | models=deepseek-v4-pro, deepseek-v4-flash, deepseek-reasoner

重要：保持该终端窗口不要关；关掉则代&理停止。开机自启见文末「进阶技巧」。

步骤 6：打开 Codex 桌面版

从开始菜单或快捷方式启动。配置正确时，应能进入工作界面。

步骤 7：在对话里切换模型

/model deepseek-v4-pro     # 偏推理，适合复杂编码/model deepseek-v4-flash   # 偏速度，适合轻量编辑

五、验证整条链路

用 CLI 做一次端到端测试：

codex exec "回复一个字：好"

输出中若出现模型为 deepseek-v4-pro、提供方为 local_proxy，且最后有单独一行「好」，说明链路正常。

六、常见问题

Q1：桌面版仍要求登录 ChatGPT

可能与桌面版认证逻辑有关，有用户通过 CC Switch 配置第三方供应商绕过：

1. 下载 CC Switch 的安装包（如 .msi）
2. 安装后打开，进入 Codex 相关选项卡 → 添加供应商
3. API Key：填 DeepSeek 密钥；Base URL：http://127.0.0.1:4000/v1
4. 启用后重启 Codex

Q2：提示 wire_api = chat is no longer supported

自 Codex v0.81.0 起不再支持 wire_api = "chat"。请确认 config.toml 中为 wire_api = "responses"，由代&理向下游转换为 Chat Completions。

Q3：端口 4000 被占用

netstat -ano | findstr ":4000"taskkill /PID  /F

也可在 .env 改端口，例如 PROXY_PORT=4001，并同步修改 config.toml 里的 base_url。

Q4：代&理启动后连接超时

依次检查：DeepSeek Key 是否正确；本机能否访问 https://api.deepseek.com；防火墙是否拦截 Node.js。

Q5：关终端代&理就停

见下文「代&理开机自启」。

七、进阶技巧

Windows 下代&理开机自启

方法一：任务计划程序（PowerShell 示例）

$action = New-ScheduledTaskAction -Execute "node" `  -Argument "--env-file=$env:USERPROFILE.codexcodex-bridge.env $env:USERPROFILE.codexcodex-bridgeproxy.mjs" `  -WorkingDirectory "$env:USERPROFILE.codexcodex-bridge"$trigger = New-ScheduledTaskTrigger -AtLogonRegister-ScheduledTask -TaskName "CodexBridge" -Action $action -Trigger $trigger `  -Description "Codex → DeepSeek 协议代&理" -RunLevel Highest

方法二：启动文件夹快捷方式

文件夹路径：%APPDATA%MicrosoftWindowsStart MenuProgramsStartup

快捷方式「目标」：node --env-file=.env proxy.mjs

「起始位置」：C:Users你的用户名.codexcodex-bridge

多模型列表

在 .env 的 DEEPSEEK_MODELS 中维护逗号分隔列表，重启代&理后可在 Codex 内用 /model 切换。

八、小结

整体上，用本地协议桥接可以在保留 Codex 新版能力的同时，使用 DeepSeek 的 API 定价与模型选择