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-CN.md