Windows + Gemini CLI 設置指南
引導您如何在 Windows 終端中直接利用 Google Gemini 強大的分析能力,並將其與 GIIP 平台聯動。
📋 概述
Gemini CLI 是一款基於終端的 AI 對話工具,常用於查詢 GIIP 平台數據或創建並執行本地腳本。它特別針對通過大語言模型 (LLM) 分析複雜的系統日誌進行了優化。
🛠️ 安裝與設置步驟
1. 前置要求
- Node.js: 必須安裝最新的 LTS 版本。
- Google Cloud 帳戶: 需要專案 ID 及 API 存取權限。
2. 安裝 CLI
在 Windows 命令提示字元 (CMD) 或 PowerShell 中執行以下命令:
npm install -g @google/generative-ai-cli
3. 認證與 API 密鑰設置
- 在 Google AI Studio 中頒發 API 密鑰。
- 將
添加到系統環境變數中,或在執行時作為參數傳遞。GOOGLE_API_KEY$env:GOOGLE_API_KEY="your-api-key"
4. GIIP 聯動設置
修改 GIIP 代理資料夾內的
cli-config.json,使 Gemini CLI 能夠引用來自 GIIP 的基礎設施元資料。
🚀 應用範例
- 日誌分析:
gemini-cli "分析 error.log 文件中的致命錯誤" - 腳本生成:
gemini-cli "編寫一個檢查伺服器狀態的 PowerShell 腳本" - 基礎設施查詢: 與 GIIP API 聯動,在終端中即時查看特定伺服器的規格。
💡 技巧
- 通過
查看更多選項。gemini-cli --help - 與 GIIP 的
配合使用,可以構建由 Gemini 負責分析、Antigravity 負責執行的協同模型。Antigravity
疑難排解
| 症狀 | 原因 | 解決 |
|---|---|---|
執行 時提示找不到命令 | 未安裝 Node.js 或未註冊到 PATH | 安裝最新的 Node.js LTS 後重新開啟終端 |
執行 時出現認證 (401) 錯誤 | 未設置 或密鑰無效 | 設置 ,並在 Google AI Studio 中重新頒發密鑰 |
重新啟動後 遺失 | 僅在當前工作階段中設置了環境變數 | 在系統環境變數中永久註冊 |
| Gemini CLI 無法引用 GIIP 基礎設施元資料 | 設定缺失或錯誤 | 檢查並修正代理資料夾中 的值 |
版本: 1.0 最後更新: 2026-03-19 源文件:
giipv3/public/help/agent-setup-win-gemini.zh-TW.md