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

一、背景

OpenAI 的 Codex 是当前主流的 AI 编程助手之一，提供 CLI 和桌面应用两种形态。另一边，DeepSeek V4 在代码场景下性价比突出，API 调用成本低。

但问题在于，这两者无法直接对接。根本原因在于接口协议不一致：

项目	Codex（v0.81.0 及以上）	DeepSeek API
协议	Responses API	Chat Completions API
请求路径	/v1/responses	/v1/chat/completions
工具调用	tools 字段内联	tool_calls 独立消息

如果你尝试直接把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│
└──────────────────┘

三、环境要求

• 操作系统：
  Windows 10 或 11

• Node.js 18+

• Codex 桌面版
  （下载最新版即可，无需刻意降级）

• DeepSeek API Key
• 能使用 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

用户目录.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"的作用是让桌面版从文件读取密钥，这样可以减少反复弹出浏览器登录的流程（具体行为以当前版本为准）。

用户目录.codexauth.json

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

即使你用的是自定义后端，字段名仍然必须为OPENAI_API_KEY，这是 Codex 侧的约定。

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-bridge
node --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

这个问题可能与桌面版的认证逻辑有关。有用户通过

配置第三方供应商绕过了：

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 下袋里开机自启

$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 -AtLogon
Register-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 到 0.80.0
Codex 版本	可跟新版	停留在旧版
新特性	通常可随新版获得	受旧版限制
维护与风险	依赖袋里项目维护	旧版不再演进
上手成本	中等	较低但功能受限

整体来看，通过本地协议桥接，可以在保留 Codex 新版能力的同时，使用 DeepSeek 的 API 定价与模型选择。这个方案权衡下来，性价比还是相当不错的。