Codex CLI

Codex 的配置写在一个文件里：

macOS / Linux：~/.codex/config.toml
Windows：%userprofile%\.codex\config.toml

Codex CLI 和 Codex Desktop 共用这个文件，配置一次两边都能用。

1. 复制配置

打开 Hub 的 API 密钥，在要用的密钥旁点 使用密钥。
选 Codex CLI 标签，再选你的系统：macOS / Linux 或 Windows。
按需调整下面几个选项，然后复制生成的 config.toml。

认证模式

模式	说明
API Key Mode（默认，推荐）	密钥直接写在 `config.toml` 里，Codex 自带的本地图片生成也能用。
兼容模式	旧的写法：密钥另外放在 `auth.json` 里。之前已经这样配置过、不想改动时使用。

选兼容模式时，Hub 会多给一个 auth.json，和 config.toml 放在同一个目录。

使用 WebSocket

勾选后，多轮对话共用一条长连接，响应更快。遇到断流或连不上时，取消勾选，重新复制配置即可。

模型目录

Codex 需要知道有哪些模型可选：

远程目录（默认，需要 Codex 0.156.0 或更新版本）：Codex 会用你的密钥自动从 Rabah 获取模型列表，以后新增的模型也会自动出现。
本地文件（旧版 Codex）：点 获取目录 → 下载目录，把下载的 codex-models.json 保存到 ~/.codex/ 目录。

如果模型目录太大，超过了远程目录的大小上限，Hub 会自动切换成本地文件。

2. 写入配置文件

如果 .codex 目录还不存在，先创建它：

macOS / Linux：在终端运行 mkdir -p ~/.codex
Windows：按 Win+R，输入 %userprofile%，在打开的文件夹里新建 .codex 文件夹

然后把复制的内容粘贴到 config.toml：

文件不存在：新建并粘贴。
文件已经有内容：把复制的内容放在文件最开头。TOML 格式要求，不带 [...] 标题的设置项必须写在所有 [...] 段落之前，放在后面会被当成上一个段落的内容。

生成的配置大致是这个结构，完整内容以 Hub 生成的为准：

model_provider = "OpenAI"
model = "gpt-5.6-sol"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.rabah.ai/v1"
wire_api = "responses"
requires_openai_auth = false
experimental_bearer_token = "你的密钥"

3. 重启 Codex

保存后，完全退出 Codex Desktop 或 CLI 再重新打开，然后新建一个任务。只开新对话不够：Codex 要在启动时重新读取配置。

换模型和线路

在 Codex 里切换模型，或者改 config.toml 中 model = 那一行。
想走指定线路，模型名写成 模型名:线路代号，详见指定模型和线路。

常见问题

提示认证失败（401） 检查 experimental_bearer_token 或 auth.json 里的密钥是否完整，以及这个密钥在 Hub 里是否已停用、过期或额度用完。

改了配置没生效 确认已经完全退出 Codex 再打开。另外，config.toml 开头的设置项如果被放在了某个 [...] 段落后面，也不会生效。

模型列表是空的，或者缺模型 确认 Codex 版本在 0.156.0 以上，或者改用本地文件。另外检查密钥的”线路与模型”是不是只勾选了部分模型。