外观
Gemini CLI
Gemini CLI 是 Google 推出的终端 AI 助手,使用 Gemini 原生接口格式。
准备工作
创建一个提供 Gemini 模型的分组的令牌。当前提供 Gemini 模型的分组:
支持 Gemini 的分组
安装
bash
# 需要 Node.js 20 及以上
npm install -g @google/gemini-cli配置
推荐把环境变量写到 Gemini CLI 会自动读取的 ~/.gemini/.env 文件(Windows 为 C:\Users\你的用户名\.gemini\.env):
ini
GOOGLE_GEMINI_BASE_URL=https://vip.zen-ai.top
GEMINI_API_KEY=sk-xxxxxxxx再在 ~/.gemini/settings.json 中指定使用 API Key 认证:
json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
},
"model": {
"name": "gemini-3.5-flash"
}
}说明
GOOGLE_GEMINI_BASE_URL不要加/v1或/v1beta。- 较旧版本的 Gemini CLI 使用顶层字段
"selectedAuthType": "gemini-api-key",如果上面的写法不生效可以改用它。 - 也可以直接用
export(macOS / Linux)或setx(Windows)设置这两个环境变量。
启动与验证
bash
cd your-project
gemini
# 或临时指定模型
gemini -m gemini-3.5-flash会话中输入 /model 可以切换模型。当前 gemini-cli 分组可用的模型(点击复制):
常见问题
启动后仍要求登录 Google 账号 检查 settings.json 中的认证方式是否为 gemini-api-key,以及 .env 文件位置是否正确。
API key not valid / 401 确认 GEMINI_API_KEY 填写的是本站令牌,并且没有被系统中其他同名环境变量覆盖。
模型不可用 Gemini CLI 默认模型可能不在令牌分组内,请用 -m 参数或 settings.json 指定上面列出的模型。