接入教程

中转接入教程

按工具查看接入步骤和排查方法。

首页/中转接入教程/CC-Switch Gemini

CC-Switch Gemini

这一页讲的是把 Gemini 相关 Provider 通过 CC Switch 应用到 Gemini CLI。Gemini 的接口、鉴权方式和 OpenAI 兼容接口不同，所以不能只把普通 OpenAI Base URL 填进去就当作 Gemini 可用。

官方信息 下载和文档以官方站点为准
官方网站 CC Switch 官方站点 安装说明 下载安装和 Homebrew GitHub 官方仓库和 Releases

这一页讲什么

只有服务商明确提供 Gemini / Google / Vertex 相关接口，或者文档明确写支持 Gemini CLI 时，才建议在 CC Switch 里配置 Gemini。

开始前确认

要确认的事怎么看为什么
Gemini CLI 已能启动先确认本机 Gemini CLI 可打开CC Switch 只负责配置切换
服务商支持 Gemini后台或教程里有 Gemini / Google / Vertex 相关入口OpenAI 兼容接口不等于 Gemini 接口
Key 类型正确确认是 Gemini 或 Vertex 对应 KeyKey 类型不对会认证失败
模型名来自 Gemini 列表照抄服务商后台 Gemini 模型名不要混用 Claude、OpenAI 模型名

字段怎么填

字段填写方式新手注意
Provider 名称写清楚用途例如“Gemini 中转”或“Google Gemini”
目标工具 / Preset选择 Gemini 或 Google / Vertex 相关预设不要选择 OpenAI 兼容预设
Base URL复制 Gemini 对应接口地址如果后台只给 OpenAI 地址，先不要强行填
API Key复制 Gemini / Vertex 对应 KeyKey 类型要和 Base URL 对应
模型名照抄 Gemini 模型列表模型名通常和 OpenAI、Claude 不一样

应用到 Gemini

  1. 打开 CC Switch，进入 Provider 管理区域。
  2. 新增 Gemini Provider，或选择已经配置好的 Gemini Provider。
  3. 目标工具选择 Gemini CLI 相关预设。
  4. 填写 Gemini 对应的 Base URL、API Key 和模型名。
  5. 保存后执行 Apply / Switch。
  6. 重新打开终端，再用 Gemini CLI 做最小测试。

测试是否生效

Gemini 配置失败时，最常见原因是把 OpenAI 兼容地址填到了 Gemini 里，或者 Key 类型和接口地址不匹配。

Gemini 最小测试
gemini "请只回复：CC-Switch Gemini 已生效"
如果 Gemini CLI 仍然要求 Google 登录，先按 Gemini CLI 自身提示处理；CC Switch 只能同步它支持的 Provider 配置，不能绕过目标工具自身的登录要求。