Gemini 常见问题

大约 4 分钟

Gemini CLI 常见问题

Gemini CLI 的最大坑：Base URL 末尾必须有斜杠。环境变量名也要分清楚。

Gemini CLI 和另外两个的差异

Gemini CLI：https://www.yuzhixiaolongxia.com/（末尾必须有斜杠）
Codex CLI：https://www.yuzhixiaolongxia.com/v1（带 /v1）
Claude Code：https://www.yuzhixiaolongxia.com（不带 /v1）

漏掉末尾斜杠 = 路径拼接出错 = 各种 404 / connection error。

1. `gemini` 命令装不上 / 装完用不了

怎么动手：

Node 版本：node -v，要求 18 或更高。

网络慢就换镜像：

npm config set registry https://registry.npmmirror.com
npm install -g @google/gemini-cli

gemini --version 没反应？npm 全局 bin 没在 PATH 里：
- macOS / Linux：echo "export PATH=$(npm config get prefix)/bin:\$PATH" >> ~/.zshrc && source ~/.zshrc
- Windows：npm config get prefix 拿到路径，加到系统环境变量 Path，重开终端。
死活装不上？用一键安装包避开 npm。

2. Base URL 末尾必须有斜杠

这是 Gemini CLI 用户最常踩的坑

export GOOGLE_GEMINI_BASE_URL="https://www.yuzhixiaolongxia.com/"
export GEMINI_API_KEY="你的令牌"

末尾的 / 不能省。漏了之后 Gemini CLI 会把模型路径直接拼到域名后面，得到形如 https://www.yuzhixiaolongxia.comv1beta/... 的怪请求，必然 404。

改完一定要重开终端让环境变量生效。

3. 环境变量名分清楚

两个变量名经常被搞混

GOOGLE_GEMINI_BASE_URL：Base URL，填平台地址（末尾带斜杠）
GEMINI_API_KEY：令牌，填你在 /console/token 创建的 Key

把令牌错填到 GOOGLE_GEMINI_BASE_URL、把 URL 错填到 GEMINI_API_KEY 的事，每周都有人犯。

完整配置（macOS / Linux 写到 ~/.zshrc）：

export GOOGLE_GEMINI_BASE_URL="https://www.yuzhixiaolongxia.com/"
export GEMINI_API_KEY="sk-xxxxxxxxxxxx"   # 你的实际令牌

Windows PowerShell（永久生效）：

[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://www.yuzhixiaolongxia.com/", "User")
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的令牌", "User")

设完重开终端。

4. 401 Unauthorized

怎么动手（按顺序）：

重新复制令牌：/console/token → 确认前后没有空格、换行。
确认环境变量名是 GEMINI_API_KEY（不是 GOOGLE_API_KEY、不是 GEMINI_TOKEN）。
重开终端，让新变量生效。
验证：跑一个最小请求，看是否还报 401。

5. 403 余额不足 / 分组不对

怎么动手：

余额：/console/personal，确认大于 0。
令牌分组：/console/token，Gemini 用的令牌分组必须是 Gemini 家族。
分组错了，新建一个 Gemini 家族令牌替换最快，比改老令牌靠谱。
余额够、分组对还是 403？看令牌是不是设了单独额度上限。

6. 模型 ID 错误 / `model not found`

怎么动手：

去 /pricing 复制最新 ID。
当前常用：
- gemini-3.1-pro-preview（推荐，对话）
- gemini-3.1-flash-image（生图，Nano Banana 系列）
改完配置或命令行参数后重开终端。
模型 ID 是对的还报错？回看第 5 题的分组检查。

7. 用 Gemini 生图（Nano Banana）

生图建议用图形客户端，不要用 CLI

Gemini CLI 本身是为对话和代码设计的，生图体验不流畅（没有图片预览、需要手动处理 base64 输出）。

推荐做法：

生图主力：用 Cherry Studio 配 gemini-3.1-flash-image，所见即所得。
CLI 真要生图：模型 ID 用 gemini-3.1-flash-image，记住返回的是图片 base64 或 URL，需要自己保存。
小贴士：提示词里写 "4K" 会自动识别并产出 4K 图，费用 +15%，不用额外加参数。

Cherry Studio 端配置：

API 地址：https://www.yuzhixiaolongxia.com/v1
模型：gemini-3.1-flash-image

生图失败时把 API 地址末尾加 #：https://www.yuzhixiaolongxia.com/v1#，可以规避某些客户端的路径拼接问题。

8. 网络不稳 / 偶发超时

怎么动手：

先短请求验通：跑一个最小提示词，看是否能拿到响应。
关闭无关代理：本地代理链路不稳是最常见原因。
换网络试：手机热点 / 其他 Wi-Fi，看是不是本地链路问题。
拆任务：长上下文拆成多轮对话，单次请求别太大。
团队用时统一出口：避免多人走不同代理导致结果不一致。

9. 怎么核对扣费

怎么动手：

/console/personal：看余额变化和消费记录。
/pricing：查当前模型的售价和分组倍率。
想分摊成本：测试令牌和生产令牌分开，账单一目了然。
单次请求扣费差异大？通常是输入 / 输出 token 规模不同导致的，看消费记录里的 token 数就能对上。

还没解决？

看监控状态页是否有平台公告
留意主站首页公告位
反馈时贴出：错误日志 + Base URL（末尾斜杠还在不在）+ 令牌分组 + 模型 ID

更多 Gemini 配置见 Gemini CLI 教程。