2025 年 07 月 02 日
Windows 安裝 Gemini CLI
google-gemini/gemini-cli：一個開源的 AI 代理，可將 Gemini 的強大功能直接引入您的終端。?
一、前置條件
系統要求：Windows 7 及以上版本。
Node.js 環境：Gemini CLI 基于 Node.js 運行，需提前安裝 Node.js ，安裝時勾選 Add to PATH 選項，方便在命令行中使用 npm 命令。安裝完成后，在命令提示符中輸入 node -v 和 npm -v ，若能顯示版本號，說明安裝成功。
Node.js — Download Node.js??
?
二、安裝 Gemini CLI
打開命令提示符：按 Win + R 組合鍵，輸入 cmd 并回車，打開命令提示符窗口。
安裝 Gemini CLI：在命令提示符中輸入以下命令：
npm install -g @google/gemini-cli
等待命令執行，若出現 added xxx packages in xxxs 等類似信息，說明安裝成功。
輸入?gemini?啟動設置：
gemini
?
主題配置（可選）
當前界面是讓你選擇終端顯示主題，操作方式：
- 選主題：用上下箭頭鍵移動光標，選中喜歡的主題（如 ANSI Dark、Atom One Dark 等 ），按 Enter 確認。
- 應用范圍：下方 Apply To 可選 User Settings（僅當前用戶生效 ）或 Workspace Settings（工作區生效 ），選好按 Enter。
- 跳過配置：若不想改主題，直接按 Enter 用默認（Default 主題 ），或按 Ctrl + C 退出配置流程。
選完主題后，就能進入 Gemini CLI 主交互界面。
?
?
三、配置代理（若網絡允許訪問相關服務，可跳過此步驟）
由于 Gemini CLI 可能需要訪問特定網絡服務，若在本地網絡環境下無法正常訪問相關服務，可能需要進行網絡配置。此部分內容僅為假設性說明，在實際使用中，請確保你的網絡操作符合相關法律法規和服務使用條款。
?
方法一：臨時配置（僅當前命令行窗口生效）
如果你所在的網絡環境需要特定的代理設置，可在獲取合法合規的代理信息后，在命令提示符中輸入以下命令（將 7890 替換為實際端口號 ）：
set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890
如果使用的是 SOCKS5 協議，則輸入：
set HTTP_PROXY=socks5://127.0.0.1:7890
set HTTPS_PROXY=socks5://127.0.0.1:7890
?
方法二：永久配置（所有命令行窗口生效）
打開環境變量設置：右鍵點擊 “此電腦”，選擇 “屬性”，點擊 “高級系統設置”，在彈出的窗口中點擊 “環境變量”。
新建代理變量：在 “用戶變量” 或 “系統變量”（推薦用戶變量）中，點擊 “新建”，分別添加以下兩個變量：
- 變量名：HTTP_PROXY ，值：http://127.0.0.1:7890?（替換為實際代理信息）
- 變量名：HTTPS_PROXY ，值：http://127.0.0.1:7890
保存設置：點擊 “確定” 保存所有設置，重啟命令提示符使新環境變量生效。
?
?
四、驗證代理配置
在命令提示符中輸入以下命令測試代理是否生效：
curl -v http://google.com
若輸出中出現連接成功的信息（如 Connected to 相關內容 ），則說明代理配置成功；若仍提示連接失敗，需檢查代理設置和網絡環境。
?
?
五、登錄與認證 Gemini CLI
啟動 Gemini CLI：在命令提示符中輸入 gemini 并回車，啟動 Gemini CLI 。
選擇認證方式：啟動后會顯示認證方式選擇界面，常見的有 Login with Google （使用谷歌賬號登錄）、Gemini API Key (AI Studio) （使用 API 密鑰 ）、Vertex AI （使用谷歌云 Vertex AI 服務 ）。
Login with Google
選擇該選項并回車，按照提示操作，命令行界面會生成一個授權 URL ，復制該 URL 到瀏覽器打開（確保瀏覽器網絡環境允許訪問相關服務）。
登錄谷歌賬號并完成授權，將授權碼復制回命令行界面，完成登錄。
Gemini API Key (AI Studio)
https://aistudio.google.com/apikey?
訪問 Google AI Studio ，登錄谷歌賬號后，點擊右上角頭像，選擇 API Keys ，點擊 Create API Key 生成 API 密鑰 。
在命令行中輸入?gemini config set api_key 你的API_KEY?（將 “你的 API_KEY” 替換為實際生成的密鑰） ，完成配置。
三種認證方式介紹
?
- 1、Login with Google（推薦個人用戶）
適用場景：有谷歌賬號，想快速登錄使用。
操作步驟：
- 用上下箭頭選中 Login with Google，按 Enter。
- CLI 會彈出瀏覽器鏈接（或終端顯示授權 URL ），復制 URL 到瀏覽器打開。
- 登錄谷歌賬號，完成授權（需確保網絡環境允許訪問相關服務 ）。
- 授權成功后，瀏覽器會顯示一串 “授權碼”，復制粘貼回 CLI 終端，完成綁定。
?
- 2、Gemini API Key (AI Studio)
適用場景：已有 Gemini API Key（在 Google AI Studio 申請 ），適合開發者 / 企業場景。
操作步驟：
https://aistudio.google.com/apikey
- 選中 Gemini API Key (AI Studio)，按 Enter。
- 前往 Google AI Studio（需確保網絡環境允許訪問相關服務 ），登錄后創建 API Key。
- 把生成的 API Key 復制到 CLI 終端，按 Enter 完成配置。
set export GEMINI_API_KEY="YOUR_API_KEY"
?或新建變量名：?
GEMINI_API_KEY?變量值輸入Gemini API Key
?
- 3、Vertex AI
適用場景：用 Google Cloud Vertex AI 服務的企業用戶，需提前配置 GCP 項目、權限。
操作步驟： - 選中 Vertex AI，按 Enter。
- 確保本地已配置 Google Cloud SDK，并登錄 GCP 賬號。
- 終端會自動關聯 GCP 項目中的 Vertex AI 服務（需提前在 GCP 控制臺啟用 Gemini API ）。
優先推薦 “Login with Google” 流程
如果是個人使用，選 Login with Google 最方便，具體走一遍：
Please visit this URL to authorize: https://accounts.google.com/o/oauth2/auth?xxx...
?
處理底部 “error” 提示
看到底部?X1 error (ctrl+o for details)，先不用慌：
- 這是認證未完成導致的臨時錯誤，完成登錄授權后通常會自動消失。
- 若授權后還報錯，按 Ctrl + O 查看錯誤詳情（一般是網絡或授權失效問題，重新走一遍認證流程即可 ）。
認證后開始使用
完成認證后，就能進入 Gemini CLI 主界面，直接輸入問題 / 指令交互啦，比如：
write a Go function to read a JSON file
如果認證過程中遇到網絡問題，確保網絡環境正常，或換用 Gemini API Key 方式（提前申請 Key 更穩定 ）。
現在選一種認證方式，完成授權就能愉快用 Gemini 啦～
六、使用 Gemini CLI
登錄成功后，即可在命令行中與 Gemini 進行交互，例如輸入問題，獲取回答：
What is the weather like today?
注意事項
- 網絡問題：確保網絡環境穩定，若遇到連接超時、連接重置等問題，可嘗試檢查網絡設置、更換網絡環境等方法解決。
- 權限問題：在安裝 Node.js 和運行 Gemini CLI 時，建議以管理員身份運行命令提示符，避免因權限不足導致安裝或運行失敗。
- 認證問題：使用 Login with Google 方式登錄時，確保谷歌賬號正常可用，若授權過程中出現異常，可嘗試清除瀏覽器緩存、重新登錄谷歌賬號等操作。使用 API Key 方式時，注意保護好 API 密鑰，避免泄露。
- 更新問題：隨著 Gemini CLI 的更新，可能會出現新的特性或兼容性問題。可定期使用以下命令更新到最新版本 ：
npm update -g @google/gemini-cli
)
