1. 安装 codex-relay

pip install codex-relay

当前版本：0.2.4

安装位置：E:\software\miniconda3\Scripts\codex-relay.exe

2. 配置环境变量

启动 relay 需要三个环境变量（脚本内均有默认值，可提前设置或直接使用默认值）：

脚本 start-codex-relay.bat 会在未设置时自动使用以上默认值。

3. 启动脚本

start-codex-relay.bat 内容：

@echo off
chcp 65001 >nul
title Codex-Relay :%CODEX_RELAY_PORT%

set "PATH=E:\software\miniconda3\Scripts;E:\software\miniconda3;%PATH%"

if "%CODEX_RELAY_UPSTREAM%"=="" set "CODEX_RELAY_UPSTREAM=https://api.deepseek.com/v1"
if "%CODEX_RELAY_PORT%"==""    set "CODEX_RELAY_PORT=4446"
if "%DEEPSEEK_API_KEY%"==""    set "DEEPSEEK_API_KEY=sk-xxxxxxx"

echo Starting codex-relay on port %CODEX_RELAY_PORT%, upstream %CODEX_RELAY_UPSTREAM% ...
codex-relay --upstream "%CODEX_RELAY_UPSTREAM%" --api-key "%DEEPSEEK_API_KEY%" --port %CODEX_RELAY_PORT%
pause

双击运行即可启动 relay。

4. Codex CLI 配置

编辑 ~/.codex/config.toml：

model = "deepseek-v4-pro"
model_provider = "deepseek-relay"

[model_providers."deepseek-relay"]
name = "DeepSeek"
base_url = "http://127.0.0.1:4446/v1"
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 5
stream_idle_timeout_ms = 600000

可用的模型属性

通过 codex-relay --print-config 可获取上游完整的模型信息：

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

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/v1"
wire_api = "responses"
env_key = "DEEPSEEK_API_KEY"

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

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

注意：走 relay 模式时，model_properties 由 relay 自动向上游协商，Codex 侧无需手动配置。只需保证 base_url 指向 relay 即可。

5. 工作流程

Codex CLI  →  127.0.0.1:4446 (codex-relay)  →  https://api.deepseek.com/v1
                  (Responses API)                    (Chat Completions API)

• relay 负责将 Codex 使用的 OpenAI Responses API 翻译为上游的 Chat Completions API
• DeepSeek 原生是 Chat Completions API，通过 relay 即可让 Codex CLI 接入

6. 确认 relay 运行正常

启动后应看到类似输出：

INFO  codex_relay: codex-relay listening on 127.0.0.1:4446 → https://api.deepseek.com/v1
INFO  codex_relay: upstream models: deepseek-v4-flash, deepseek-v4-pro