跳至主要內容

Codex桌面版接入DeepSeek-V4

Mr.Over2026/5/1大约 2 分钟aiaicodex

Codex桌面版接入DeepSeek-V4

免降级、免破解，通过本地代理让 Codex 最新桌面版与 DeepSeek API 稳定协作。

一、背景

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

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

项目Codex（v0.81.0 及以上）DeepSeek API
协议Responses APIChat 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 <key>   │  localhost:4000 │
└──────────────────┘                                 └────────┬────────┘
                                                              │
                                                              Chat Completions API
                                                              │
                                                              ▼
                                                              ┌──────────────────┐
                                                              │  DeepSeek API    │
                                                              │  api.deepseek.com│
                                                              └──────────────────┘

复制

代理采用开源项目codex-bridge（Node.js 单文件、无额外依赖）。

三、环境要求

  • 操作系统：Windows 10 或 11
  • Node.js 18+（官网下载）
  • Codex 桌面版（Releases下载最新版即可，无需刻意降级）
  • DeepSeek API Key（控制台获取）
  • 能使用 PowerShell 或 Git Bash 执行基本命令

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

步骤 1：确认环境

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

node --version    # 应为 v18.0.0 或更高
codex --version   # 应显示 codex-cli 版本号复制

步骤 2：获取 codex-bridge

git clone https://github.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 编辑配置文件用户目录.codex/config.toml

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

4.2 编辑用户目录.codex/auth.json

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

步骤 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桌面端(如果有打开)，再重新打开 Codex 桌面版

最近更新: