giip

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 密鑰設置

  1. Google AI Studio 中頒發 API 密鑰。
  2. 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 的
    Antigravity
    配合使用,可以構建由 Gemini 負責分析、Antigravity 負責執行的協同模型。

疑難排解

症狀原因解決
執行
npm install -g @google/generative-ai-cli
時提示找不到命令
未安裝 Node.js 或未註冊到 PATH安裝最新的 Node.js LTS 後重新開啟終端
執行
gemini-cli
時出現認證 (401) 錯誤
未設置
GOOGLE_API_KEY
或密鑰無效
設置
$env:GOOGLE_API_KEY
,並在 Google AI Studio 中重新頒發密鑰
重新啟動後
GOOGLE_API_KEY
遺失
僅在當前工作階段中設置了環境變數在系統環境變數中永久註冊
GOOGLE_API_KEY
Gemini CLI 無法引用 GIIP 基礎設施元資料
cli-config.json
設定缺失或錯誤
檢查並修正代理資料夾中
cli-config.json
的值

版本: 1.0 最後更新: 2026-03-19 源文件:

giipv3/public/help/agent-setup-win-gemini.zh-TW.md