Gemini CLI 安装与配置教程
这篇教程说明如何把 Google 的 Gemini CLI 接到 HRouter。Gemini CLI 通过三个环境变量配置：Base URL、Key 和模型。HRouter 支持当前开放的 Gemini 模型，具体以你的 Key 返回的列表为准。
最省事的做法是用 HRouter Desktop：选择 Gemini CLI，输入 Key，点击“识别 Key”并保存即可。下面是手动配置方法。
开始前
- 一个可用的 HRouter Key，分组包含 Gemini 模型。分组怎么选见 如何选择 Key 分组。
- 已安装 Gemini CLI（需要 Node.js 环境，见 Claude Code 安装教程 第 1 步）。
连接参数
| 项目 | 值 |
|---|---|
| Base URL | https://hrouter.net（站点根地址，不带 /v1） |
| Key | 你的 HRouter sk-... |
| 模型 | 当前 Key 返回的 gemini-* 模型 |
手动配置
Mac / Linux
export GOOGLE_GEMINI_BASE_URL="https://hrouter.net"
export GEMINI_API_KEY="sk-xxxxx"
export GEMINI_MODEL="从当前 Key 返回的 Gemini 模型"
要长期生效，把这三行写入 ~/.zshrc 或 ~/.bashrc，然后 source 一下。
Windows PowerShell
$env:GOOGLE_GEMINI_BASE_URL = "https://hrouter.net"
$env:GEMINI_API_KEY = "sk-xxxxx"
$env:GEMINI_MODEL = "从当前 Key 返回的 Gemini 模型"
获取最新模型
Google 的模型名称会更新，不要长期照抄旧版本号。用 HRouter Desktop 的“识别 Key”，或者直接请求：
curl https://hrouter.net/v1/models \
-H "Authorization: Bearer $HROUTER_API_KEY"
从结果中选择 gemini-* 模型，详见 查询可用模型。
验证
设置好后运行 gemini，发送一句最短的测试消息，再到 使用记录 确认请求出现。
常见问题
没有 Gemini 模型？ 当前 Key 的分组尚未开通 Google 模型权限，见 API 403 报错。
返回 401？ Key 错误或已禁用，见 API 401 报错。
返回 404？ 确认 Base URL 是站点根地址，没有重复添加接口路径，见 404 路径错误。
模型失效？ 重新获取列表并切换到当前开放的 Gemini 模型，见 model_not_found。