本教學按照“選擇應用、新增 Provider、啟用設定、啟動驗證”的順序完成 Codex 接入，全程不需要手動編輯設定文件。

​
準備工作

  1. 安裝 Codex CLI 和 CC Switch。
  2. 在 BearLab 主控臺建立一個使用者端專用 API 令牌。
  3. 確認該令牌可以看到支援 Responses API 的模型。
  4. 完全退出正在執行的 Codex CLI。
切換 Provider 會改寫 Codex 設定。操作前按照通用設定備份 ~/.codex/config.toml 和 ~/.codex/auth.json。

​
新增 BearLab Provider

  1. 開啟 CC Switch。
  2. 在頂部應用切換欄選擇 Codex。
  3. 點擊右上角 +，選擇 自訂 Provider。
  4. 名稱填寫 BearLab AI。
  5. API Key 填寫剛建立的 BearLab API 令牌。
  6. API 請求位址按服務區域填寫：
  1. 預設模型填寫 BearLab 模型列表中支援 Responses API 的完整模型 ID。
  2. 點擊 新增。
Base URL 末尾只保留一個 /v1。模型 ID 區分大小寫，不要根據模型顯示名稱自行縮寫。

​
啟用並驗證

  1. 回傳 Provider 列表，找到剛新增的 BearLab AI。
  2. 點擊 啟用，確認卡片顯示 使用中。
  3. 完全退出並重新開啟終端。
  4. 執行：
  1. 傳送一條簡短訊息。收到正常回覆後，再到 BearLab 主控臺日誌中核對請求時間、模型和狀態。
CC Switch 顯示“使用中”只說明設定已經寫入。只有 Codex 收到回覆，且 BearLab 日誌中出現對應成功請求，才表示接入完成。

​
常見問題

  • 401：API 令牌無效、複製不完整，或仍在使用舊驗證資訊。
  • 403：令牌分組、餘額或模型權限不滿足要求。
  • 404：Base URL 重複填寫 /v1，或模型不支援 Responses API。
  • 仍存取官方 Provider：完全退出 Codex，檢查 CC Switch 目前卡片是否為“使用中”。
  • 切換後無變化：退出後臺駐留的 Codex 或編輯器，再重新啟動。
如需檢視額度，繼續閱讀用量查詢。如需手動設定，閱讀Codex CLI。