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 按后台填写 / 已经重开终端