首页

手游

资讯

专题

首页 > 教程攻略 > ai教程 >Codex如何接入DeepSeek?Codex桌面版接入DeepSeek-V4的完整指南

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

来源：互联网时间：2026-08-04 07:11:25

一、背景

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

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

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

CC Switch

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

下载 CC Switch 的安装包（如 .msi）
安装后打开，进入 Codex 相关选项卡 → 添加供应商
API Key：填 DeepSeek 密钥；Base URL：http://127.0.0.1:4000/v1
启用后重启 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 -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 定价与模型选择。这个方案权衡下来，性价比还是相当不错的。

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

一、背景

Responses API

Chat Completions API

解决思路

二、方案架构

三、环境要求

操作系统：

Node.js 18+

Codex 桌面版

DeepSeek API Key

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

步骤 1：确认环境

步骤 2：获取 codex-bridge

说明：

步骤 3：配置袋里环境变量

安全提示：

步骤 4：配置 Codex

4.1 编辑配置文件

要点：

4.2 编辑

注意：

4.3 初始化登录状态

步骤 5：启动袋里

重要：

步骤 6：打开 Codex 桌面版

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

五、验证整条链路

六、常见问题

Q1：桌面版仍要求登录 ChatGPT

CC Switch

Q2：提示 wire_api = chat is no longer supported

Q3：端口 4000 被占用

Q4：袋里启动后连接超时

Q5：关终端袋里就停

七、进阶技巧

Windows 下袋里开机自启

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

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

多模型列表

八、小结

相关阅读

相关下载