跳至主要内容

Codex App + CLI

Codex App 與 CLI 共用本機 Provider 設定，並透過 Responses wire API 連接 PopGo API。

設定前先確認​

  • 本頁只寫預留值；實際 Key 從 PopGo API 金鑰頁複製，模型從模型與價格頁複製。
  • 一鍵設定適合已安裝並註冊協定的軟體；瀏覽器提示開啟外部應用程式時，需要允許一次。
  • 手動設定時先保存最小 Provider，第一個請求成功後再啟用串流、工具呼叫或多模型路由。

官方來源與核驗​

本頁於 2026-07-14 依官方來源核驗 Codex App + CLI 0.144.4。 官方來源. 核驗範圍包含官方自訂 Provider 結構，以及 App 與 CLI 共用的本機設定。

一鍵設定​

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

手動設定​

先在終端設定 POPGO_API_KEY，再將以下 Provider 設定寫入 Codex 設定檔；App 與 CLI 不必重複設定。

export POPGO_API_KEY="YOUR_API_KEY"
$env: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"
  • 設定檔通常位於使用者目錄下的 .codex/config.toml；Windows 是 %USERPROFILE%\.codex\config.toml，macOS/Linux 是 ~/.codex/config.toml。
  • 金鑰透過 POPGO_API_KEY 環境變數讀取，不要把真實 Key 寫進 config.toml 或公開截圖。

跨平台安裝與設定補充​

  1. 先檢查 node --version 與 npm --version，再依 Codex 官方安裝方式安裝 CLI。
  2. 設定檔通常位於 Windows 的 %USERPROFILE%\.codex\config.toml，或 macOS/Linux 的 ~/.codex/config.toml。
  3. 在啟動 Codex 的同一終端設定 POPGO_API_KEY，不要把真實 Key 寫入設定檔：
$env:POPGO_API_KEY = "YOUR_API_KEY"

設定中的 model 使用即時模型 ID，model_provider 必須與 Provider 設定區塊名稱一致，env_key 必須寫成 POPGO_API_KEY，wire_api 使用 responses。修改後重新啟動 App 或 CLI。

成功判斷​

從已設定環境變數的終端啟動 CLI，或重新開啟 App，並以 YOUR_MODEL 傳送請求。

常見錯誤與恢復​

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