Gemini CLI

Gemini CLI 使用 Google Gemini 原生 generateContent 接口。猫咖啡 API 的 Gemini 网关地址使用主域名 https://coffeecatbox.cc。

安装

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

也可直接运行：

npx @google/gemini-cli

检查版本：

gemini --version

配置 .env

Gemini CLI 会查找项目或用户目录中的 .gemini/.env。用户级配置：

• macOS、Linux、WSL：~/.gemini/.env
• Windows：%USERPROFILE%\.gemini\.env

GOOGLE_GEMINI_BASE_URL=https://coffeecatbox.cc
GEMINI_API_KEY=sk-你的令牌
GEMINI_MODEL=控制台中的 Gemini 模型 ID

地址不带 /v1beta

Gemini CLI 会自行拼接 API 版本与 models/...:generateContent 路径。GOOGLE_GEMINI_BASE_URL 只填主域名。

启动

cd /path/to/your/project
gemini

也可临时指定模型：

gemini -m "控制台中的 Gemini 模型 ID"

非交互测试：

gemini -p "只回复 OK" --output-format json

配置优先级

模型选择一般按以下顺序生效：

1. --model 命令行参数；
2. GEMINI_MODEL 环境变量；
3. settings.json 中的模型配置；
4. 工具默认模型。

修改 .env 后退出并重新启动 Gemini CLI。

常见问题

工具仍要求 Google 登录

确认 .env 文件路径正确、变量名无拼写错误，并在同一终端中检查环境变量。GOOGLE_GEMINI_BASE_URL 存在时，新版 Gemini CLI 会使用 Gateway 模式。

401 未授权

确认 GEMINI_API_KEY 使用猫咖啡 API 令牌，不是 Google AI Studio Key。

404 模型不存在

使用控制台中支持 Gemini 原生协议的准确模型 ID，不要照抄其他服务商的 Gemini 模型名。

/v1beta/v1beta 重复

Base URL 填了路径后缀。改回 https://coffeecatbox.cc。