通过兼容接口运行 Codex CLI：新手配置步骤

#1 · 准备密钥和模型标识

通过兼容 OpenAI 的接口运行 Codex CLI，需要配置接口地址、密钥和模型标识。Relay365 提供按量付费的多模型转接服务，适合希望集中管理模型调用的用户。

先在控制台生成密钥，确认余额，并查看适用于 Codex 的模型及接入说明。可以从 GPT-6 Astra 开始，但配置时要复制控制台给出的实际模型标识，不要直接用展示名称猜测。

#2 · 安装并检查命令

安装 Node.js 和 npm 后，在终端执行 npm install -g @openai/codex，再执行 codex --version，确认命令可用。若安装失败，先检查当前版本的运行环境要求。

#3 · 设置密钥环境变量

在 macOS 或 Linux 终端执行：export RELAY365_API_KEY='你的密钥'。

在 Windows PowerShell 中执行：$env:RELAY365_API_KEY='你的密钥'。

这些设置只对当前终端会话生效。请在同一个终端启动 Codex，不要把密钥写进项目文件或提交到代码仓库。

#4 · 配置服务地址

打开用户目录下的 .codex/config.toml；不存在时创建。已有配置请先备份，并合并相关字段，避免重复声明。按以下顺序逐行填写：

model = "替换为控制台中的实际模型标识"

model_provider = "relay365"

[model_providers.relay365]

name = "Relay365" · base_url = "https://api.api365relay.com/v1" · env_key = "RELAY365_API_KEY" · wire_api = "responses"

Relay365 的基础地址是 https://api.api365relay.com，OpenAI 兼容客户端使用时添加 /v1。这里填写接口根地址，不要继续追加具体请求路径。

#5 · 启动并验证连接

进入一个测试项目目录，执行 codex，先要求它概述目录结构。检查启动信息中的模型与服务配置，再到 Relay365 控制台核对调用记录。

兼容 OpenAI 接口不代表所有模型都能运行 Codex。Codex 需要相应的 Responses 接口和工具调用支持，应以 Relay365 当前的模型能力说明为准。

#6 · 根据错误逐项排查

• 认证失败：检查密钥及环境变量是否在当前终端生效。
• 路径错误：检查地址中的 /v1，并确认服务支持 Responses 接口。
• 模型不可用：核对实际模型标识、账户权限和余额。
• 工具调用失败：确认所选模型支持 Codex 所需能力。

如果你希望按量使用模型，并集中管理 Codex、Claude Code、Gemini CLI 或 OpenAI SDK 的调用，可以创建一个 Relay365 账户，先用小任务验证配置，再逐步投入日常开发。