1. 安装 codex-relay
pipinstallcodex-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内容:
@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