OpenAI Codex CLI 設定指南

概覽

Codex CLI 是 OpenAI 為終端機打造的編碼代理程式。它透過沙箱化、可審閱的修補檔來讀取、撰寫並執行程式碼。把自訂供應商指向 UnoRouter 的基礎網址，即可使用目錄中的任何模型。

快速設定

把這些貼進用戶端。已登入時會自動填入你的金鑰。

基礎 URL: https://api.unorouter.com/v1
API 金鑰: YOUR_API_KEY

相容性

逐步設定

1. 1
   安裝 Codex CLI

   用 npm 全域安裝 Codex CLI。

   bash

   npm install -g @openai/codex

   登入以自動填入 API 金鑰

2. 2
   設定模型提供者

   編輯 `~/.codex/config.toml`。設定模型 id，並用 responses 線路 API 新增一個指向 UnoRouter 基礎網址的自訂供應商。

   toml

   # ~/.codex/config.toml
   model = "YOUR_MODEL_ID"
   model_provider = "unorouter"
   
   [model_providers.unorouter]
   name = "UnoRouter"
   base_url = "https://api.unorouter.com/v1"
   wire_api = "responses"

   登入以自動填入 API 金鑰

3. 3
   加入 API 金鑰

   把 UnoRouter 的 API 金鑰寫入 `~/.codex/auth.json`。

   json

   // ~/.codex/auth.json
   {
     "OPENAI_API_KEY": "YOUR_API_KEY"
   }

   登入以自動填入 API 金鑰

4. 4
   啟動 Codex

   在專案目錄中執行 `codex`。

   bash

   codex

   登入以自動填入 API 金鑰

$env:OPENAI_BASE_URL="https://api.unorouter.com/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

codex

推薦模型

在這裡可用的免費模型。把任意模型 id 貼進用戶端即可。

注意事項

• !出現端點不支援的錯誤時，請確認 `wire_api` 是 `responses`，且基礎網址以 `/v1` 結尾。
• !401 表示 `~/.codex/auth.json` 裡的金鑰缺少或已失效。請從 UnoRouter 主控台貼上新的金鑰。
• !若 Codex 忽略你的供應商，請檢查 `config.toml` 中的表格名稱。供應商 ID 允許底線，不允許連字號（`model_providers.my_provider` 可以，`my-provider` 不行）。`openai` 是保留名稱，無法覆寫。