亲测有效！Codex桌面版免费接入DeepSeek V4

导读：OpenAI Codex 是一款强大的 AI 编程助手，但官方模型价格不菲。DeepSeek V4 作为国产大模型的新星，不仅性能强悍，价格更是只有 GPT 系列的十分之一。本文将手把手教你如何在 Codex 桌面版中接入 DeepSeek 模型。

一、为什么选择 DeepSeek？

DeepSeek V4 发布后，在多项基准测试中表现亮眼：

• 性价比极高：DeepSeek V4 Flash 输入仅 $0.27/百万 tokens，缓存命中低至 $0.07/百万

• 性能强悍：编程任务表现出色，推理能力接近 Claude Opus 4.6

• 双协议支持：同时兼容 OpenAI 和 Anthropic 两种 API 格式

价格对比：

💡 选择 DeepSeek V4 Flash 可以节省 90% 以上的成本！

二、核心问题：协议不兼容

Codex 新版本（v0.81.0 及以上）使用的是 OpenAI Responses API，而 DeepSeek 官方 API 使用的是 Chat Completions API。这两个协议不兼容，直接配置会导致工具调用失败。

具体表现：

• 工具调用报错：insufficient tool messages following tool_calls message

• 推理模型报错：Missing reasoning_content field

解决方案：需要一个「中间代理层」，将 Codex 发出的 Responses API 请求转换为 DeepSeek 能理解的 Chat Completions API 请求。

目前主要有三种解决方案：

1. Moon Bridge - 官方推荐的 Go 语言代理。社区开发者维护。功能更全。

2. CCX：配置简单

3. Codex-bridge：轻量方案

三、方案一：Moon Bridge（官方推荐）

Moon Bridge 是 DeepSeek 官方文档中推荐的开源代理方案，功能完整，支持 V4 的推理模式扩展。

3.1 环境准备

• Node.js 18+（下载地址）

• Go 1.25+（下载地址）

• Codex CLI（安装命令：npm install -g @openai/codex）

3.2 获取 DeepSeek API Key

第一步：访问 DeepSeek 开放平台

第二步：注册或登录账号

第三步：进入 API Keys 管理页面

第四步：点击「创建 API Key」，复制并妥善保存

3.3 克隆项目并配置

打开命令行终端，执行以下命令克隆项目：

git clone https://github.com/ZhiYi-R/moon-bridge.git
cd moon-bridge

在项目目录下创建 config.yml 配置文件：

mode: "Transform"

server:
  addr: "127.0.0.1:38440"

provider:
  providers:
    deepseek:
      base_url: "https://api.deepseek.com/anthropic"
      api_key: "sk-你的DeepSeek密钥"
      models:
        deepseek-v4-pro:
          context_window: 1000000
          max_output_tokens: 384000
          extensions:
            deepseek_v4:
              enabled: true
              default_reasoning_level: "high"

routes:
  moonbridge:
    to: "deepseek/deepseek-v4-pro"
    default_model: "moonbridge"

3.4 启动代理服务

在终端中运行：

go run ./cmd/moonbridge --config config.yml

代理默认监听 127.0.0.1:38440，保持终端窗口打开。

3.5 生成 Codex 配置文件

打开另一个终端，在 moon-bridge 目录下执行：

CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_HOME_DIR"

MODEL="$(go run ./cmd/moonbridge --config config.yml --print-codex-model)"

go run ./cmd/moonbridge \
  --config config.yml \
  --print-codex-config "$MODEL" \
  --codex-base-url "http://127.0.0.1:38440/v1" \
  --codex-home "$CODEX_HOME_DIR" \
  > "$CODEX_HOME_DIR/config.toml"

这会在 ~/.codex/ 目录下生成 config.toml 和 models_catalog.json 文件。

3.6 启动 Codex

cd /path/to/your-project
CODEX_HOME="$HOME/.codex" codex --cd "$PWD"

现在 Codex 会通过 Moon Bridge 将请求转发到 DeepSeek V4。

四、方案二：用CCX（最简单）

4.1 下载地址

Windows：ccx: https://pan.quark.cn/s/2d43ca4e5aef   Switch: https://pan.quark.cn/s/57b769c2ff0b

Mac：ccx: https://pan.quark.cn/s/b8a553da956c   Switch: https://pan.quark.cn/s/d9cd3eb9ce31

Linux：ccx: https://pan.quark.cn/s/dc582154254e   Switch: https://pan.quark.cn/s/a6b587a76c8c

4.2 解压并配置API Key   FDEVpY1RmT0RVdkxVZ1hrZXNHcHNRTGszdVhRc0JLbmhTcURJV2lhYzhpY0VPSXVONWNCcnFNUk5FZTJjaWM1TjJXdTAvNjQwP3d4X2ZtdD1wbmcmYW1w;from=appmsg" class="rich_pages wxw-img" data-ratio="0.33464052287581697" data-s="300,640" data-type="png" data-w="765" type="block" data-imgfileid="100001215" data-aistatus="1">解压后找到.env文件填上API Key即可。API地址填 https://api.deepseek.com

4.3 启动代理程序

因为Codex只支持OpenAI自家的模型。想用DeepSeek， 加一个翻译官——本地代理。Codex发的是Responses请求，代理翻译成Chat补全请求发给DeepSeek，再把结果翻译回来。

五、方案三：codex-bridge（轻量方案）

如果你更喜欢 Node.js 生态，codex-bridge 是个更轻量的选择。

5.1 克隆项目

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

5.2 创建环境变量文件

在项目目录下创建 .env 文件：

# DeepSeek API 密钥
DEEPSEEK_API_KEY=sk-你的DeepSeek密钥

# 可用模型列表
DEEPSEEK_MODELS=deepseek-v4-pro,deepseek-v4-flash,deepseek-reasoner

# 默认供应商
DEFAULT_PROVIDER=deepseek

# 日志级别
LOG_LEVEL=info

5.3 配置 Codex

编辑 ~/.codex/config.toml 文件：

[model_providers.deepseek_proxy]
name = "DeepSeek Proxy"
base_url = "http://127.0.0.1:4000/v1"
env_key = "DEEPSEEK_API_KEY"
wire_api = "responses"

[profiles.deepseek_pro]
model = "deepseek-v4-pro"
model_provider = "deepseek_proxy"

[profiles.deepseek_flash]
model = "deepseek-v4-flash"
model_provider = "deepseek_proxy"

5.4 启动代理

cd ~/.codex/codex-bridge
node index.js

代理默认监听 127.0.0.1:4000。

5.5 启动 Codex

codex --profile deepseek_flash

六、常见问题排查

1. 连接被拒绝（connection refused）

→ 检查代理服务是否正在运行，确认端口配置一致

2. Codex 无法看到 DeepSeek 模型

→ 重新运行配置生成步骤，确保 models_catalog.json 存在于 CODEX_HOME 目录

3. 认证错误（401 Unauthorized）

→ 检查 DeepSeek API Key 是否正确，确认账户余额充足

4. 工具调用失败

→ 确认使用的是代理方案而非直连。DeepSeek 不支持 Responses API，必须通过代理转换

5. 图片输入失败

→ Moon Bridge 的图片功能需要单独配置视觉模型提供商，或在配置中禁用 visual

七、最佳实践建议

经过实际使用，推荐以下分工策略：

复杂架构设计、大规模重构 → Claude Opus 4.6 / GPT-5.4

问题定义不清晰时需要更强的推理能力

日常代码编写、格式化、测试 → DeepSeek V4 Flash

质量足够，成本极低

意图识别、日志分类 → DeepSeek V4 Flash + 缓存

缓存命中率高，成本最低

八、总结

Codex 桌面版接入 DeepSeek 模型的核心在于解决协议兼容问题。

选择建议：

• 新手入门：推荐用CCX，配置简单

• 追求稳定：推荐 Moon Bridge，官方支持

📌 参考资料

• DeepSeek 官方文档：api-docs.deepseek.com
• Moon Bridge 项目：github.com/ZhiYi-R/moon-bridge
• codex-bridge 项目：github.com/wujfeng712-ui/codex-bridge
• CliGate 项目：github.com/codeking-ai/cligate
• OpenAI Codex CLI：github.com/openai/codex