Google Gemini CLI 是一款强大的AI编程工具，使用时通常需要配置模型名称、API 地址和密钥。Linux/macOS 用户常用 export 命令设置环境变量，而在 Windows 下则需使用 PowerShell 或 CMD 的方式。
✅ 一、环境变量说明
| 变量名 | 作用 |
|---|---|
GEMINI_MODEL |
指定使用的 Gemini 模型版本，如 gemini-2.5-pro |
GOOGLE_GEMINI_BASE_URL |
API 基础地址，若使用代理或本地转发服务可自定义 |
GEMINI_API_KEY |
API 密钥，用于身份验证，通常以 sk- 开头 |
🖥️ 二、在 Windows 中设置环境变量
方法一：临时设置（当前 PowerShell 会话有效）
$env:GEMINI_MODEL="gemini-2.5-pro"
$env:GOOGLE_GEMINI_BASE_URL="http://192.168.100.1:8000"
$env:GEMINI_API_KEY="sk-123456"方法二：永久设置（写入系统环境变量）
setx GEMINI_MODEL "gemini-2.5-pro"
setx GOOGLE_GEMINI_BASE_URL "http://192.168.100.1:8000"
setx GEMINI_API_KEY "sk-123456"⚠️ 注意：
setx设置后需重新打开终端才生效。
方法三：图形界面设置
- 打开「系统设置 → 系统 → 关于 → 高级系统设置」
- 点击「环境变量」
- 在“用户变量”中新增上述三个变量
🚀 三、一键启动 PowerShell 并设置环境变量
你可以使用以下命令快速启动 PowerShell 并自动设置 Gemini 环境变量：
powershell.exe -NoExit -Command `
"$env:GEMINI_MODEL='gemini-2.5-pro'; `
$env:GOOGLE_GEMINI_BASE_URL='http://testapi.com'; `
$env:GEMINI_API_KEY='sk-123456'; `
Write-Host '✅ Gemini 环境变量已设置，可以直接使用 gemini-cli 或相关命令' -ForegroundColor Green"
✅ 如果你还需要设置代理（如 HTTP/SOCKS5），可以在命令中加入：
$env:HTTP_PROXY='http://127.0.0.1:10808'; ` $env:HTTPS_PROXY='http://127.0.0.1:10808'; ` $env:ALL_PROXY='socks5://127.0.0.1:10808';
📂 四、可选：保存为启动脚本（.bat 文件）
将以下内容保存为 start-gemini.bat，双击即可启动：
@echo off
powershell.exe -NoExit -Command ^
"$env:GEMINI_MODEL='gemini-2.5-pro'; ^
$env:GOOGLE_GEMINI_BASE_URL='http://testapi.com'; ^
$env:GEMINI_API_KEY='sk-123456'; ^
Write-Host '✅ Gemini 环境变量已设置，可以直接使用 gemini-cli 或相关命令' -ForegroundColor Green"🧩 五、常见问题
| 问题 | 解决方案 |
|---|---|
| 环境变量设置后无效 | 确保使用的是当前终端会话或重启终端 |
| API 无响应 | 检查 GOOGLE_GEMINI_BASE_URL 是否正确，是否需要代理 |
| 密钥无效 | 登录 Google AI Studio 获取有效的 API Key |
运行 gemini 命令时跳转登录失败 |
第一次运行时可能会提示登录失败，此时请选择「API 模式」继续使用 |
