#Gemini CLI

Gemini CLI 使用 Gemini 原生 API。自定义 Base URL 的环境变量和支持范围可能随版本变化，因此请记录版本并先做最小验证。

#1. 安装

npm install -g @google/gemini-cli
gemini --version

#2. 配置凭据和服务地址

export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://getrouter.ai"

不同版本可能使用不同的自定义 Endpoint 设置。如果当前版本忽略 GOOGLE_GEMINI_BASE_URL，请停止配置并核对该版本官方文档，不要通过 Hosts 劫持实现。

#3. 选择模型

从模型目录复制兼容 Gemini API 的 MODEL_ID。可在当前版本支持时使用：

gemini --model MODEL_ID

#最终请求路径

Gemini 客户端通常会请求：

POST https://getrouter.ai/v1beta/models/MODEL_ID:generateContent

认证可能通过 x-goog-api-key 或 ?key= 发送，GetRouter 均支持。

#4. 验证

gemini --model MODEL_ID "只回复：连接成功"

再依次测试流式输出、文件上下文、工具调用和多模态输入。每项能力都取决于模型与当前 CLI 版本。

#常见问题

• 请求仍发往 Google 官方域名： 当前版本没有读取自定义 Base URL。
• 404： 检查最终路径是否包含 /v1beta/models/，以及模型 ID 是否被正确编码。
• 401 / 403： 检查 GEMINI_API_KEY、Key 限制和认证传递方式。
• 普通文本成功但文件或工具失败： 单独验证模型多模态和 Function Calling 能力。