Gemini CLI 接入 ModelGate 教程

Gemini CLI 通过环境变量文件 ~/.gemini/.env 读取供应商配置。接入 ModelGate 只需设置 base URL 与 API Key。

安装 Gemini CLI

使用 npm 安装：

npm install -g @google/gemini-cli

配置文件

1. 编辑 ~/.gemini/.env

GOOGLE_GEMINI_BASE_URL="https://modelgate.app/"
GEMINI_API_KEY=替换为您的ModelGate API Key
GEMINI_MODEL=gemini-3-pro-preview

2. 编辑 ~/.gemini/settings.json

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

使用与验证

启动 Gemini CLI：

gemini

常见问题

• 401 认证错误 — 在 Gemini CLI 中执行 /auth 命令，填入 ModelGate API Key。
• 模型不存在 — 确认 GEMINI_MODEL 名称与 ModelGate 后台可用模型一致。
• 接口端点 — 统一填写 https://modelgate.app/，保持与 Claude Code 相同的端点风格。

相关教程

• 模型与计费说明 — 了解 Token 计费方式