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

本文为原创实践总结，记录我在 Linux 环境下，通过 Moon Bridge 中转实现 Codex 对接 DeepSeek 的完整过程。网上大多是零散步骤，我踩了「Go 代理超时、端口占用、配置不生效」等坑，整理成可直接复制的方案，帮大家避坑。
相关链接

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

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

# 卸载旧版本 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 工具：

npm install -g @openai/codex

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

codex --version

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

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

# 克隆项目源码
git clone https://github.com/ZhiYi-R/moon-bridge.git
# 进入项目目录
cd moon-bridge
# 安装项目依赖
npm install

四、准备 DeepSeek API Key

1. 前往 DeepSeek 官网申请个人 API 密钥；
2. 保存好你的密钥，格式示例：sk-3b0e30xxxxxxx2f833e，后续配置文件会用到。

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

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

# 设置 GOPROXY 国内镜像
go env -w GOPROXY=https://goproxy.cn,direct
# 关闭模块校验（可选，规避部分校验失败问题）
go env -w GOSUMDB=off

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

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

mode: "Transform"

server:
  addr: "127.0.0.1:38440"

models:
  deepseek-v4-pro:
    context_window: 1000000
    max_output_tokens: 384000
    default_reasoning_level: "high"
    supported_reasoning_levels:
      - effort: "high"
        description: "High reasoning effort"
      - effort: "xhigh"
        description: "Extra high reasoning effort"
    supports_reasoning_summaries: true
    default_reasoning_summary: "auto"
    extensions:
      deepseek_v4:
        enabled: true
  deepseek-v4-flash:
    context_window: 1000000
    max_output_tokens: 384000
    default_reasoning_level: "high"
    supported_reasoning_levels:
      - effort: "high"
        description: "High reasoning effort"
      - effort: "xhigh"
        description: "Extra high reasoning effort"
    supports_reasoning_summaries: true
    default_reasoning_summary: "auto"
    extensions:
      deepseek_v4:
        enabled: true

providers:
  deepseek:
    base_url: "https://api.deepseek.com/anthropic"
    api_key: "sk-your-deepseek-api-key"  # 此处替换为你的 DeepSeek API Key
    offers:
      - model: deepseek-v4-pro
      - model: deepseek-v4-flash

routes:
  moonbridge:
    model: deepseek-v4-pro
    provider: deepseek

defaults:
  model: moonbridge
  max_tokens: 65536

七、启动 Moon Bridge 中转服务

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

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

保持当前终端窗口不要关闭。

八、自动生成 Codex 配置文件

新开一个终端，依旧进入 moon-bridge 目录，执行以下脚本：
脚本会自动备份原有 Codex 配置，并生成适配当前代理的 config.toml、models_catalog.json。

# 定义 Codex 配置目录
CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_HOME_DIR"

# 备份原有配置（避免配置丢失）
cp "$CODEX_HOME_DIR/config.toml" "$CODEX_HOME_DIR/config.toml.bak" 2>/dev/null || true

# 自动生成模型名称 & Codex 配置文件
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 服务

前提要启动中转服务：
在 moon-bridge 目录下执行命令，启动代理服务：

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

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

codex

退出

/exit

---

补充说明

1. 运行顺序：先启动 Moon Bridge，再启动 Codex，否则会连接失败；
2. 若后续修改 config.yml，需要重启 Moon Bridge 并重新执行第八步生成配置；
3. 出现 API 报错优先检查 DeepSeek Key、网络连通性、代理端口是否被占用。