Gemini CLI 安装教程（Windows）

本文介绍在 Windows PowerShell 下安装 Gemini CLI 并接入 AI通道的完整步骤。

0. 前置：安装 Node.js

从 nodejs.org 下载 Node.js 22 LTS 安装包，按默认选项完成安装。新开 PowerShell 窗口后验证：

node -v
npm -v

1. 安装 Gemini CLI

Google 官方包名是 @google/gemini-cli：

npm install -g @google/gemini-cli
gemini --version

如遇到网络慢的情况，可切换镜像：

npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com

2. 配置 Gemini CLI 接入 AI通道

2.1 配置文件在哪里

Gemini CLI 读取以下文件：

• %USERPROFILE%\.gemini\.env —— 环境变量（API Key、Base URL 等）
• %USERPROFILE%\.gemini\settings.json —— 可选的偏好配置

2.2 创建配置目录

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.gemini"

2.3 写入 .env

$envContent = @'
GOOGLE_GEMINI_BASE_URL=https://aitongdao.com
GEMINI_API_KEY=sk-你的密钥
GEMINI_MODEL=gemini-2.5-pro
'@
Set-Content -Path "$env:USERPROFILE\.gemini\.env" -Value $envContent -Encoding UTF8

三个变量的含义：

• GOOGLE_GEMINI_BASE_URL：Gemini 协议端点，指向 AI通道域名，不带 /v1。
• GEMINI_API_KEY：从 AI通道「令牌」页获取的密钥，分组选 gemini。
• GEMINI_MODEL：默认模型，这里使用 gemini-2.5-pro。

2.4 可选：写入 settings.json

若想固化主题或默认交互偏好，可创建 settings.json：

$settings = @'
{
  "theme": "Default",
  "selectedAuthType": "gemini-api-key"
}
'@
Set-Content -Path "$env:USERPROFILE\.gemini\settings.json" -Value $settings -Encoding UTF8

3. 启动并验证

gemini --version
gemini "用一句话介绍你自己"

若返回正常，则整条链路打通。进入项目目录后直接执行 gemini 即可进入交互界面。

常见问题

gemini 命令未识别

全局 npm bin 目录未进入 PATH。运行 npm config get prefix 查看 npm 前缀，把它加到用户 PATH，再开新窗口。

.env 中的变量似乎没生效

确认文件路径是 %USERPROFILE%\.gemini\.env，文件名前有点号。另外避免使用 BOM，-Encoding UTF8 在 PowerShell 5 下会写入 BOM，建议用 PowerShell 7+ 或改用 [System.IO.File]::WriteAllText(...)。

返回 401 Unauthorized

检查 API Key 是否完整，以及创建令牌时分组是否选了 gemini。

想切换模型

修改 .env 的 GEMINI_MODEL 即可，比如临时切到其他 Gemini 版本。