Gemini CLI
Gemini CLI 集成
把 UnoRouter 用于 Gemini CLI 以及任何 Google GenAI 兼容客户端。
概览
Gemini CLI 是 Google 的开源编程智能体，可在终端中编辑文件并执行命令。把 UnoRouter 设为它的基础 URL，就能用一个 OpenAI 兼容密钥访问全部模型，而不必依赖仅限 Google 的账号。
快速配置
把这些粘贴到客户端。已登录时会自动填入你的密钥。
text
基础 URL: https://api.unorouter.com
API 密钥: YOUR_API_KEY兼容性
Chat Completions流式传输工具调用图像输入
逐步设置
- 1安装 Gemini CLI
使用 npm 全局安装 Gemini CLI。在 Windows 上，请在 WSL 内运行。
bashnpm install -g @google/gemini-cli - 2设置环境变量
创建 `~/.gemini/.env` 并写入 UnoRouter 的 API 密钥。把 `GOOGLE_GEMINI_BASE_URL` 设为不带路径的基础 URL。Gemini SDK 会自行追加路径，所以不要加 `/v1`。
bash# ~/.gemini/.env GEMINI_API_KEY=YOUR_API_KEY GOOGLE_GEMINI_BASE_URL=https://api.unorouter.com - 3启动 Gemini
在项目目录中运行 `gemini`。
bashgemini
powershell
$env:GEMINI_API_KEY="YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL="https://api.unorouter.com"
gemini推荐模型
在这里可用的免费模型。把任意模型 id 粘贴到客户端即可。
ox-alpha:freeglm-5.3-search:freeglm-5.3-think-search:freeglm-5.3-thinking:freeglm-5.3:free
注意事项
- 404 表示基础 URL 上带了路径。`GOOGLE_GEMINI_BASE_URL` 必须是不带 `/v1` 后缀的裸主机名，其余部分由 SDK 追加。
- 认证失败时，确认 `~/.gemini/.env` 中的 `GEMINI_API_KEY` 是你的 UnoRouter 密钥，并确认 shell 会读取该文件。