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