工具教程
Gemini CLI API 配置与供应商切换教程
使用 NexoX 配置 Gemini CLI 的 API Key、服务地址和模型，区分 Google 官方登录与第三方 API，排查认证、端点和环境变量问题。
快速回答
在 NexoX 中选择 Gemini CLI，添加与认证方式相匹配的供应商，填写 API Key、Gemini 服务地址和模型，再启用连接。使用新的 CLI 请求验证配置；官方登录与第三方 API Key 配置应分别管理。
NexoX 桌面客户端的供应商配置流程；具体字段以已安装版本为准。
先确定使用官方登录还是 API Key
准备已经安装的 Gemini CLI 和 NexoX。Google 官方账号登录与第三方 API Key 是不同的认证方式：使用官方登录时选择对应官方预设，使用 API 供应商时准备其地址、密钥和模型信息。
供应商需要提供 Gemini CLI 所需的接口能力。一个只支持其他工具的 API 地址，不能直接当作 Gemini 服务地址使用；需要转换时应按对应预设设置本地路由。
如何添加 Gemini CLI 的 API 供应商？
服务地址和模型名称以供应商文档为准。不同供应商可能要求不同路径，不能统一拼接 /v1 或 /v1beta。
- 在 NexoX 中选择 Gemini CLI，点击添加供应商。
- 选择供应商预设，或创建自定义连接并填写名称。
- 填写 API Key 与 Gemini 服务地址，必要时指定供应商支持的模型。
- 保存并启用供应商，确认认证方式与所选服务一致。
| 字段 | 作用 |
|---|---|
| GEMINI_API_KEY | 使用 API Key 认证时向供应商认证。 |
| GOOGLE_GEMINI_BASE_URL | 指定供应商提供的 Gemini 服务地址。 |
| GEMINI_MODEL | 需要指定模型时，填写供应商提供的模型 ID。 |
配置保存在哪里，如何确认生效？
常规情况下，NexoX 管理 ~/.gemini/.env 中的供应商环境变量，并按认证方式更新 ~/.gemini/settings.json。自定义目录时，以 NexoX 的目录设置和 CLI 实际读取的位置为准。
启用后发起一个新的简短请求，确认模型和响应正常。若当前进程仍读取旧信息，重新启动 Gemini CLI，并检查终端或项目目录中是否存在覆盖配置的环境变量。
下面是字段示意。地址、密钥与模型均为占位值，使用 NexoX 时由客户端管理，不需要把它们粘贴到官网或手工覆盖整个文件。
GEMINI_API_KEY=YOUR_API_KEY
GOOGLE_GEMINI_BASE_URL=https://api.example.com
GEMINI_MODEL=YOUR_MODEL_ID登录提示或连接错误如何排查？
先确认当前供应商和认证方式，再检查服务地址与实际模型。供应商额度、权限和接口能力需要在供应商侧核实。
| 现象 | 优先检查 |
|---|---|
| 仍要求官方登录 | settings.json 的认证选择是否与当前 API Key 供应商匹配。 |
| 401 / 403 | 密钥有效性、账号权限，以及是否混用了不同认证方式。 |
| 404 / 请求格式不支持 | 服务地址路径、Gemini 接口能力，以及预设是否要求本地路由。 |
| 模型不可用 | GEMINI_MODEL 是否为供应商实际开放的模型 ID。 |
| 仍连接旧地址 | CLI 读取的配置目录、终端环境变量及项目级配置。 |
常见问题
Gemini CLI 可以直接使用任何 OpenAI 兼容服务吗？
不能直接这样判断。供应商需要提供 Gemini CLI 所需接口，或通过匹配的本地路由转换。请按供应商端点能力与 NexoX 预设选择连接方式。
API Key 和 Google 官方登录可以混用吗？
应分别配置。选择与实际服务匹配的供应商预设和认证方式，避免旧环境变量或项目配置使 CLI 使用另一套认证信息。