跳至主要内容

Codex CLI

Codex CLI 使用自訂 model_provider 與 Responses wire API。

官方來源與核驗​

本頁於 2026-07-13 依官方來源核驗 Codex CLI 0.144.3。 官方來源. 核驗範圍為官方設定檔中的自訂 Provider 結構。

一鍵設定​

登入 PopGo API 金鑰頁，在目標 Key 所在列開啟操作選單。公開文件不會產生或顯示任何包含 Key 的跳轉連結。 依序選擇 CC Switch 與 Codex。 匯入 Codex 設定後，檢查 Base URL 為 /v1 層級。

手動設定​

先在終端設定 POPGO_API_KEY，再將以下 Provider 設定寫入 Codex 設定檔。

export POPGO_API_KEY="YOUR_API_KEY"
model = "YOUR_MODEL"
model_provider = "popgo"

[model_providers.popgo]
name = "PopGo"
base_url = "https://api.popgo.site/v1"
env_key = "POPGO_API_KEY"
wire_api = "responses"

成功判斷​

從已設定環境變數的終端啟動新會話，並以 YOUR_MODEL 傳送請求。 使用 YOUR_MODEL 發起全新測試請求。收到正常內容且沒有驗證或位址錯誤，即可判定連線成功。

常見錯誤與恢復​

  • 提示缺少 Key 時，確認變數名稱為 POPGO_API_KEY，並從目前終端重新啟動。
  • 出現 401 時，重新貼上 YOUR_API_KEY 並檢查前後空白。
  • 出現 404 時，核對 Base URL 層級，避免用戶端重複附加 /v1。