• UnoRouterUNOROUTER
文档
  • AI 应用
编程智能体
  • opencodeOpenCode 设置指南
  • Kilo CodeKilo Code 设置指南
  • Zed IDE 设置指南
  • ClineCline 设置指南
  • RooCodeRoo Code 设置指南
  • continue-devContinue.dev 设置指南
角色与虚构客户端
  • SillyTavernSillyTavern 集成指南
  • janitor-aiJanitor.AI 集成指南
  • risuaiRisuAI 集成指南
  • Chub / Venus 集成指南
  • nevikaNevika 集成指南
聊天客户端
  • librechatLibreChat 集成指南
  • OpenWebUIOpen WebUI 集成指南
  • LobeHubLobeChat 集成指南
  • AnythingLLM 集成指南
  • CherryStudioCherry Studio 集成指南
  • typingmindTypingMind 集成指南
  • BoltAI 集成指南
  • Page Assist 集成指南
  • chatboxChatbox 集成指南
  • Big-AGI 集成指南
命令行工具
  • aiderAider 设置指南
  • cc-switchCC Switch 集成指南
  • Claude CodeClaude Code 集成
  • CodexOpenAI Codex CLI 配置指南
  • GeminiGemini CLI 集成
  • openclawOpenClaw 集成
  • Hermes AgentHermes Agent 集成
  • ModelContextProtocolMCP 服务器设置指南
导航
  • 模型
  • 排行榜
  • 检测器
  • 价格
  • 对话
  • 状态

搜索文档...

开始输入以搜索文档

平台集成聊天
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` 以开始会话。

    bash
    gemini

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

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

gemini

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

推荐模型

在这里表现良好的免费模型。把任意模型 ID 粘贴到客户端即可。

agnes-2.0-flash:freeallam-2-7b:freebielik-11b-v3.0-instruct:freecodestral-latest:freecommand-r:free

注意事项

  • !如果请求返回 404,说明你在基础 URL 中添加了路径。`GOOGLE_GEMINI_BASE_URL` 必须是不带 `/v1` 后缀的裸主机,其余部分由 SDK 附加。
  • !如果认证失败,请确认 `~/.gemini/.env` 中的 `GEMINI_API_KEY` 是你的 UnoRouter 密钥,并且该文件被你的 shell 会话读取。
生成 API 密钥模型

本页目录

概览
快速配置
兼容性
设置步骤
安装 Gemini CLI
设置环境变量
启动 Gemini
推荐模型
注意事项