Gemini CLI 配置

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

如果不想全局安装，也可以使用 npx 直接启动：

npx @google/gemini-cli

认证方式选择

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

创建 API Key

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

找到 Gemini 的配置文件夹

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

macOS
Windows PowerShell
Windows CMD
Linux
WSL2

open "$HOME/.gemini"

explorer "$env:USERPROFILE\.gemini"

start "" "%USERPROFILE%\.gemini"

xdg-open "$HOME/.gemini"

explorer.exe "$(wslpath -w "$HOME/.gemini")"

手动创建 .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 如果看不到扩展名，建议先在文件管理器中开启“文件扩展名”显示。

命令行临时配置

如果你只想在当前终端临时测试，也可以直接设置环境变量。

macOS / Linux / WSL2
Windows PowerShell

export GOOGLE_GEMINI_BASE_URL="https://gogogotoken.ai"
export GEMINI_API_KEY="YOUR_API_KEY"
export GEMINI_MODEL="gemini-2.5-flash"

$env:GOOGLE_GEMINI_BASE_URL="https://gogogotoken.ai"
$env:GEMINI_API_KEY="YOUR_API_KEY"
$env:GEMINI_MODEL="gemini-2.5-flash"

启动并选择认证方式

运行 Gemini CLI：

gemini

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

验证连通性

在 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 的出错概率。

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

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

选择导入目标为 Gemini CLI

在弹出的导入窗口中，把应用目标切换为 Gemini CLI。确认下面三项配置无误后，点击 打开 CC Switch：

GOOGLE_GEMINI_BASE_URL: https://gogogotoken.ai
GEMINI_API_KEY: 当前令牌
GEMINI_MODEL: gemini-2.5-flash

在 CC Switch 中确认 Gemini CLI 已启用

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

在 Gemini CLI 中验证配置

重启 Gemini CLI，然后发送一次简单请求：

gemini -p "Say hello in one sentence."

如果能正常返回内容，说明 Gemini CLI 已通过 CC Switch 写入的配置访问 gogogotoken。

无论你是手动修改 .env，还是通过 CC Switch 切换供应商，只要改动了 Base URL、API Key 或模型，都建议重启 Gemini CLI 后再测试。

故障排查

现象	可能原因	处理方式
启动后仍要求 Google 登录	未选择 `Use Gemini API key`	输入 `/auth` 重新选择认证方式
`401/403`	Key 无效，或令牌分组不包含目标模型	检查 API Key 与模型权限
`404`	Base 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，再进行测试。

开始使用

基础

账户与计费

AI 工具配置

AI 应用平台配置

大模型接口

Seedream 图像

Seedance 视频

Seedance 素材

更新日志

安装 Gemini CLI

认证方式选择

配置 API

持久化环境变量

使用 CC Switch 导入 Gemini CLI 配置

故障排查

​安装 Gemini CLI

​认证方式选择

​配置 API

​持久化环境变量

​使用 CC Switch 导入 Gemini CLI 配置

​故障排查

安装 Gemini CLI

认证方式选择

配置 API

持久化环境变量

使用 CC Switch 导入 Gemini CLI 配置

故障排查