CC-Switch Gemini
這一頁講的是把 Gemini 相關 Provider 通過 CC Switch 應用到 Gemini CLI。Gemini 的接口、鑑權方式和 OpenAI 兼容接口不同，所以不能只把普通 OpenAI Base URL 填進去就當作 Gemini 可用。
官方信息 下載和文檔以官方站點為準
這一頁講什麼
只有服務商明確提供 Gemini / Google / Vertex 相關接口，或者文檔明確寫支持 Gemini CLI 時，才建議在 CC Switch 裡配置 Gemini。
開始前確認
| 要確認的事 | 怎麼看 | 為什麼 |
|---|---|---|
| Gemini CLI 已能啟動 | 先確認本機 Gemini CLI 可打開 | CC Switch 只負責配置切換 |
| 服務商支持 Gemini | 後臺或教程裡有 Gemini / Google / Vertex 相關入口 | OpenAI 兼容接口不等於 Gemini 接口 |
| Key 類型正確 | 確認是 Gemini 或 Vertex 對應 Key | Key 類型不對會認證失敗 |
| 模型名來自 Gemini 列表 | 照抄服務商後臺 Gemini 模型名 | 不要混用 Claude、OpenAI 模型名 |
字段怎麼填
| 配置項 | 填寫方式 | 新手注意 |
|---|---|---|
| Provider 名稱 | 寫清楚用途 | 例如“Gemini 中轉”或“Google Gemini” |
| 目標工具 / Preset | 選擇 Gemini 或 Google / Vertex 相關預設 | 不要選擇 OpenAI 兼容預設 |
| Base URL | 複製 Gemini 對應接口地址 | 如果後臺只給 OpenAI 地址，先不要強行填 |
| API Key | 複製 Gemini / Vertex 對應 Key | Key 類型要和 Base URL 對應 |
| 模型名 | 照抄 Gemini 模型列表 | 模型名通常和 OpenAI、Claude 不一樣 |
應用到 Gemini
- 打開 CC Switch，進入 Provider 管理區域。
- 新增 Gemini Provider，或選擇已經配置好的 Gemini Provider。
- 目標工具選擇 Gemini CLI 相關預設。
- 填寫 Gemini 對應的 Base URL、API Key 和模型名。
- 保存後執行 Apply / Switch。
- 重新打開終端，再用 Gemini CLI 做最小測試。
測試是否生效
Gemini 配置失敗時，最常見原因是把 OpenAI 兼容地址填到了 Gemini 裡，或者 Key 類型和接口地址不匹配。
Gemini 最小測試
gemini "請只回覆：CC-Switch Gemini 已生效"如果 Gemini CLI 仍然要求 Google 登錄，先按 Gemini CLI 自身提示處理；CC Switch 只能同步它支持的 Provider 配置，不能繞過目標工具自身的登錄要求。