Gemini 模型名稱不代表使用者端協定一定相容。接入前必須同時確認：模型在令牌分組中可見、使用者端使用的協定，以及 BearLab 對應端點是否回傳該模型。
Gemini CLI、模型和協定必須相符。先確認模型列表，再傳送最小產生請求；不要只根據模型名稱判斷協定。

​
Gemini CLI 能直接使用嗎？

只有使用者端版本允許自訂 Gemini Base URL，並且目標模型支援 Gemini 原生 generateContent 協定時才可以。先驗證 BearLab 原生模型端點：
若目標模型只出現在 OpenAI 相容 /v1/models，應改用 Cline、OpenCode、AionUI 等支援 OpenAI-compatible Provider 的使用者端，不能只改 GEMINI_MODEL 強行呼叫。

​
通過 CC Switch 設定 Gemini CLI

  1. 在 CC Switch 頂部選擇 Gemini。
  2. 新增“自訂設定”，名稱填寫 BearLab AI。
  3. Base URL 填 https://bearlab.ai；亞太地區填 https://bearlab.space。
  4. API Key 使用單獨建立的 BearLab 令牌。
  5. 模型填寫 /v1beta/models 回傳的準確 ID。
  6. 儲存並啟用 Provider，然後完全退出並重啟 Gemini CLI。
核心變數如下：
不要把 BearLab API Key 填入 Google OAuth 登入框，也不要覆蓋已有 Google 帳號憑證。

​
在 Cline 中使用 Gemini 模型

當目標模型提供 OpenAI 相容協定時：
  1. 在 VS Code 擴充功能市場安裝並開啟 Cline。
  2. 進入 API Configuration。
  3. Provider 選擇 OpenAI Compatible。
  4. Base URL 填 https://bearlab.ai/v1；亞太地區填 https://bearlab.space/v1。
  5. API Key 填 BearLab 專用令牌。
  6. Model ID 填 /v1/models 回傳且令牌分組可見的準確 ID。
  7. 儲存後傳送一條短文字請求，再逐步啟用文件和命令工具。
OpenAI-compatible 模式走 /v1/chat/completions 或使用者端支援的相容端點，不等同於 /v1beta/...:generateContent。

​
Windows、macOS 與 Linux 有什麼差異？

在 PowerShell 和 VS Code 整合式終端分別檢查 GOOGLE_GEMINI_BASE_URL、GEMINI_API_KEY 與 GEMINI_MODEL，避免系統環境與 IDE 環境不一致。

​
401、403、404 怎麼排查？

  • 401：API Key 沒有注入、已失效，或誤用了 Google OAuth 憑證。
  • 403：令牌分組無模型權限、餘額不足或策略拒絕。
  • 404：協定路徑不相符，或模型 ID 不在對應模型列表中。
  • 回傳 HTML：Base URL 很可能填成了主控臺頁面，而不是 API 根位址。
  • 能列模型但不能產生：該模型可能只支援另一種協定；檢查模型能力標籤和請求路徑。

​
為什麼 CC Switch 啟用後仍走舊位址？

  1. 完全退出 Gemini CLI，而不是只關閉一個終端標籤。
  2. 新開終端檢查 GOOGLE_GEMINI_BASE_URL、GEMINI_API_KEY、GEMINI_MODEL。
  3. 排查 shell 設定、IDE 啟動環境和 CC Switch 是否同時寫入不同值。
  4. 確認 CC Switch 頂部目前選擇的是 Gemini 分支，而不是其他使用者端。
  5. 關閉接管後再次比較原設定驗證和，確認沒有殘留覆蓋。

​
截圖和日誌怎樣脫敏？

API Key、使用者 ID、存取令牌、帳號郵箱、本機絕對路徑和其他 Provider 名稱都應遮蓋。排錯時保留版本、請求路徑、HTTP 狀態、請求 ID、模型 ID 和時間即可。