Codex CLI

Codex CLI 是 OpenAI 官方的命令列編碼代理，透過 ~/.codex/config.toml 定義模型供應商。把自訂 provider 指向 aicentos，即可在終端機裡使用 aicentos 接入的模型。

如果你更想用圖形化方式管理多套設定，也可以走 CC Switch 一鍵切換；本文只講手動設定。

準備工作复制锚点链接

先在控制台「API Key」頁面為 Codex CLI 建立一個專用 Key（建議命名 codex-cli，方便追蹤用量）：

• 控制台：https://aicentos.com
• 建立 Key：https://aicentos.com/keys
• 餘額不足時儲值：https://aicentos.com/wallet

確認已安裝 Codex CLI：

codex --version

需要填寫的設定复制锚点链接

設定步驟复制锚点链接

1. 設定 API Key 環境變數复制锚点链接

export AICENTOS_API_KEY="sk-你的-API-Key"

需要永久生效就寫進 ~/.zshrc 或 ~/.bashrc，然後 source 一下，並用 echo $AICENTOS_API_KEY 確認。

2. 編輯 config.toml复制锚点链接

在 ~/.codex/config.toml 中加入：

model = "你的模型名"
model_provider = "aicentos"

[model_providers.aicentos]
name = "aicentos"
base_url = "https://aicentos.com/v1"
env_key = "AICENTOS_API_KEY"
wire_api = "responses"

把 你的模型名 換成控制台「模型廣場」中列出的模型名稱，可參考 支援的模型。

3. 啟動 Codex复制锚点链接

codex

發一條簡單請求，確認 provider 正常運作。

測試复制锚点链接

codex exec "用一句話回答：1+1 等於幾"

能正常返回內容即接入成功，返回的內容會消耗少量額度，可在控制台用量日誌裡核對。

注意事項复制锚点链接

• Base URL 只填到 /v1，不要補成 /v1/chat/completions 的完整路徑。
• base_url、env_key 等欄位只在使用者層級 ~/.codex/config.toml 生效。寫在專案內的 .codex/config.toml 會被忽略，並可能出現啟動警告。
• wire_api 填 responses，對應 aicentos 的 Responses 介面。官方文件目前只支援該取值；若你的版本回報 unknown variant，表示 CLI 過舊，建議先升級。
• openai、ollama、lmstudio 是保留的 provider ID，不能透過改寫內建 openai 的 base_url 來指向第三方閘道，必須新起一個 provider 名稱（本文用的是 aicentos）。
• 排查順序：模型名稱是否與控制台一致 → Base URL 是否只到 /v1 → 環境變數在啟動 codex 的那個終端機裡是否可見 → 帳戶餘額是否充足。

相關連結复制锚点链接

• 接入 Codex（CC Switch 方式）