Codex接入DeepSeek：低成本AI编程助手部署指南

如果你在找 OpenAI Codex 的替代方案，觉得官方模型成本太高，或者想用更经济、更本地化的方式体验 AI 编程助手，那么把 Codex 接入 DeepSeek 是一个值得优先考虑的路径。这本质上不是“破解”或“替换”，而是通过一个转发层（比如 Moon Bridge），让 Codex 这个客户端把请求发到 DeepSeek 的 API 上，从而实现功能。

整个过程不需要你写一行代码，但需要你理解几个关键点：环境准备、配置生成、请求转发和验证。最核心的环节不是安装，而是确保 Moon Bridge 这个中间件能稳定运行，并且 Codex 能正确识别到它提供的模型。

下面我会按实际落地的顺序，从环境检查到最终验证，拆解每一步的操作和可能遇到的坑。

1. 先理清 Codex、Moon Bridge 和 DeepSeek 三者的关系

在动手之前，必须搞清楚这三个组件各自扮演什么角色，以及数据是怎么流动的。这能帮你快速定位问题出在哪个环节。

1.1 Codex：你用的客户端，它只认 OpenAI 的接口

Codex 是 OpenAI 推出的 AI 编程助手，有命令行（CLI）和桌面应用（App）两种形式。它内部设计是与 OpenAI 的Responses API通信。这意味着，Codex 启动后，会按照固定的格式和地址发送请求，并期望收到符合 Responses API 规范的回复。

关键点在于：Codex 本身不支持直接配置第三方模型的 API 地址。你不能简单地在 Codex 的设置里填一个 DeepSeek 的 API 密钥和端点就完事。它需要一个“翻译官”或“转发站”。

1.2 Moon Bridge：关键的转发层与协议转换器

Moon Bridge 就是这个“翻译官”。它是一个用 Go 语言编写的代理服务，核心功能有两个：

1. 协议转换：在本地启动一个服务，这个服务对外暴露的接口，完全模仿 OpenAI 的 Responses API。这样 Codex 就可以像调用 OpenAI 一样调用它，毫无感知。
2. 请求转发：当 Moon Bridge 收到来自 Codex 的、符合 OpenAI 格式的请求后，它会提取其中的关键信息（如用户输入、模型参数），重新封装成 DeepSeek API 能识别的格式，然后发送给 DeepSeek 的服务器。拿到 DeepSeek 的回复后，再转换回 OpenAI 的格式，返回给 Codex。

你可以把 Moon Bridge 看作一个本地运行的、高度定制化的反向代理。它的配置文件 (config.yml) 是你需要重点操作的地方，里面定义了用哪个 DeepSeek 模型、你的 API 密钥是什么、本地服务监听哪个端口。

1.3 DeepSeek：最终提供 AI 能力的“大脑”

DeepSeek 提供了实际的 AI 模型能力（如 DeepSeek-V4）。你需要去 DeepSeek 开放平台注册账号，并创建一个 API Key。这个 Key 会被填入 Moon Bridge 的配置中。Moon Bridge 在转发请求时，会使用这个 Key 向 DeepSeek 发起认证请求。

整个流程可以概括为：你的电脑->Codex 客户端->本地 Moon Bridge 服务 (127.0.0.1:38440)->DeepSeek 官方 API 服务器->返回结果->Moon Bridge->Codex->你看到回复。

理解了这一点，后续所有步骤——安装、配置、启动、排错——都会变得清晰。

2. 环境准备：别在第一步就卡住

很多教程假设你的环境是“干净”的，但实际往往不是。以下检查清单能帮你避免 80% 的初期问题。

2.1 基础运行环境检查

Moon Bridge 需要 Node.js 和 Go。Codex CLI 本身也需要 Node.js 环境。

1. Node.js 18+:

   • 检查：打开终端，运行node --version。
   • 如果没有或版本低：去 Node.js 官网下载 LTS 版本安装。Windows 用户也可以使用nvm-windows管理多版本。
   • 注意：确保安装后node和npm命令在终端中可用。

2. Go 1.25+:

   • 检查：运行go version。
   • 安装：去 Go 官网下载安装包。安装后，通常需要将 Go 的二进制目录（如C:\Go\bin或/usr/local/go/bin）添加到系统的 PATH 环境变量中。
   • 验证