Gemini CLI 配置指南

访问地址：https://koalaapi.com（OpenAI 兼容接口在末尾加 /v1）。

配置速查

配置项	填写内容
Base URL	`https://koalaapi.com`（Gemini 原生协议，不加 `/v1`）
API Key	控制台 → 令牌管理创建的令牌，形如 `sk-...`
模型名称	`gemini-3.8-flash` 等，以【模型广场】为准

适用版本

Gemini CLI 当前版本（2026-11 核对）

需要 Node.js 20 或更高版本（node -v 查看）

一、安装

npm（推荐，全平台）

Homebrew（macOS / Linux）

免安装试用

安装完成后验证：

二、配置 KoalaAPI

方式一：环境变量（最快）

Windows（PowerShell / CMD）

setx GEMINI_API_KEY "sk-你的令牌"
setx GOOGLE_GEMINI_BASE_URL "https://koalaapi.com"

设置后关闭所有终端窗口，重新打开生效。

macOS / Linux

GOOGLE_GEMINI_BASE_URL 是 Gemini CLI 的自定义端点变量，走 Gemini 原生协议。请确认所用令牌分组已开通 Gemini 原生接口；只用 OpenAI 兼容接口的分组请看下面的方式二或其他教程。

方式二：CC Switch（图形化，推荐给不想改配置文件的用户）

请先按照 KoalaAPI 官方文档完成 CC Switch 安装：

【CC Switch 使用教程】https://koalaapi.apifox.cn

安装完成后，请确认 CC Switch 可以正常打开。后续需要将 KoalaAPI 令牌导入到 CC Switch。

打开 CC Switch 后，请确认当前位于 Gemini CLI 对应的页面。该页面中的默认配置通常显示为 Google Official。

三、创建 Google 专用令牌

打开 KoalaAPI 官网并登录账号，依次点击 控制台 → 令牌管理 → 添加令牌。

在创建令牌页面，按需填写以下信息：

名称：建议填写容易识别的名称，例如 Gemini令牌。

令牌分组：选择用于 Gemini 的分组。请确保该分组中包含需要使用的 Gemini 模型。

额度设置：按实际需求设置额度。如果不需要限制额度，可保持默认配置。

访问限制：如无特殊网络限制要求，可保持默认配置。

确认信息无误后，点击提交。

（截图待补）

四、打开 CC Switch 导入入口

令牌创建成功后，会弹出保存 key 的弹窗。保存 key 之后，点击 在 CC Switch 中打开

（截图待补）

五、选择 Gemini 配置并打开 CC Switch

页面会弹出 接入 CC Switch 窗口。

在弹窗中按以下方式配置：

应用：选择 Gemini。

名称：填写容易识别的名称，例如 My Gemini。

主模型：选择要作为 Gemini CLI 主模型使用的模型。

模型可以根据自己的实际可用模型选择。你也可以根据分组权限选择其他 Gemini 模型。

确认配置无误后，点击 打开 CC Switch。

（截图待补）

点击 打开 CC Switch 后，浏览器可能会弹出外部应用打开确认窗口。请允许浏览器打开 CC Switch。

六、导入 Gemini 配置

CC Switch 打开后，会显示即将导入的供应商配置。

请重点确认以下内容：

应用类型 是否为 Gemini。

供应商名称 是否容易识别，例如 My Gemini。

API 端点 是否为 KoalaAPI 地址。

API 密钥 是否已自动带入，并且已做脱敏显示。

确认无误后，点击导入。

（截图待补）

七、启用配置并测试连通性

导入成功后，回到 CC Switch 的 Gemini CLI 配置列表。

在列表中找到刚导入的配置，例如 My Gemini，点击切换。

（截图待补）

注意：启用配置后，建议 关闭所有已打开的 PowerShell 或 CMD 窗口，再重新打开终端。这样可以确保 Claude Code CLI 读取到 CC Switch 写入的最新配置。

八、验证

或直接指定模型：

能看到回复即配置成功。

（截图待补）

九、常见问题

Q：启动后仍提示登录 Google 账号？
A：说明 GEMINI_API_KEY 没被读到。确认变量名拼写正确，并在设置后新开终端；也可以在 ~/.gemini/settings.json 里固定认证方式。

Q：提示 404 / model not found？
A：模型名要和【模型广场】完全一致；另外确认分组支持 Gemini 原生协议，而不是只有 OpenAI 兼容接口。

Q：能不装 Node 吗？
A：可以，macOS / Linux 用 brew install gemini-cli；Windows 建议先装 Node 20+ 再用 npm。

更新于 2026-11　官方文档：https://github.com/google-gemini/gemini-cli

Gemini CLI 配置指南

适用版本#

一、安装#

二、配置 KoalaAPI#

方式一：环境变量（最快）#

方式二：CC Switch（图形化，推荐给不想改配置文件的用户）#

三、创建 Google 专用令牌#

四、打开 CC Switch 导入入口#

五、选择 Gemini 配置并打开 CC Switch#

六、导入 Gemini 配置#

七、启用配置并测试连通性#

八、验证#

九、常见问题#

适用版本

一、安装

二、配置 KoalaAPI

方式一：环境变量（最快）

方式二：CC Switch（图形化，推荐给不想改配置文件的用户）

三、创建 Google 专用令牌

四、打开 CC Switch 导入入口

五、选择 Gemini 配置并打开 CC Switch

六、导入 Gemini 配置

七、启用配置并测试连通性

八、验证

九、常见问题