Codex 桌面版接入 DeepSeek 完整教程

Codex 是 OpenAI 的官方桌面客户端，它原生只支持 OpenAI 模型，想接入 DeepSeek 这类国产大模型，核心思路是通过本地桥接服务，把 Codex 的 OpenAI Responses API 请求转发给 DeepSeek。

一、准备工作

获取 DeepSeek API Key

前往 DeepSeek 开放平台，注册账号后在「API Keys」页面创建密钥（格式：sk-xxxx），并确保账户有余额。

安装依赖环境

Node.js 18+（推荐 20.x 稳定版）：官网下载（v22.22.2）

Git：官网下载（git version 2.39.0.windows.2）

二、部署 Codex 桥接服务（核心步骤）

我们使用社区的 codex-bridge 项目，实现 Responses API 到 DeepSeek 的协议转换。

创建工作目录并克隆项目

打开终端（Windows 用 PowerShell）执行：

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

配置 DeepSeek 密钥

在 codex-bridge 目录下创建 .env 文件，写入：

DEEPSEEK_API_KEY=你的DeepSeek密钥（sk-xxx）
DEEPSEEK_MODELS=deepseek-v4-pro,deepseek-v4-flash
DEFAULT_PROVIDER=deepseek
PROXY_PORT=4000

启动桥接服务

在终端执行：

node --env-file=.env proxy.mjs

看到 Server running on http://127.0.0.1:4000 即为成功，保持该终端窗口运行（不要关闭）。

三、配置 Codex 桌面版

找到 Codex 配置目录

Windows：%USERPROFILE%.codex（在文件资源管理器地址栏直接输入回车）
macOS/Linux：~/.codex

编辑 config.toml 文件

用记事本 / VS Code 打开 config.toml，清空原有内容，粘贴以下配置：

model = "deepseek-v4-pro"
model_provider = "deepseek_bridge"
cli_auth_credentials_store = "file"

[model_providers.deepseek_bridge]
name = "DeepSeek V4 Bridge"
base_url = "http://127.0.0.1:4000/v1"
wire_api = "responses"
requires_openai_auth = true

配置认证文件 auth.json

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-xxx"
}

注意：即使是 DeepSeek 密钥，字段名仍需为 OPENAI_API_KEY，这是 Codex 的硬性要求。

四、验证与启动

确保桥接服务终端窗口处于运行状态。
关闭并重新打开 Codex 桌面客户端。
在 Codex 中发起对话 / 代码请求，查看桥接服务终端的日志：如果出现 Forwarding request to DeepSeek，说明请求已成功转发，接入完成。

Codex 桌面版接入 DeepSeek 完整教程

常见问题与避坑指南

问题	缘由	解决方法
Codex 仍使用 OpenAI 模型	配置文件未生效	1. 确认 config.toml 路径正确 2. 重启 Codex 客户端 3. 检查桥接服务端口 4000 是否被占用
桥接服务报错 401 未授权	DeepSeek 密钥错误 / 过期	1. 检查 .env 中的密钥是否完整 2. 确认 DeepSeek 账户余额充足
无法连接到桥接服务	端口或网络问题	1. 关闭防火墙 / 代理工具 2. 确认 base_url 为 http://127.0.0.1:4000/v1

补充说明

桥接服务本质是协议转换：Codex 用的 OpenAI Responses API 和 DeepSeek 的 Chat Completions API 格式不同，桥接服务会自动转换请求 / 响应格式。
支持模型：除了 deepseek-v4-pro，也可以使用 deepseek-v4-flash 或 deepseek-coder，只需修改 config.toml 和 .env 中的模型名。
安全提示：密钥不要提交到公共仓库，桥接服务仅本地运行，不会暴露你的 API Key。