JiuRelay 领取 API KEY

SETUP GUIDE · CODEX

不登录 ChatGPT，把 Codex 接到免费第三方 API

config.toml 直接配置 约 3 分钟配完 最后更新

一句话回答

在 ~/.codex/config.toml 里新增一个自定义 model_provider： base_url 填 https://jiurelay.com/openai/v1（带 /v1）， env_key 指向存放免费 Key 的环境变量，模型填 5.2（Free 线路）或 grok-4.5（Grok 线路），重开终端执行 codex 就能用， 不需要登录 ChatGPT 账号，也不需要 OpenAI 官方 API Key。 Key 在 JiuRelay 首页免费领取，无需注册、无需绑卡， 有效期 Free 3 小时、Grok 2 小时，有效期内不设 token 总量与总请求次数上限； 需要在领取后 15 分钟内完成首次调用，否则会被自动吊销。

config.toml 完整示例

~/.codex/config.toml

model = "5.2"            # Grok 线路填 "grok-4.5"
model_provider = "jiurelay"

[model_providers.jiurelay]
name = "JiuRelay"
base_url = "https://jiurelay.com/openai/v1"
env_key = "JIURELAY_API_KEY"
wire_api = "responses"   # 报解析错误就换 "chat"

导出 Key（写进 ~/.zshrc 或 ~/.bashrc）

export JIURELAY_API_KEY="首页领取的 Key"
Base URL
模型 ID
5.2 或 grok-4.5，按领取的线路填

base_url 要带 /v1：与 OpenAI 官方默认值一致，Codex 会自己在后面拼 /responses 或 /chat/completions。config.toml 各字段的完整说明见 Codex 官方文档。

不想手改 TOML？用 CC Switch 可以图形化管理 Codex 供应商并一键切换。

本站提供 OpenAI 协议兼容端点，并非 OpenAI 官方接口；实际可用模型以接口实时返回为准。

四步配完

01

领取免费 Key

回首页选 Free 或 Grok 线路一键领取。无需注册，Key 只显示一次，请立刻复制。

02

编辑 config.toml

按上方示例写入 ~/.codex/config.toml，注意 model_provider 与表名一致。

03

导出 Key 重开终端

export JIURELAY_API_KEY=… 写进 shell 配置。Codex 只在启动时读配置。

04

15 分钟内试跑

执行 codex 问一句话。超过 15 分钟没调用，Key 会被自动吊销。

常见问题

接第三方 API 后还要登录 ChatGPT 吗？

不需要。配置自定义 model_provider 并用 env_key 提供 Key 后，Codex 直接调第三方端点，不走 ChatGPT 登录，也不需要 OpenAI 官方 API Key、不消耗 Plus 订阅额度。

wire_api 填 responses 还是 chat？

都支持：本站同时实现了 /v1/responses 与 /v1/chat/completions。建议先用 responses（Codex 新版默认协议）；如果遇到流式解析报错或输出异常，换成 chat 再试 —— 两条端点后面是同一个模型。

base_url 末尾带不带 /v1？

带。填 https://jiurelay.com/openai/v1，Codex 会自己拼接资源路径。不要多写成 /v1/（多个斜杠）或 /v1/v1，也不要漏掉 —— 这两种错都表现为 404。

模型填 5.2 还是 grok-4.5？

看你在首页领的是哪条线路的 Key：Free 线路的 Key 配 5.2，Grok 线路的 Key 配 grok-4.5。Key 和模型 ID 是绑定的，混填会报模型不存在或认证失败。两条线路都走 OpenAI 协议，Codex 都能用。

改了配置为什么不生效？

Codex 只在启动时读取 config.toml，改完必须重开终端或重新执行 codex。仍不生效按顺序查：① model_provider = "jiurelay" 与 [model_providers.jiurelay] 表名是否一致；② TOML 语法是否合法（等号两边、引号配对）；③ echo $JIURELAY_API_KEY 确认变量在当前终端真的有值。

报 401 认证失败怎么排查？

按顺序查四点：① 环境变量名与 env_key 写的名字是否完全一致；② Key 是否复制完整、前后无空格；③ Key 是否已过期 —— Free 3 小时 / Grok 2 小时，401 最常见原因就是过期；④ 领取后是否超过 15 分钟才首次调用（会被自动吊销）。确认后回首页重新领取。

免费 Key 有 token 或次数上限吗？

限制只在时间上：Free 3 小时、Grok 4.5 2 小时，到期自动失效。不设 token 总量上限，也不设总请求次数上限，有效期内可以连续跑任务。高峰时段共享额度可能临时限速（429），等几十秒重试，不要立刻反复重发。需要更长有效期可通过推广计划兑换长效 Key。

Claude Code 也想这样配，方法一样吗？

思路一样但参数不同：Claude Code 走 Anthropic 协议，Base URL 填 https://jiurelay.com/anthropic（不带 /v1），用环境变量而不是 config.toml。完整步骤见 Claude Code 配置教程。