Codex Relay 安装与配置笔记

1. 安装 codex-relay

bash 复制代码

pip install codex-relay

当前版本：0.2.4

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

2. 配置环境变量

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

变量	说明	默认值
`DEEPSEEK_API_KEY`	DeepSeek API 密钥	`sk-xxxxxx`
`CODEX_RELAY_PORT`	relay 监听端口	`4446`
`CODEX_RELAY_UPSTREAM`	上游 API 地址	`https://api.deepseek.com/v1`

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

3. 启动脚本

start-codex-relay.bat 内容：

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：

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 可获取上游完整的模型信息：

toml 复制代码

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