Gemini
Gemini CLI 和 Gemini 模型使用中的常见问题
配置教程见 Gemini CLI 配置。
仍然跳转到 Google 账号登录
说明当前选的是 Google 账号登录。在 Gemini CLI 里输入 /auth，改选 Use Gemini API Key。同时确认 ~/.gemini/.env 里有 GEMINI_API_KEY 和 GOOGLE_GEMINI_BASE_URL。
返回 unsupported Gemini CLI action
Gemini CLI 的「Login with Google」（Code Assist）模式有部分接口平台不支持，请改用 API Key 登录方式。
提示模型不存在或 No eligible upstream
GEMINI_MODEL是否和 模型广场 里的名字一致，例如gemini-3.1-pro-preview、gemini-3.8-flash；- 密钥的分组里是否有这个模型；
GOOGLE_GEMINI_BASE_URL是否为https://omini.ominiapi.top，没有带/v1或/v1beta。
更多错误见 错误码。
Gemini CLI 不稳定怎么办
Google 官方 Gemini CLI 更新频繁，偶尔会出现无法调用模型、无法粘贴图片等问题。遇到这种情况，可以改用支持 OpenAI 兼容接口的工具来使用 Gemini 模型，例如下面的 Cline，或者 OpenCode、Cherry Studio。Gemini 模型也能在 Claude Code 和 Codex 里使用。
在 Cline 中使用 Gemini
准备 API Key
在控制台 API 密钥 页面创建 Key，确认它的分组包含 Gemini 模型。
安装 Cline 插件
打开 VS Code（1.80.0 以上），点击左侧「扩展」（Ctrl + Shift + X / Cmd + Shift + X），搜索 Cline 并安装。安装后左侧边栏会出现 Cline 图标。
打开 Cline
点击左侧边栏的 Cline 图标；或按 Ctrl + Shift + P / Cmd + Shift + P，输入 Cline: Open 回车。
填写配置
点击 API Configuration（用过 Cline 的话点右上角 ⚙️ 设置），按下表填写，然后点右上角 Done：
| 配置项 | 填写 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://omini.ominiapi.top/v1（要带 /v1） |
| API Key | 你的 OminiApi API Key |
| Model ID | gemini-3.1-pro-preview，或其它分组里有的 Gemini 模型 |
不要在群聊或公开截图里泄露 API Key。