設定指南

中轉站設定指南

依工具瀏覽設定步驟與問題排查。

中轉站設定指南/Gemini CLI 配置

Gemini CLI 配置

Gemini CLI 是 Google 的終端 AI 工具。它適合在命令行裡使用 Gemini 進行問答、代碼理解和項目輔助。

官方信息 下載和文檔以官方站點為準
Gemini CLI 官方文檔 安裝、命令和配置入口 認證文檔 Google 登錄、Gemini API Key 和 Vertex AI GitHub 開源倉庫和版本信息

這個工具是什麼，用於什麼

Google Gemini終端工具Google 登錄Gemini API Key

先選認證方式

方式適合誰說明
Google 登錄個人用戶和新手運行 gemini 後按提示登錄
Gemini API Key已有 Google AI Studio Key 的用戶把 Key 放到 GEMINI_API_KEY
Vertex AI企業或雲項目用戶按 Google Cloud 項目和權限配置

API Key 怎麼測試

PowerShell 臨時測試
$env:GEMINI_API_KEY = "你的_Gemini_API_Key" gemini

測試成功後怎麼繼續

  1. 先在空目錄裡運行 Gemini CLI，不要直接打開重要項目。
  2. 只問一個固定短問題，確認模型能正常回覆。
  3. 再讓它閱讀一個測試文件，並明確要求不要修改文件。
  4. 如果要長期使用 API Key，再按 Gemini CLI 官方文檔把認證方式保存到本機環境或配置中。
  5. 如果切換過中轉站或 CC-Switch，重新打開終端後再測。
現象優先檢查處理
仍要求 Google 登錄當前認證方式是否是 Google 登錄流程先按 Gemini CLI 自身提示完成認證；API Key 和登錄流程不要混著排查
Key 無效GEMINI_API_KEY 是否屬於 Google AI Studio / Gemini不要把 OpenAI 或 Claude Key 填給 Gemini
模型不可用模型名是否來自 Gemini 列表不要把 OpenAI / Claude 模型名填到 Gemini CLI

中轉站配置要注意什麼

Gemini CLI 和 OpenAI 兼容中轉站不是一回事。只有當服務商明確寫了 Gemini CLI、Google Gemini 或 Vertex AI 的配置方法，才按它的教程操作。

不要把普通 OpenAI Base URL 填給 Gemini CLI。OpenAI、Claude、Gemini 是三套不同協議，服務商後臺如果分開提供地址，就必須填對應工具的那一個。
Gemini CLI 官方文檔 查看安裝、命令和配置入口。
Gemini CLI 認證文檔 查看 Google 登錄、Gemini API Key 和 Vertex AI。