Codex CLI 使用 Responses API。開始前,請在 BearLab 建立使用者端專用 API 令牌,並從模型列表複製一個支援 Responses API 的完整模型 ID。

1. 檢查 Codex

如果命令不存在,請先按照 Codex 官方安裝說明完成安裝。

2. 開啟設定目錄

Win + R,輸入:
主要文件是 config.toml。如果目錄或文件不存在,可以手動建立;如果已經存在,先複製一份備份,不要覆蓋原有 MCP、沙箱或工作區設定。

3. 設定 BearLab Provider

將以下內容合併到 config.toml
亞太地區把 base_url 改為 https://bearlab.space/v1。將 your-responses-model 替換為 BearLab 模型列表中的實際模型 ID。

4. 設定 API 令牌

上述環境變數只在目前終端會話中生效,不會把真實 API 令牌寫入 config.toml

5. 測試對話

啟動 Codex 後傳送一條簡短訊息。能夠收到正常回覆,並且 BearLab 主控臺日誌中出現相同模型和時間的成功請求,即表示設定完成。

6. 常見問題

  • 401 Unauthorized:確認環境變數是在啟動 Codex 的同一個終端中設定的。
  • 403 Forbidden:檢查餘額、令牌分組和模型權限。
  • 404 Not Found:檢查 Base URL 是否重複填寫 /v1,以及模型是否支援 Responses API。
  • 仍使用官方帳號:檢查 model_provider = "bearlab",並完全退出後重新啟動 Codex。
  • 設定無法解析:執行 codex --help 核對目前版本,並檢查 TOML 引號和節名稱。
需要圖形化切換多個 Provider 時,使用 CC Switch 設定 Codex