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
相关推荐
XLYcmy1 天前
基于大语言模型的智能漏洞检测与修复系统 作品报告评审分析报告 上
llm·prompt·模糊测试·漏洞修复·漏洞检测·deepseek·消融实验
CS_Zero1 天前
DeepSeek V4.1 Flash 1017 (Batch) 新手极速上手指南
开发语言·batch·deepseek
大模型真好玩1 天前
大模型训练全流程实战指南实战篇(十八)——微调问答对数据构建技术
人工智能·agent·deepseek
我才是银古1 天前
chat-demo 源码解析与 DeepSeek 全家桶 API 能力盘点
ai·demo·deepseek
土豆12502 天前
dsh-orchestrator 介绍与使用实践:让你的 AI 从「一个人硬扛」到「带团队干活
llm·ai编程·deepseek
逐梦苍穹2 天前
DeepInfer 推理框架源码精讲:逐行读 DeepSeek 开源的推理引擎(2 小时 20 分视频+文字版)
人工智能·开源·ai编程·deepseek·claudecode·deepinfer·deepseekinfer
java_logo3 天前
Docker 部署 DeepSeek Harness(moelin):轻松搭建带登录的本地 AI Agent 平台
运维·docker·容器·ai agent·deepseek·harness·轩辕镜像
AI_Gump3 天前
Harness篇|DeepSeek Harness 上手机:五条安卓移植路线与 App 内 Linux 拆解
android·linux·人工智能·智能手机·deepseek
飞哥数智坊4 天前
打造自己的 Personal Agent,从抄大肥鱼作业开始
人工智能·deepseek