Codex CLI 中转站配置

本页只讲 Codex CLI 怎么接入 HRET API 中转站。优先用方式 1 的 CC Switch，一键带入 API 密钥、接口地址和模型；只有 CC Switch 打不开时，再用方式 2 手动配置。

推荐顺序

先完成 Codex CLI 安装教程，再回到本页配置中转站。安装和中转站配置分开看，不容易混。

先装 CC Switch App

方式 1 需要本机已经安装 CC Switch 桌面应用。如果还没安装，先打开 CC Switch Releases 下载页下载对应系统的安装包，然后再回到 HRET API 的「API 密钥」页面点击「CC 切换」。

方式 1：CC Switch（推荐）

这是新手优先使用的方式。你不需要手动复制 OPENAI_API_KEY，也不需要自己判断 OPENAI_BASE_URL 怎么填。

打开 API 密钥列表

找到给 Codex 用的密钥

可以使用已有密钥，也可以单独创建一个名称为 codex-cli 的 API 密钥，后续排查用量会更清楚。

点击右侧「...」菜单

在密钥这一行最右侧点击「...」，菜单里选择「CC 切换」。

应用选择 Codex

弹窗顶部选择 Codex。名称可以用默认值，也可以改成你容易识别的名字。

选择可用模型

主模型是必填项。打开下拉框，选择当前可用模型即可；模型列表会随你的 HRET API 配置动态变化。

打开 CC Switch

点击「打开 CC Switch」。浏览器或系统如果询问是否打开外部应用，选择允许。

方式 2：手动配置（备用）

只有 CC Switch 打不开，或者你明确想自己维护环境变量时，才使用手动方式。

Terminal

# 中转站 API 密钥
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"

# 中转站地址，通常以 /v1 结尾
export OPENAI_BASE_URL="https://your-relay-domain.com/v1"

# 可选：默认模型，填写当前可用模型名称
export CODEX_MODEL="your-available-model"

手动配置检查

手动配置时只检查三件事：API 密钥是否正确、接口地址是否以 /v1 结尾、模型名是否是当前可用模型。

测试是否生效

配置完成后，在终端里发一个简单问题：

Terminal

codex "用一句话解释一下 ls -la 命令"

能正常回复就完成了

如果 Codex 能正常回复，说明 API 密钥、接口地址、可用模型和 CC Switch 配置都已经生效。