Codex Relay 安装与配置笔记
2026/6/1 23:05:59 网站建设 项目流程

1. 安装 codex-relay

pipinstallcodex-relay

当前版本:0.2.4

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

2. 配置环境变量

启动 relay 需要三个环境变量(脚本内均有默认值,可提前设置或直接使用默认值):

变量说明默认值
DEEPSEEK_API_KEYDeepSeek API 密钥sk-xxxxxx
CODEX_RELAY_PORTrelay 监听端口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

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询