跳至主要内容

Gemini CLI

Gemini CLI 官方未確認第三方 Base URL；目前只將 CC Switch 路徑記錄為已實作的相容入口。

設定前先確認​

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

官方來源與核驗​

本頁於 2026-07-13 依官方來源核驗 Gemini CLI 0.50.0。 官方來源. 相容性為 partial，不把未確認的直接環境變數寫成官方能力。

一鍵設定​

登入 PopGo API 金鑰頁，在目標 Key 所在列開啟操作選單。公開文件不會產生或顯示任何包含 Key 的跳轉連結。 依序選擇 CC Switch 與 Gemini。 完成 CC Switch 的 Gemini 匯入後，不要尋找本文未列出的直接變數。

手動設定​

沒有經官方確認的第三方 Base URL 手動方案，本頁不提供虛構環境變數。

  • 先確認 gemini --version 能執行；本頁只記錄 CC Switch 路徑，不寫未確認的 Base URL 變數。
  • 匯入後從新終端啟動 Gemini CLI，並確認目前會話實際使用匯入設定。

安裝與驗證補充​

  1. 先確認 node --version 與 npm --version，再依 Gemini CLI 官方安裝方式完成安裝。
  2. 執行 gemini --version，確認命令已加入 PATH；找不到命令時關閉舊終端後重試。
  3. 本文只記錄已核驗的 CC Switch 設定入口，不把來源不明的環境變數或固定模型寫入本機檔案。
  4. 匯入設定後從新終端啟動 Gemini CLI，使用 YOUR_MODEL 傳送一則短請求。

成功判斷​

CC Switch 匯入後從新終端啟動 Gemini CLI；能用 YOUR_MODEL 完成請求才算成功。

常見錯誤與恢復​

  • CC Switch 匯入失敗時依其教學恢復，不要改用來源不明的變數名稱。
  • 出現 401 時，重新貼上 YOUR_API_KEY 並檢查前後空白。
  • 出現 404 時，核對 Base URL 層級，避免用戶端重複附加 /v1。