Gemini CLI 閘道設定

先確認 Gemini 原生介面

網站維護中。以下僅為規劃中的設定教學；api.ubtl.net 是預定網域，未執行真實 API 測試，不代表已能使用 Gemini CLI 連線。使用前須確認原生 Gemini 協定、實際路徑、驗證方式與模型識別碼。

這份範例採用 GOOGLE_GEMINI_BASE_URL 與 GEMINI_API_KEY，目的地必須是原生 Gemini 閘道，不能直接替換成 OpenAI 聊天請求網址。先退出工具，備份任何準備修改的既有設定，並檢查目前是否選用其他驗證模式。不同 CLI 版本的閘道辨識與登入介面可能不同，應以安裝版本的說明為準，而不是假設所有畫面一致。

以工作階段環境變數設定

GOOGLE_GEMINI_BASE_URL 使用預定根網址 https://api.ubtl.net，由 SDK 組合供應商請求路徑。不要憑印象附加 /v1、/v1beta 或 /v1/chat/completions。以下 Bash 與 PowerShell 範例擇一使用，先確認已安裝的 Gemini CLI 能讀取相應變數，再從同一終端機啟動工具。

此處的金鑰只是佔位符。日後應使用獨立、可撤銷的 API key，避免覆寫其他專案的 Gemini 憑證，並保護 shell 歷史與設定備份。若版本要求選擇驗證方式，依其文件使用 Gemini API key 模式；不要把 Google OAuth 登入是否成功當作自訂閘道的驗證結果，也不要混入不相關的 Claude 或 Codex 憑證。

Bash 規劃設定 · bash

export GOOGLE_GEMINI_BASE_URL='https://api.ubtl.net'
export GEMINI_API_KEY='YOUR_UBTL_API_KEY'
gemini

PowerShell 規劃設定 · powershell

$env:GOOGLE_GEMINI_BASE_URL = 'https://api.ubtl.net'
$env:GEMINI_API_KEY = 'YOUR_UBTL_API_KEY'
gemini

重新啟動並檢查模型與路徑

重新啟動後先核對設定是否被讀取；若使用新的終端機，必須先重新載入同一組變數。只有服務確認可用後，才在該版本支援的模型選擇流程中以已確認的識別碼取代 YOUR_MODEL_ID，傳送一段不含機密的簡短提示。遇到驗證錯誤先檢查 API key 與驗證模式，遇到路徑錯誤先檢查根網址與 SDK 版本，遇到模型錯誤先核對權限。不要在回報中公開金鑰；還原時移除新變數並恢復備份。