Gemini CLI 认证模式与自定义地址不生效排查

更新于 ;软件与模型验证范围见正文。

设置 Key 后仍打开 Google 登录

Gemini CLI 启动时选择 Use Gemini API key。GOOGLE_GEMINI_BASE_URL 只对 gemini-api-key 生效,Google OAuth 或 Vertex 模式需按其独立配置处理。检查当前终端 GEMINI_API_KEY 是否非空,不打印 Key。

自定义地址没有生效

检查用户与项目 .gemini/.env、当前终端变量及认证模式。根地址用 https://api.apizt.com,不追加 OpenAI 的 /v1/chat/completions;自定义远程地址使用 HTTPS。

404 与模型不可用

检查实际路由 /v1beta/models/{model}:generateContent,核对 API 版本和 GEMINI_MODEL;当前原生接口测试模型为 gemini-3.8-flash。401 或模型权限问题进入 鉴权与权限检查。

回到 CLI 复验

记录 gemini --version、Node.js 版本和认证模式,再运行短文本。Gemini CLI 设置步骤的接口已实测,CLI 尚未安装验证,不能把接口测试当作 CLI 完整验证。

修复后验证与下一步

在原工具中新建会话,发送短文本,再对照 apizt 日志核对模型和请求时间。先看 真实调用记录的验证范围;未覆盖的功能需单独测试。成本和权限:实时模型价格 · 创建分组令牌。