OpenAI Codex CLI 設定指南

概覽

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

快速設定

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

基礎 URL: https://api.routerah.app/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 新增一個指向 Routerah 基礎網址的自訂供應商。

   toml

   # ~/.codex/config.toml
   model = "YOUR_MODEL_ID"
   model_provider = "routerah"
   
   [model_providers.routerah]
   name = "Routerah"
   base_url = "https://api.routerah.app/v1"
   wire_api = "responses"
   env_key = "OPENAI_API_KEY"

   登入以自動填入 API 金鑰

3. 3
   匯出你的 API 金鑰

   匯出 env_key 所指定的那個變數。Codex 會從環境變數讀取自訂供應商的金鑰；auth.json 只用於登入 OpenAI。

   bash

   export OPENAI_API_KEY="YOUR_API_KEY"

   登入以自動填入 API 金鑰

4. 4
   啟動 Codex

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

   bash

   codex

   登入以自動填入 API 金鑰

$env:OPENAI_BASE_URL="https://api.routerah.app/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

codex

推薦模型

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

注意事項

• !出現端點不支援的錯誤時，請確認 `wire_api` 是 `responses`，且基礎網址以 `/v1` 結尾。
• !如果請求處於未驗證狀態，請檢查 env_key 指定的變數在執行 codex 的 shell 中是否真的已經匯出。
• !你無法把保留 ID openai 重複用於自訂供應商。換成其他任意 ID 都可以，無論是在 model_providers 中還是在 model_provider 中。