完成后，Gemini CLI 会读取 CCSwitch 启用的 API Key、基础地址和模型配置。

​
准备工作

  • CCSwitch 已安装并能正常打开。
  • Gemini CLI 已安装。
  • 已创建算无忧 API 令牌。
  • 已确认当前令牌能够访问 Gemini 模型。
如果没有安装 Gemini CLI： 
npm install -g @google/gemini-cli
gemini --version

​
新增 Provider

1

打开 Gemini 模块

启动 CCSwitch，在左侧选择 Gemini 或 Gemini CLI，然后点击右上角的新增按钮。
2

选择自定义供应商

如果预设列表中没有算无忧，选择 Custom，名称填写“算无忧 Gemini”。
3

填写连接信息

API Key 填写算无忧令牌；Base URL 填写界面要求的 Gemini 兼容地址；模型填写控制台当前可用的 Gemini 模型 ID。
4

保存并启用

保存后点击 Enable，确认状态变为 Using、Active 或“使用中”。
5

重新打开终端

关闭旧终端，打开新终端，让 CLI 重新读取配置。
自定义环境变量结构通常类似： 
{
  "env": {
    "GEMINI_API_KEY": "sk-你的算无忧令牌",
    "GOOGLE_GEMINI_BASE_URL": "算无忧提供的 Gemini 兼容地址",
    "GEMINI_MODEL": "控制台中的 Gemini 模型名称"
  }
}

​
验证配置

gemini --version
gemini -p "请只回复：配置成功"
macOS / Linux 可以检查配置文件： 
cat ~/.gemini/settings.json
Windows PowerShell： 
Get-Content $env:USERPROFILE\.gemini\settings.json

​
常见问题

确认 Provider 显示“使用中”，重新打开终端，并检查系统环境变量是否覆盖了 CCSwitch 写入的配置。
检查令牌、账户余额、分组权限，以及 Gemini 模型是否已对当前令牌开放。
重新核对模型 ID 和 Gemini 兼容基础地址。不要直接套用 OpenAI 的 /v1/chat/completions 地址。