Gemini CLI Windows 安装指南前置要求 Windows 10 或更高版本 Node.js 环境（版本 1

前置要求

Windows 10 或更高版本
Node.js 环境（版本 18 或更高）
有效的 UniVibe API 密钥

注册UniVibe API 密钥点击注册注册即可获得 6000积分

安装步骤

1. 安装 Node.js 环境

Gemini CLI 需要 Node.js 环境才能运行。

方法一：官网下载（推荐）

打开浏览器访问 https://nodejs.org/
点击 "LTS" 版本进行下载（推荐长期支持版本）
下载完成后双击 .msi 文件
按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

验证 Node.js 安装

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

node --version
npm --version

如果显示版本号，说明安装成功了！

Windows 注意事项：

建议使用 PowerShell 而不是 CMD
如果遇到权限问题，尝试以管理员身份运行
某些杀毒软件可能会误报，需要添加白名单

2. 安装 Gemini CLI

打开 PowerShell 或 CMD，运行以下命令：

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

这个命令会从 npm 官方仓库下载并安装最新版本的 Gemini CLI。

验证 Gemini CLI 安装

安装完成后，输入以下命令检查是否安装成功：

gemini --version

如果显示版本号，恭喜你！Gemini CLI 已经成功安装了。

提示：

建议使用 PowerShell 而不是 CMD，功能更强大
如果遇到权限问题，以管理员身份运行 PowerShell

3. 获取 API 密钥

4. 设置环境变量

为了让 Gemini CLI 连接到 UniVibe 服务，需要设置两个环境变量：

方法一：PowerShell 临时设置（当前会话）

在 PowerShell 中运行以下命令：

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

💡 记得将 你的API密钥 替换为在上方 API Keys 标签页中创建的实际密钥。

方法二：PowerShell 永久设置（用户级）

在 PowerShell 中运行以下命令设置用户级环境变量：

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.univibe.cc/gemini", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)

查看已设置的环境变量：

# 查看用户级环境变量
[System.Environment]::GetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("GEMINI_API_KEY", [System.EnvironmentVariableTarget]::User)

💡 设置后需要重新打开 PowerShell 窗口才能生效。

方法三：系统环境变量设置（图形界面）

打开 系统属性 → 高级 → 环境变量
在 用户变量 中点击新建，添加以下变量：
- 变量名：GEMINI_API_KEY，变量值：你的 UniVibe API 密钥
- 变量名：GOOGLE_GEMINI_BASE_URL，变量值：https://api.univibe.cc/gemini
点击确定保存
重新打开 PowerShell 或 CMD 使配置生效

验证环境变量设置

设置完环境变量后，可以通过以下命令验证是否设置成功：

在 PowerShell 中验证：

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY

在 CMD 中验证：

echo %GOOGLE_GEMINI_BASE_URL%
echo %GEMINI_API_KEY%

预期输出示例：

https://api.univibe.cc/gemini
cr_xxxxxxxxxxxxxxxxxx

💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。

5. 开始使用 Gemini CLI

现在你可以开始使用 Gemini CLI 了！

启动 Gemini CLI

gemini

首次启动配置

首次启动 Gemini CLI 时，会出现配置界面：

使用**方向键↓（下键）**选中 "Use Gemini API Key" 选项
按下回车键确认选择
提示输入 API Key 时，直接按回车（因为已经通过环境变量设置了）
进入对话界面，即可开始使用

在特定项目中使用

# 进入你的项目目录
cd C:\path\to\your\project

# 启动 Gemini CLI
gemini

6. 使用 Gemini 3 Pro 模型 🚀

Gemini CLI 支持强大的 Gemini 3 Pro 模型，提供更优秀的编程辅助能力。

启用 Gemini 3 Pro 模型

在 Gemini CLI 对话界面中按照以下步骤操作：

第一步：启用预览功能

输入命令：/settings
找到 Preview Features 选项
将其切换为 true
按 ESC 键退出设置

第二步：切换模型

输入命令：/model
选择 Pro (gemini-3-pro-preview, gemini-2.5-pro) 模型
确认后即可使用 Gemini 3 Pro 模型

可用的 Gemini 模型

模型名称	描述	适用场景
Gemini 3 Pro Preview	最新的 Gemini 3 Pro 预览版	复杂编程任务、算法优化、架构设计
Gemini 2.5 Pro	Gemini 2.5 专业版	日常编程开发、代码审查、问题解决
Gemini Flash	快速响应模型	简单查询、快速代码补全、即时问答

💡 提示： Gemini 3 Pro 模型提供最强大的推理能力，适合处理复杂的编程任务和架构设计。

Windows 常见问题解决

安装时提示 "permission denied" 错误

这通常是权限问题，尝试以下解决方法：

以管理员身份运行 PowerShell
或者配置 npm 使用用户目录：npm config set prefix %APPDATA%\npm

PowerShell 执行策略错误

如果遇到执行策略限制，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

环境变量设置后不生效

设置永久环境变量后需要：

重新启动 PowerShell 或 CMD
或者注销并重新登录 Windows
验证设置：echo $env:GOOGLE_GEMINI_BASE_URL

防火墙问题

确保防火墙允许 Gemini CLI 访问网络。

启动时无法连接到服务

如果遇到连接问题，检查：

环境变量是否正确设置
API 密钥是否有效
网络连接是否正常

Gemini CLI Windows 安装指南