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 以上，或者改用本地文件。另外檢查密鑰的”線路與模型”是不是只勾選了部分模型。