直接答案：Gemini CLI 使用第三方 API 时需同时确认认证字段、服务地址和模型代号，字段名以当前客户端版本为准。适合在 Windows 或终端工作流中调用 Gemini；出现启动即退或 401 时先检查版本与认证方式。
1. 配置前准备
- 确认 Gemini CLI 已安装，并记录 CLI 与运行时版本。
- 在 island AI Coding 创建 Gemini API Key，确认密钥分组包含目标模型。
- 从模型广场复制当前模型代号，不要根据展示名称自行猜测。
- 准备一个只包含“返回连接成功”的最小测试请求。
不要混用配置协议Gemini CLI 的不同版本可能使用不同配置字段。请以当前控制台显示的 Gemini CLI 模板为准，OpenAI 兼容 SDK 配置请查看统一接口教程。
2. 配置 API Key、Base URL 与模型
配置的逻辑可以抽象为以下三项：认证密钥、服务地址、模型代号。示意如下，字段名以控制台当前模板为准：
环境变量示意
GEMINI_API_KEY="YOUR_API_KEY"
GEMINI_BASE_URL="YOUR_GEMINI_BASE_URL"
GEMINI_MODEL="MODEL_ID"若控制台提供 JSON、TOML 或命令行初始化模板，优先使用模板中的字段和值。真实密钥只放在本地环境变量或密钥管理器中。
需要查看 Gemini 文字、多模态和图片能力时，参考Gemini API 中转专题。
3. Windows 环境检查
- 关闭旧的终端窗口，重新打开 PowerShell，避免读取旧环境变量。
- 分别检查 CLI、Node.js（如当前安装方式依赖）和包管理器版本。
- 确认变量名称没有拼写错误，值没有多余引号、空格或换行。
- 使用当前用户权限运行，不要混用管理员终端和普通终端生成的配置目录。
- 如果终端启动后立即退出，保留最后一屏错误信息，并先运行版本和认证状态命令。
20 秒退出的排查顺序版本 → 环境变量 → 登录状态 → Base URL → 模型代号 → 网络请求。每次只改一项，便于确认真正原因。
4. 用最小请求验证配置
- 先选择一个文字模型，发送短提示词。
- 确认返回内容、模型字段和请求耗时。
- 在控制台查看调用记录、Token 用量和错误状态。
- 再逐步增加上下文、文件读取和多模态输入。
出现 401、403、429 或 5xx 时，记录状态码、时间、模型代号和请求 ID，参阅AI API 错误码排查指南。
5. 多模态与图片生成
Gemini 的文字、多模态和图片生成能力由具体模型决定，不应只看“Gemini”这一品牌名称。使用前确认：
- 模型是否接受图片或其他媒体输入。
- 请求格式是否与当前客户端协议匹配。
- 图片尺寸、数量、质量和返回格式是否被支持。
- 媒体输入带来的 Token 和图片费用是否符合项目预算。
本站生图最低 0.03 元/张，具体 Gemini 图片模型和价格以模型广场及 API 密钥页面为准。
6. Gemini CLI 常见问题
| 现象 | 处理顺序 |
|---|---|
| Invalid auth method selected | 查看认证方式与自定义 Base URL 排查 |
| HttpsProxyAgent is not a constructor | 查看Gemini CLI 代理报错排查 |
| VPS OAuth Premature close | 查看无头 VPS OAuth 排查 |
| 401 ACCESS_TOKEN_TYPE_UNSUPPORTED | 查看Gemini API 与 Vertex 认证排查 |
| 模型不存在 | 从模型广场复制代号，确认密钥分组包含该模型 |
| 429 RESOURCE_EXHAUSTED 或一直 Thinking | 查看Gemini CLI 429 排查文章，区分额度、模型容量和 fallback 循环 |
| 多模态参数错误 | 确认模型能力、媒体格式、尺寸和请求协议 |
| 响应速度不稳定 | 记录 P95 延迟和失败率，参阅稳定性指南 |
请勿把完整 API Key 或未脱敏业务数据发送给他人。需要人工协助时，客服微信：GPT774。
7. 常见问题 FAQ
Gemini CLI 配置第三方 API 需要哪些字段？
通常包括 API Key、兼容 Base URL 和模型代号；不同版本字段可能不同，优先复制当前控制台模板。
Gemini CLI 启动后 20 秒退出怎么办？
依次检查版本、环境变量、认证状态、模型代号、网络请求和终端日志，每次只修改一项。
Gemini CLI 可以调用图片生成模型吗？
是否支持取决于模型和客户端协议，先在模型广场确认图片能力，再按控制台示例调用。