Gemini CLI

Google 官方的终端 Agent。快米兔 API 提供 Gemini 原生 /v1beta 协议，可以直接把 Gemini CLI 指过来。

安装

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

需要 Node.js ≥ 20。

配置快米兔 API

Gemini CLI 用两个环境变量：API Key 和 Base URL。

zsh / bash

export GEMINI_API_KEY="<您的令牌>"
export GOOGLE_GEMINI_BASE_URL="https://api.52pay.com"

# 持久化
echo 'export GEMINI_API_KEY="<您的令牌>"' >> ~/.zshrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.52pay.com"' >> ~/.zshrc
exec $SHELL

Windows PowerShell

[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "<您的令牌>", "User")
[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.52pay.com", "User")
# 关闭 PowerShell 重开

Fish Shell

set -Ux GEMINI_API_KEY "<您的令牌>"
set -Ux GOOGLE_GEMINI_BASE_URL "https://api.52pay.com"

不要加 /v1beta

Gemini SDK 会自己拼 /v1beta/models/<model>:generateContent。 GOOGLE_GEMINI_BASE_URL 只填到域名。

首次启动会问你登录方式

Gemini CLI 启动时会让你选认证方式，选「Use Gemini API Key」，不要选 Google 账号登录（那条路会走官方 Code Assist 端点，绕过你配置的 Base URL）。

如果已经误登过，删掉 ~/.gemini/oauth_creds.json 再重开。

验证

gemini -p "Reply with exactly one word: pong"

curl 层面的验证：

curl "https://api.52pay.com/v1beta/models/gemini-3-pro-preview:generateContent" \
  -H "x-goog-api-key: <您的令牌>" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"ping"}]}]}'

日常使用

cd ~/your-project

# 交互模式
gemini

# 一次性
gemini -p "总结这个仓库的架构"

# 指定模型
gemini -m gemini-3-pro-preview
gemini -m gemini-3.5-flash

# 把整个目录塞进上下文（Gemini 强项：百万上下文）
gemini -p "@src/ 找出所有没有错误处理的地方"

支持的模型

模型 ID	定位	上下文
gemini-3.1-pro-preview	最新旗舰推理	1M
gemini-3-pro-preview	旗舰，代码/数理强	1M
gemini-3.5-flash	均衡快速档	1M
gemini-3.1-flash-lite	极致低价高并发	1M
gemini-3-flash-preview	快速档	256K
gemini-2.5-pro	上一代旗舰	1M
gemini-2.5-flash / -lite	上一代快速档	1M

图像生成模型（gemini-3-pro-image、gemini-3.1-flash-image 等）见 模型与分组。

建议令牌选 Gemini 分组。

也可以走 OpenAI 兼容协议

如果你的工具链只认 OpenAI 格式，Gemini 系模型同样可以用 /v1/chat/completions 调：

curl https://api.52pay.com/v1/chat/completions \
  -H "Authorization: Bearer <您的令牌>" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3-pro-preview","messages":[{"role":"user","content":"ping"}]}'

两条路的计费一致，区别只在于：原生 /v1beta 能用到 Gemini 特有的字段（thinkingConfig、safetySettings、多模态 inlineData 等）。

常见错误

现象	原因 / 处理
仍然要求 Google 账号登录	启动时选错认证方式，删 ~/.gemini/oauth_creds.json 重来
404	Base URL 多加了 /v1beta
API key not valid	令牌写错，或环境变量没生效（echo $GEMINI_API_KEY 确认）
无可用渠道	令牌分组里没有该 Gemini 模型
请求被安全策略拦截	Gemini 的 safetySettings，见 原生 API 调用

配套阅读

• 原生 API 调用
• 模型与分组