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