GeiliAPI 接入手册

Gemini CLI

把 Gemini CLI 接到本站

本教程里说的 Gemini CLI，是 Google 官方命令行，不是网页版 Gemini。通过 GOOGLE_GEMINI_BASE_URL 指向本站。当前没有与 Codex App / Claude Desktop 对等的官方 Gemini 编程桌面客户端，一页就能走完。

开始前

先创建 Gemini 分组 的密钥。根地址是 https://sub.geiliapi.com，不要加 /v1。具体档位看控制台和 模型价格。

先拿一把 Gemini 分组密钥

在 创建密钥 时选 Gemini 分组，不要选 OpenAI 或 Claude。创建后立刻复制完整 Key。

GeiliAPI API 密钥页，用于创建 Gemini 分组密钥
你会看到：侧栏「API 密钥」，右上角「+ 创建密钥」。Gemini 的分组名以控制台为准，选错成 OpenAI 号池后，CLI 会认证失败。

安装

需要本机已有 Node.js。装完应能执行 gemini --version 并看到版本号。

macOS

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

Windows

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

若提示找不到命令，新开一个终端窗口。Windows 还要完全退出 VS Code 再开，让 PATH 生效。

配置

一键工具会更新用户级 ~/.gemini/.env，只替换带 GeiliAPI 标记的配置块；同时合并 ~/.gemini/settings.json，将认证方式设为 Gemini API Key。手动配置时两处都要完成。

第一处，~/.gemini/settings.json：

settings.json
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

第二处，~/.gemini/.env：

.env
GOOGLE_GEMINI_BASE_URL="https://sub.geiliapi.com"
GEMINI_API_KEY="替换为你的 Gemini 分组 API Key"
GEMINI_MODEL="gemini-3.5-flash"
  1. 1

    两处缺一不可

    只写 .env 但 settings 仍是 Google 登录，会提示 Please set an Auth method。只改 settings 却没有 Key，会 Invalid auth method。

  2. 2

    地址不要加 /v1

    GOOGLE_GEMINI_BASE_URL 是根地址。多写 /v1 容易 404。

  3. 3

    第一次进目录必须点信任

    在项目目录运行 gemini 时，会问是否信任该文件夹。未信任时不会加载用户级 .gemini/.env，看起来就像「配置写了但不生效」。

默认 gemini-3.5-flash。要更强推理换成 gemini-3.1-pro-preview；只要短答用 gemini-3.1-flash-lite。模型名称必须存在于该密钥分组。

提示

信任目录之后，完全退出 Gemini CLI 再启动一次。只在当前会话里改环境变量，不一定写进用户级文件。

验证第一次请求

  1. 1

    跑一句最小任务

    信任当前项目目录后，发送：

    给 Gemini
    只回复 OK。不要修改任何文件。
  2. 2

    核对使用记录

    到控制台「使用记录」确认出现这把 Gemini 分组 Key 和 gemini-3.5-flash（或你改过的模型）。

这个工具的故障

Please set an Auth method / Invalid auth method selected

重新跑一键工具，确认 ~/.gemini/settings.json 里 "selectedType": "gemini-api-key"，且 ~/.gemini/.env 同时有 GEMINI_API_KEY 与 GOOGLE_GEMINI_BASE_URL。

未信任目录，环境变量不生效

第一次进入项目目录时必须选择信任。未信任时 Gemini CLI 不会加载用户级 .gemini/.env。信任后完全退出再开。

404 或仍走 Google 官方

根地址不要加 /v1。若客户端还在打 Google 域名，说明没读到 GOOGLE_GEMINI_BASE_URL。

下一步：可以用一键工具少填几项，或改用 CC Switch 统一管理。

使用一键工具 用 CC Switch 管理
已复制