排查要点
先明确要使用哪种认证方式，再检查 API Key、登录状态与配置文件。混合多种来源的配置会让实际生效路径难以判断。
- 适用范围
- 配置排查参考；以当前工具版本和供应商文档为准。
- 适用系统
- macOSWindowsLinux
- 问题类型
- 配置 / 兼容问题
确认当前认证方式
明确本次要使用 API Key、Google 登录还是 Vertex AI。它们依赖的配置和账号权限不同，应参考对应认证方式的官方文档。
检查覆盖配置
检查终端环境变量、用户设置、项目设置和登录状态是否仍指向其他认证方式。使用 NexoX 时，确认启用的供应商及其预设与目标方式一致。
修改后重新启动 Gemini CLI，以一次简短请求确认认证和模型正常。不要通过反复添加多个密钥来尝试解决冲突。