搜索文档...

开始输入以搜索文档

Gemini
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

登录以自动填入您的 API 密钥

兼容性

Chat Completions流式传输工具调用图像输入

逐步设置

  1. 1
    安装 Gemini CLI

    使用 npm 全局安装 Gemini CLI。在 Windows 上,请在 WSL 内运行。

    bash
    npm install -g @google/gemini-cli

    登录以自动填入您的 API 密钥

  2. 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

    登录以自动填入您的 API 密钥

  3. 3
    启动 Gemini

    在项目目录中运行 `gemini` 以开始会话。

powershell
$env:GEMINI_API_KEY="YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL="https://api.unorouter.com"

gemini

登录以自动填入您的 API 密钥

推荐模型

在这里表现良好的免费模型。把任意模型 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 会话读取。
生成 API 密钥模型