跳至主要內容

切换 Gemini CLI

大约 3 分钟

用 CC-Switch 切换 Gemini CLI

用 Gemini CLI 但 Google 官方账号有地区限制？想接平台令牌？或者要在多个 Gemini 令牌之间切？这一篇带你把 Gemini CLI 切到平台。

看这篇前

请先看 通用概念与配置：那里讲了 CC-Switch 安装、面板布局、配置项每一项的含义。本页只补 Gemini CLI 专属步骤。

一、什么情况要切

场景要不要切
Google 官方账号有地区限制，转走平台要
同时用官方 + 平台令牌要
测试令牌 / 生产令牌 / 不同分组并存要
只用一套平台令牌、长期不动不用切，配一次就行

二、开始前的准备

  1. 已经走完 通用概念与配置
  2. 已经创建好 Gemini 家族令牌分组 的令牌：参考 建令牌
  3. 本机能跑：
gemini --version

如果命令报 command not found，先去 Gemini CLI 手动配置 装好。

你需要这两个值

  • API 地址：https://www.yuzhixiaolongxia.com/（末尾必须有斜杠）
  • API Key：平台 Gemini 家族令牌

Gemini 的地址末尾要有斜杠

和 Claude（不带 /v1）、Codex（带 /v1）都不一样：Gemini CLI 的地址是 https://www.yuzhixiaolongxia.com/，结尾那个 / 不能漏。部分版本漏了斜杠会报路径异常。

三、在 CC-Switch 里加 Gemini 配置

  1. 启动 CC-Switch
  2. 顶部应用切换到 Gemini
  3. 点 Add Provider（添加供应商）
  4. 按下表填字段：
字段填什么
名称预制小龙虾-Gemini 或加环境后缀
Provider / 应用Gemini
API URLhttps://www.yuzhixiaolongxia.com/
API Key平台 Gemini 家族令牌
Model（可选）不填用默认，要锁定时填
  1. 点保存
  2. 在配置列表里找到刚加的项，点 Enable / 启用
  3. 状态显示 使用中 / In Use 才算切到位

想锁定模型再填 Model

Gemini 系列的模型 ID 在平台上和 Google 原始命名可能不同，以 模型广场 中 Gemini 家族当前公开的 ID 为准，直接复制粘贴。

四、验证切到平台了

关掉之前所有 gemini 终端窗口，重开新终端：

gemini

进入会话后发一句：

回复：连接成功

能正常返回就说明这一刻 Gemini CLI 走的是平台后端。

想验证更彻底

平台控制台 /console/log 里看时间戳能不能对上你刚发的那次请求；如果对得上，就是平台计费的。

五、切回原来的后端

切回 Google 官方或别的后端：

  1. 在 CC-Switch 的 Gemini 配置列表里，点击之前那个"官方"配置，点 Enable
  2. 关掉所有 gemini 终端
  3. 重开终端，再跑 gemini

多个 Gemini 分组都建议起独立名字

如果你为不同业务申请了不同分组的 Gemini 令牌，强烈建议每个分组建独立配置并命名清楚（例如 Gemini-高配、Gemini-试用），避免混用。

六、常见坑

现象原因怎么处理
部分版本报路径异常API URL 末尾漏了斜杠改成 https://www.yuzhixiaolongxia.com/
permission denied令牌不在 Gemini 家族分组、或权限不够重建 Gemini 家族分组令牌
model not found模型 ID 在 Gemini 家族里不可用去 模型广场 复制可用 ID
connection timeout本机网络 / 代理问题跑 curl -I https://www.yuzhixiaolongxia.com 看连通性
启用后仍失败旧终端进程没重开关掉所有 gemini 终端再重开
模型名能对应官方但报错平台模型 ID 与 Google 原命名不同一律以平台模型广场为准

七、日常使用建议

  • 先用短问答验证，再跑长任务，避免一开始就长跑空耗令牌
  • 遇到接入异常，先排查"网络 → 令牌分组 → API URL → 模型 ID"四件套
  • 令牌泄露立刻去平台删，再回 CC-Switch 这条配置编辑替换 Key

上一步：切换 Codex CLI 下一步：ccs 命令行版

预制小龙虾 | 文档系统
Copyright © 2026 预制小龙虾