Gemini CLI

Google 官方的 Gemini 命令行客户端。

💡 如果你想用 OpenAI SDK / Anthropic SDK 调 Gemini 模型，不需要装 Gemini CLI——直接用同一把 Key 配 base_url 就行。详见 API 直接调用 §5。

1. 安装

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

# 或下载二进制
# https://github.com/google-gemini/gemini-cli/releases

验证:

gemini --version

2. 配置

通过环境变量配置:

macOS / Linux — 写入 ~/.zshrc / ~/.bashrc:

export GEMINI_API_KEY=sk-你的key
export GEMINI_BASE_URL=https://www.miloapi.com/v1beta

source 一下让它持久。

Windows PowerShell:

$env:GEMINI_API_KEY = "sk-你的key"
$env:GEMINI_BASE_URL = "https://www.miloapi.com/v1beta"

⚠️ Gemini CLI 的 base URL 后缀是 /v1beta(Google 的协议),不是 /v1。

⚠️ Key 选 gemini 分组。

3. 验证

gemini "hello"

或进入交互模式:

gemini

4. 故障排查

现象处理
Bad Request: invalid endpoint检查 base URL,必须以 /v1beta 结尾,不要带 /v1
Unsupported model用当前可用模型名（gemini-3.1-pro-preview / gemini-2.5-flash 等），完整清单见 侧栏 → 可用渠道
流式不工作加 --stream 参数,或检查上游网络
Quota exceeded余额不够或者分组 RPM 满了,等几秒重试

5. 可用模型

稳定版

模型说明
gemini-2.5-pro当前稳定旗舰，1M 上下文，支持思考模式
gemini-2.5-flash快速、便宜，支持思考模式
gemini-2.5-flash-lite最小最便宜，适合规模化调用
gemini-2.0-flash老一代 Flash，仍可用

预览版（Gemini 3 系列）

模型说明
gemini-3-pro-previewGemini 3 Pro 预览
gemini-3-flash-previewGemini 3 Flash 预览
gemini-3-pro-image-previewGemini 3 Pro 图像生成预览
gemini-3.1-pro-previewGemini 3.1 Pro 预览（当前最强）
gemini-3.1-flash-image-previewGemini 3.1 Flash 图像生成
gemini-3.1-flash-lite-previewGemini 3.1 Flash Lite 预览

⚠️ Gemini 3 系列是 Google 通过 Code Assist 渠道下发的预览模型，Miloapi 网关会自动声明合适的客户端身份让 Google 后端识别。如果某个客户端测试时报 404 Requested entity was not found，先升级网关版本（>=0.1.128）。

老模型名（gemini-pro / gemini-1.5-pro / gemini-1.5-flash）已停止接入，请使用上表的当前可用模型名。

最近更新：: