OpenAI Codex CLI 設定指南

概覽

Codex CLI 是 OpenAI 的終端機編碼代理，透過沙箱化、可審閱的修補檔在專案中讀取、寫入並執行程式碼。將其自訂供應商指向 UnoRouter 的基礎 URL，你就能用目錄中的任意模型來驅動它，而不僅限於 OpenAI 的模型。

快速設定

將這些值填入用戶端。登入後會自動填入你的金鑰。

基礎 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` 讓 Codex 指向 UnoRouter。設定你的模型 ID，並使用 responses wire API 加入一個使用 UnoRouter 基礎 URL 的自訂提供者。

   toml

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

   登入以自動填入 API 金鑰

3. 3
   加入 API 金鑰

   將你的 UnoRouter API 金鑰寫入 `~/.codex/auth.json`，讓 Codex 為每個請求進行認證。

   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 貼到用戶端即可。

注意事項

• !如果 Codex 回報不支援的端點，請確認 `wire_api` 設定為 `responses` 且基礎 URL 以 `/v1` 結尾。
• !401 表示 `~/.codex/auth.json` 中的金鑰遺失或已失效。請從 UnoRouter 儀表板貼上新金鑰並重新執行。