Windows 和 Terminal下配置 Gemini API 环境变量教程（含一键启动命令）

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 模式」继续使用