接入 Gemini CLI

Gemini CLI 是 Google 推出的终端智能开发工具，能够理解代码库、生成和修改代码、排查问题，并通过工具调用协助完成复杂开发任务。

Gemini CLI 可通过 Better Gate 客户端、CC Switch 或手动配置接入 Better Gate。请选择其中一种方式，不要同时使用，以免不同工具写入的配置相互覆盖。

Gemini CLI 支持 Windows、macOS 和 Linux。更多安装和使用说明，请查看 Gemini CLI 官方仓库。

1 安装 Gemini CLI

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

如果 gemini --version 输出版本号，说明安装成功。开始配置 Better Gate 前，请退出所有正在运行的 Gemini CLI 会话。

登录 Better Gate 控制台。
确认账户有可用余额（组织成员需确认自己的成员额度够用）。
打开“API Keys”，点击“创建 Key”。
填写 Key 名称，路由方式保持默认的“智能路由”就行，它会自动挑可用渠道；只有需要固定渠道时才选“指定渠道分组”。组织管理员为成员创建 Key，记得勾选“分配给成员”。
点击创建，复制并保存好完整的 API Key。
打开“模型列表”，确认该 Key 当前选择的路由模式支持准备使用的 Gemini 模型。

下载并安装 Better Gate 客户端：

系统	下载地址
Windows	下载 Better Gate Windows 客户端
macOS	下载 Better Gate macOS 客户端

Better Gate 客户端主界面

通过客户端接入 Gemini CLI：

不再需要 Better Gate 时，可以在弹窗中点击对应密钥旁的“取消接入”：客户端会恢复 Gemini CLI 的官方登录与配置，工作区的 API Key 不会被删除。

前往 CC Switch Releases 下载并安装支持 Gemini CLI 的版本。

添加 Better Gate 供应商：

字段	值
供应商名称	`Better Gate`
官网链接	`https://better-gate.com/`，可选
API Key	你的 Better Gate API Key
请求地址	`https://gateway.better-gate.com`

保存配置后，在 Better Gate 卡片中点击“启用”。

Gemini CLI 的环境配置文件路径如下：

创建配置目录和 .env 文件，写入以下内容：

GOOGLE_GEMINI_BASE_URL=https://gateway.better-gate.com
GEMINI_API_KEY=YOUR_BETTER_GATE_API_KEY
GEMINI_API_KEY_AUTH_MECHANISM=bearer

Gemini CLI 会在启动时自动读取该文件，无需运行 source。首次启动并出现认证方式选择时，请选择“Use Gemini API Key”，不要选择“Sign in with Google”或“Vertex AI”。

如果此前已经通过 OAuth 登录，可备份原有设置，使 Gemini CLI 重新显示认证向导：

mv ~/.gemini/settings.json ~/.gemini/settings.json.bak

Rename-Item "$HOME\.gemini\settings.json" "settings.json.bak"

如果 settings.json 不存在，可以跳过备份步骤。

完成任一接入方式后，重新打开终端并运行 gemini。确认界面使用 API Key 认证，发送一条简短消息，再前往 Better Gate 控制台的用量页面，确认是否出现对应的请求记录。