安装 Gemini CLI（Windows）

本指南将帮助你在 Windows 系统上安装和配置 Gemini CLI。

第一步：安装 Gemini CLI

根据你的需求选择合适的安装方法：

方法一：全局安装（推荐）

打开 PowerShell 或命令提示符：

# 全局安装 Gemini CLI
npm install -g @google/gemini-cli
 
# 验证安装
gemini --version

方法二：使用 npx 直接运行

无需安装，直接使用：

# 每次使用时运行
npx @google/gemini-cli

方法三：Docker 沙箱部署

使用容器化方式获得更高的安全性：

# 使用 Docker
docker run -it gemini-cli
 
# 或使用本地 CLI 的沙箱模式
gemini --sandbox

Gemini CLI 是 Google 官方提供的命令行工具，支持 Gemini 3 Pro Preview 等最新模型，提供强大的推理和代码能力。

⚠️

如果遇到权限错误，请以管理员身份运行 PowerShell 再执行安装命令。

第二步：配置环境变量

方式一：使用 aihezu 一键配置（推荐）

使用 aihezu 工具快速配置，这是最简单的方法：

# 方式 1: 交互式安装（推荐，选择 gemini 选项）
npx aihezu install
 
# 方式 2: 直接指定服务
npx aihezu install gemini

执行后会提示输入 API Key 和 API URL（默认 https://cc.aihezu.dev/gemini），工具会自动在 ~/.gemini/.env 中配置好所有必需的环境变量。

企业用户可以在交互提示中输入独立域名（如 your-org.aihezu.dev），工具会自动补全为 https://your-org.aihezu.dev/gemini。Gemini 模式不修改 hosts，不需要管理员权限。

方式二：使用 PowerShell 设置

临时设置（当前会话）

$env:GEMINI_API_KEY = "你的API密钥"
$env:GOOGLE_GEMINI_BASE_URL = "https://cc.aihezu.dev/gemini"

永久设置

# 设置用户级环境变量（推荐）
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://cc.aihezu.dev/gemini", [System.EnvironmentVariableTarget]::User)
 
# 或设置系统级环境变量（需要管理员权限）
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://cc.aihezu.dev/gemini", [System.EnvironmentVariableTarget]::Machine)

方式三：使用图形界面设置

按 Win + R 键，输入 sysdm.cpl，按回车
在系统属性窗口中，点击 "高级" 选项卡
点击 "环境变量" 按钮
在 "用户变量" 区域点击 "新建"
分别添加以下变量：
- 变量名：GEMINI_API_KEY，变量值：你的API密钥
- 变量名：GOOGLE_GEMINI_BASE_URL，变量值：https://cc.aihezu.dev/gemini

⚠️

重要：使用方法二或方法三设置环境变量后需要重新启动命令提示符或 PowerShell 才能生效。企业用户请填写自己的独立域名（例如 https://your-org.aihezu.dev/gemini）。

第三步：验证安装

检查环境变量

重新打开 PowerShell：

# 检查环境变量是否设置正确
echo $env:GEMINI_API_KEY
echo $env:GOOGLE_GEMINI_BASE_URL

测试 Gemini CLI

# 测试基本功能
gemini "Hello, Gemini!"
 
# 使用特定模型
gemini --model gemini-2.5-flash "写一个 Python Hello World 程序"

常用命令

# 查看帮助信息
gemini --help
 
# 指定模型
gemini --model gemini-2.5-flash "你的问题"
 
# 交互式对话
gemini
 
# 从文件读取输入
Get-Content input.txt | gemini
 
# 沙箱模式（更安全）
gemini --sandbox "你的问题"

可用模型

我们支持以下 Gemini 模型：

gemini-2.5-flash: 快速响应的轻量级模型，适合日常使用
gemini-2.5-flash-lite: 更轻量的版本，速度更快、成本更低
gemini-2.5-pro: 专业版模型，支持更复杂的任务
gemini-3-pro-preview: 最新的预览版模型，提供最强大的能力

更多功能和使用方法请查看 Gemini CLI 官方文档 (opens in a new tab)。

系统要求

Node.js >= 14.0.0
Windows 10 或更高版本
稳定的网络连接

获取支持

遇到问题？我们提供专业技术支持：

💬 联系客服 - 一对一技术支持
🔍 清理缓存 - 清理本地缓存

恭喜！ 你已在 Windows 上成功安装 Gemini CLI，现在可以开始 AI 辅助开发了！