Codex 接入 DeepSeek 超详细配置方案

Codex 接入 DeepSeek 完整部署教程（Linux 环境）

飞书文档 - 图片

一、环境准备：安装 Go 1.25+

本项目依赖 Go 1.25 及以上版本，执行以下命令完成安装与环境变量配置：

代码块

Markdown

# 卸载旧版本 Go（如有）

sudo rm -rf /usr/local/go

# 下载 Go 1.25.1 安装包

wget https://dl.google.com/go/go1.25.1.linux-amd64.tar.gz -O go.tar.gz

# 解压到系统目录

sudo tar -C /usr/local -xzf go.tar.gz

# 写入环境变量

echo "export PATH=\$PATH:/usr/local/go/bin" >> ~/.bashrc

# 生效环境变量

source ~/.bashrc

# 验证安装

go version

飞书文档 - 图片

二、全局安装 Codex

通过 npm 全局安装 Codex 工具：

代码块

YAML

npm install -g @openai/codex

安装完成后，查看版本验证是否成功：

代码块

YAML

codex --version

飞书文档 - 图片

三、拉取 Moon Bridge 中转项目并安装依赖

Moon Bridge 作为中间代理，实现 Codex 与 DeepSeek API 的对接：

代码块

Markdown

飞书文档 - 图片

四、准备 DeepSeek API Key

前往 DeepSeek 官网申请个人 API 密钥；

保存好你的密钥，格式示例：sk-3b0e30xxxxxxx2f833e，后续配置文件会用到。

飞书文档 - 图片

五、配置 Go 国内代理（解决拉取依赖超时）

国内环境建议配置 Go 镜像代理，加速模块下载：

代码块

YAML

六、编写 Moon Bridge 配置文件 config.yml

在 moon-bridge 目录下新建 config.yml 文件，将 api_key 替换为你自己的 DeepSeek 密钥，完整配置如下：

代码块

YAML

mode: "Transform"

server:

addr: "127.0.0.1:38440"

models:

deepseek-v4-pro:

context_window: 1000000

max_output_tokens: 384000

七、启动 Moon Bridge 中转服务

在 moon-bridge 目录下执行命令，启动代理服务：

代码块

YAML

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

八、自动生成 Codex 配置文件

新开一个终端，依旧进入 moon-bridge 目录，执行以下脚本：

脚本会自动备份原有 Codex 配置，并生成适配当前代理的 config.toml、models_catalog.json。

代码块

Bash

九、启动 Codex 服务

前提要启动中转服务：

在 moon-bridge 目录下执行命令，启动代理服务：

代码块

YAML

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

切换到你自己的项目目录，直接执行命令启动 Codex：

代码块

YAML

codex

退出

代码块

YAML

/exit

补充说明

✍️

运行顺序：先启动 Moon Bridge，再启动 Codex，否则会连接失败；

若后续修改 config.yml，需要重启 Moon Bridge 并重新执行第八步生成配置；

出现 API 报错优先检查 DeepSeek Key、网络连通性、代理端口是否被占用。