Skip to main content
Gemini CLI 是 Google 官方提供的命令行 AI 助手。根据官方文档，Gemini CLI 支持通过 Google 登录、Gemini API Key 或 Vertex AI 完成认证；如果要接入 gogogotoken，推荐使用 Gemini API Key + 自定义 Base URL。
官方文档：https://geminicli.com/docs/get-started/
Gemini CLI 的 Base URL 只填写根域名 https://gogogotoken.ai。不要手动追加 /v1beta/models/...，CLI 会按 Gemini API 格式自动拼接请求路径。

​
安装 Gemini CLI

官方推荐通过 npm 安装。安装前请先确认本机已安装 Node.js。 
node --version
npm --version
如果没有版本号输出，请先参考 环境配置 安装 Node.js。 
npm install -g @google/gemini-cli
安装完成后运行：
gemini

​
认证方式选择

Gemini CLI 首次启动时会询问 How would you like to authenticate for this project?。官方文档中的常见方式如下：
方式适用场景是否需要 Google Cloud Project
Sign in with Google使用个人 Google 账号或订阅通常不需要，组织账号可能需要
Use Gemini API key使用 Gemini API Key 或第三方 Gemini 兼容网关不需要
Vertex AI使用 Google Cloud Vertex AI需要
接入 gogogotoken 时，请选择 Use Gemini API key，并设置 GOOGLE_GEMINI_BASE_URL、GEMINI_API_KEY 与 GEMINI_MODEL。

​
配置 API

1

创建 API Key

进入控制台的 令牌管理，创建一个用于 Gemini CLI 的令牌。建议为 Gemini CLI 单独创建令牌，方便后续统计用量和排查问题。
2

找到 Gemini 的配置文件夹

安装并运行过 Gemini CLI 后，配置文件夹会自动生成。打开终端程序，根据不同系统，运行下面的命令，打开 Gemini 的配置文件夹。
open "$HOME/.gemini"
3

手动创建 .env 文件

在刚打开的 .gemini 文件夹中，手动创建一个名为 .env 的文件，并写入如下内容：
GOOGLE_GEMINI_BASE_URL="https://gogogotoken.ai"
GEMINI_API_KEY="YOUR_API_KEY"
GEMINI_MODEL="gemini-2.5-flash"
将 YOUR_API_KEY 替换为你在令牌管理中创建的 API Key。
文件名必须是 .env，不要保存成 .env.txt。Windows 如果看不到扩展名，建议先在文件管理器中开启“文件扩展名”显示。
4

命令行临时配置

如果你只想在当前终端临时测试，也可以直接设置环境变量。
export GOOGLE_GEMINI_BASE_URL="https://gogogotoken.ai"
export GEMINI_API_KEY="YOUR_API_KEY"
export GEMINI_MODEL="gemini-2.5-flash"
5

启动并选择认证方式

运行 Gemini CLI：
gemini
首次启动时选择 Use Gemini API key。如果之前已经登录过其他账号，可以在 Gemini CLI 中输入 /auth 重新选择认证方式。
6

验证连通性

在 Gemini CLI 中发送一个简单请求：
Explain this project in three bullet points.
如果能正常返回内容，说明 Gemini CLI 已通过 gogogotoken 发起请求。

​
持久化环境变量

Gemini CLI 会自动读取 .gemini/.env。如果你把 .env 放在用户目录的 .gemini 文件夹中，它会作为用户级配置生效；如果放在某个项目的 .gemini 文件夹中，则只对该项目生效。
API Key 属于敏感凭据。请不要把包含密钥的 .env 文件提交到 Git。

​
使用 CC Switch 导入 Gemini CLI 配置

如果你已经安装 CC Switch，也可以通过图形界面把 gogogotoken 的 Gemini CLI 配置写入本地环境，减少手动编辑 .env 的出错概率。
1

在令牌管理中选择对应令牌并打开 CC Switch

安装好 CC Switch 之后，进入控制台的 令牌管理，找到你准备给 Gemini CLI 使用的令牌。然后点击该令牌右侧的 聊天 下拉菜单，选择 CC Switch，系统会唤起本地的配置导入流程。
令牌管理中选择 CC Switch
2

选择导入目标为 Gemini CLI

在弹出的导入窗口中，把应用目标切换为 Gemini CLI。确认下面三项配置无误后，点击 打开 CC Switch：
  • GOOGLE_GEMINI_BASE_URL: https://gogogotoken.ai
  • GEMINI_API_KEY: 当前令牌
  • GEMINI_MODEL: gemini-2.5-flash
选择 Gemini CLI 和模型
3

在 CC Switch 中确认 Gemini CLI 已启用

导入完成后，切换到 CC Switch 顶部的 Gemini CLI 图标页签。如果配置成功，你会看到刚导入的供应商出现在列表中，并显示为 使用中。这说明 Gemini CLI 已经切换到当前配置。
确认 Gemini CLI Provider 已启用
4

在 Gemini CLI 中验证配置

重启 Gemini CLI，然后发送一次简单请求：
gemini -p "Say hello in one sentence."
如果能正常返回内容，说明 Gemini CLI 已通过 CC Switch 写入的配置访问 gogogotoken。
Gemini CLI 当前模型验证
无论你是手动修改 .env，还是通过 CC Switch 切换供应商，只要改动了 Base URL、API Key 或模型，都建议重启 Gemini CLI 后再测试。

​
故障排查

现象可能原因处理方式
启动后仍要求 Google 登录未选择 Use Gemini API key输入 /auth 重新选择认证方式
401/403Key 无效，或令牌分组不包含目标模型检查 API Key 与模型权限
404Base URL 写入了多余路径确认只设置 https://gogogotoken.ai
模型不符合预期未设置 GEMINI_MODEL，或当前会话仍使用旧配置设置控制台可用的 GEMINI_MODEL（如 gemini-2.5-flash）后重启 Gemini CLI
429触发限速或额度不足在控制台检查套餐、余额和限流策略
无法读取 .env文件位置不符合 Gemini CLI 查找规则使用 ~/.gemini/.env 或当前项目的 .gemini/.env
如果你修改了 API Key、Base URL、模型或认证方式，建议退出并重新启动 Gemini CLI，再进行测试。