1. Codex 接口协议

本人目前已经尝试用过很多 Agent 工具，Claude、Codex、openCode、openClaw 等，它们配置起来都比较复杂，但都还是支持 Chat Completions 协议的。因为之前用的都是老版本的 Codex（v0.80.0 以下），近期我想要尝试新版本的 Codex，但是我发现它现在只有三种方式接入模型。

1. 直接登录账号验证。
2. 根据 code 验证登录。
3. 直接使用 API 接入 Agent。

我选择第三个之后配置了 deepseek 之后发现用不了，即使你配置 wire_api="chat" 还是不行，当你修改了 wire_api="responses"，你会发现模型还是不能用，所以才会有这篇文章。

2. 准备工作

注意：本人电脑是 macOS 系统，Windows 系统仅供参考，相关脚本指令请自行查询

2.1 确保环境依赖

Node.js (>= v18)
npm
Go (>= v1.25)
git（非必需）
GitHub (Moon Bridge)

2.2 安装 Codex TUI 版本

sudo npm install -g @openai/codex

然后运行一次 codex，确保你的文件有这个 codex 的配置文件，一会儿要用得上。

codex --version
go version
node -v
git -v

cd ~/.codex
~/.codex ❯  ls

确保有 config.toml 文件

3. 获取 DeepSeek 的 API

登录 DeepSeek 官网，自己充值购买也不贵。

登录好之后点击左侧API Keys 然后创建即可保存好这个API Keys

4.下载Moon Bridge

Moon Bridge 是一个用 Go 编写的协议转换与模型路由代理。对外暴露 OpenAI Responses API（/v1/responses），对内支持 Anthropic Messages、Google Gemini（GenAI）、OpenAI Chat Completions 等多种上游协议。客户端指定不同模型别名时，自动将请求路由到对应上游 Provider 并在协议间自动转换。

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

4.1无法下载Moon Bridge

这里面有解决方案，我们本篇文章不在阐述。

5.配置Moon Bridge

进入Moon Bridge项目创建 config.yml 文件

vi config.yml

具体配置如下

mode: "Transform"

server:
  addr: "127.0.0.1:38440"

models:
  deepseek-v4-flash:
    context_window: 1000000
    max_output_tokens: 384000
    extensions:
      deepseek_v4:
        enabled: true
    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"

providers:
  deepseek:
    base_url: "https://api.deepseek.com/anthropic"
    api_key: "sk-your-deepseek-api-key"
    user_agent: "moonbridge/1.0"
    web_search:
      support: "auto"
    offers:
      - model: deepseek-v4-flash
        pricing:
          input_price: 2
          output_price: 8
          cache_write_price: 1
          cache_read_price: 0.2
        
routes:
  moonbridge:
    model: deepseek-v4-flash
    provider: deepseek

重要配置
1.Moon Bridge 映射端口

server:
  addr: "127.0.0.1:38440"

重要配置
2. DeepSeek 的 base_url (Anthropic) 地址和 API Key

base_url: "https://api.deepseek.com/anthropic"
api_key: "sk-your-deepseek-api-key"

重要配置
3. 模型名称

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

若你后期有图片需求，或者Web Search 或多 Provider 路由可以再参考 Moon Bridge 的 config.example.yml 扩展配置，这里不做过多阐述

6.启动 Moon Bridge

打开一个终端，并且常驻运行后台启动Moon Bridge

cd moon-bridge
pwd
go run ./cmd/moonbridge/main.go --config config.yml

启动后常驻后台，并且监听38440端口，他会提供 OpenAI Responses 兼容接口

7. 配置生成codex 配置文件

在 Moon Bridge 目录下生成 Codex 需要的配置文件

7.1 若你已经配置了codex，请将以下配置写到codex中

model_provider = "deepseek"
model = "deepseek-v4-flash"

[model_providers.deepseek]
name = "deepseek"
base_url = "http://127.0.0.1:38440/v1"
wire_api = "responses"

[model_properties."deepseek-v4-flash"]
context_window = 262144
max_context_window = 1048576
supports_parallel_tool_calls = true
supports_reasoning_summaries = true
input_modalities = ["text"]

7.2 若你没有配置codex按照以下步骤来

# 检查你的目录是否在moon-bridge文件夹中
pwd

# 检查文件夹
ls

# 准备存放codex配置文件
CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"

# 创建codex配置文件夹
mkdir -p "$CODEX_HOME_DIR"

# 获取模型然后存到 MODEL 变量里
MODEL="$(go run ./cmd/moonbridge --config config.yml --print-codex-model)"

# moonbridge生成Codex配置文件（告知Codex用哪个模型、连哪个 API 地址），然后保存
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"

7.2.1 检查是否配置成功

ls -la "$CODEX_HOME_DIR"

检查一下是否包含 config.toml 和 models_catalog.json

# 检查你的配置信息
cat ~/.codex/config.toml
# 可以修改里面的模型名称具体根据你个人喜好

8.启用codex

# 进入你的项目
cd xxxx/you_path/xxxxx

# 启动codex
CODEX_HOME="$CODEX_HOME_DIR" codex --cd "$PWD"

9. 额外功能

cd moon-bridge

cd scripts/

./start_codex_with_moonbridge.sh --project-diretory /xxxx/you_path/xxxx