Gemini CLI
Gemini CLI 集成
在 Gemini CLI 以及任意 Google GenAI 兼容客户端中使用 UnoRouter。在 Claude 和 GPT 之外同样可以访问 Gemini 模型。
概览
Gemini CLI 是 Google 的开源编码代理,可直接在终端中编辑文件并运行命令。将 UnoRouter 设为它的基础 URL,你便能用一个 OpenAI 兼容密钥访问 Gemini、Claude、GPT 以及其他所有模型,而无需仅限 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设置环境变量
创建包含 UnoRouter API 密钥的 `~/.gemini/.env`,并将 `GOOGLE_GEMINI_BASE_URL` 设置为 UnoRouter 的裸基础 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 粘贴到客户端即可。
ministral-8b-2512mistral-nemo-instruct-2407mistral-vibe-cli-fastmagistral-medium-2509cydonia-24b-v4.3
注意事项
- 如果请求返回 404,说明你在基础 URL 中添加了路径。`GOOGLE_GEMINI_BASE_URL` 必须是不带 `/v1` 后缀的裸主机,其余部分由 SDK 附加。
- 如果认证失败,请确认 `~/.gemini/.env` 中的 `GEMINI_API_KEY` 是你的 UnoRouter 密钥,并且该文件被你的 shell 会话读取。