Gemini 問題排查
Gemini 和 OpenAI 兼容接口不是一套東西。只有服務商明確提供 Gemini / Google / Vertex 相關接口，或者教程明確寫支持 Gemini CLI，才按 Gemini 方式配置。
先確認什麼
| 檢查項 | 怎麼看 | 為什麼 |
|---|---|---|
| 目標工具 | 確認你正在排查 Gemini CLI | Gemini CLI 的認證方式和 Codex、Claude Code 不同 |
| 服務商支持 Gemini | 後臺或教程裡有 Gemini / Google / Vertex 相關入口 | OpenAI 兼容接口不等於 Gemini 接口 |
| Key 類型 | 使用 Gemini 或 Vertex 對應 Key | Key 類型不對會 401、403 或繼續要求登錄 |
| 模型名 | 按 Gemini 模型列表填寫 | 不要把 OpenAI 或 Claude 模型名填到 Gemini 裡 |
常見報錯
| 現象 | 優先檢查 | 處理方法 |
|---|---|---|
| 仍提示登錄 Google | Gemini CLI 自身認證 | 先按 Gemini CLI 的提示完成它要求的認證；服務商配置不能替代目標工具自身要求的登錄流程。 |
| 401 / 403 | Gemini Key 或權限 | 確認 Key 屬於 Gemini / Google / Vertex 這一組，並且當前項目或賬戶有對應模型權限。 |
| 404 / model not found | Gemini 模型名 | 按服務商後臺 Gemini 模型列表填寫，不要填 OpenAI 或 Claude 模型名。 |
| 連接失敗 | Gemini Base URL | 不要把普通 OpenAI 兼容 Base URL 填到 Gemini 裡；只有後臺明確說明支持 Gemini 時再配置。 |
| CC-Switch 切換後無變化 | 目標工具和終端狀態 | 確認應用目標是 Gemini CLI，保存後重新打開終端再測。 |
最小測試
先確認 Gemini CLI 能返回固定短句，再繼續排查複雜任務。
Gemini 最小測試
gemini "請只回覆：Gemini 配置測試成功"反饋模板
給服務商反饋時這樣寫
工具名稱：Gemini 系統版本： 服務商後臺 Base URL： 模型 ID / 模型名： 報錯原文： 我已經檢查過：Key 沒有空格 / 餘額正常 / 模型名照抄 / Base URL 按後臺填寫 / 已經重開終端