Gemini CLI

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

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-3.1-pro-preview旗舰模型
gemini-2.5-flash快速、便宜
gemini-2.0-flash-exp实验版

老名字(gemini-pro / gemini-1.5-pro 等)会自动映射到当前最新版,可以直接用。