主题
Gemini CLI 教程
Gemini CLI 需要支持 Gemini 原生协议的密钥分组。
1. 安装
安装 Node.js 后运行：
bash
npm install -g @google/gemini-cli
gemini --version2. Windows PowerShell 配置
powershell
$env:GOOGLE_GEMINI_BASE_URL="https://ai.zjtzsmc.com"
$env:GEMINI_API_KEY="YOUR_API_KEY"
$env:GEMINI_MODEL="MODEL_ID"
gemini3. Linux/macOS 配置
bash
export GOOGLE_GEMINI_BASE_URL="https://ai.zjtzsmc.com"
export GEMINI_API_KEY="YOUR_API_KEY"
export GEMINI_MODEL="MODEL_ID"
geminiMODEL_ID 必须替换成 Gemini 分组中实际可用的模型。
4. 地址说明
- Base URL 使用站点根地址
https://ai.zjtzsmc.com。 - Gemini CLI 会访问
/v1beta/...原生接口。 - 不要把 Base URL 写成
/v1/chat/completions。 - 只有支持自定义
GOOGLE_GEMINI_BASE_URL的客户端才能连接本站。
常见问题
| 现象 | 处理方法 |
|---|---|
| 跳转 Google 登录 | 确认 GEMINI_API_KEY 已在同一终端设置 |
| 404 | 检查 Base URL 是否为根地址，并确认分组支持 Gemini 原生接口 |
| 模型不可用 | 从模型广场获取准确模型 ID |
| 429 | 降低并发，等待后重试 |
TIP
如果只需要在普通聊天客户端中使用 Gemini 模型，也可以选择客户端的 OpenAI Compatible 模式，并使用 /v1 地址；是否可用取决于该分组提供的兼容接口。