大约 1 分钟常见问题
Gemini CLI 常见问题
安装相关
Q: npm install -g @google/gemini-cli 失败
参考 Claude Code 常见问题 - 安装相关 的通用解决方法。
配置相关
Q: 一直让我用 Google 账号登录
Gemini CLI 默认走 OAuth，需要手动切换到 API Key 模式。
解决：
删除已有 OAuth 凭据：
# Linux / macOS rm ~/.gemini/oauth_creds.json # Windows PowerShell Remove-Item $env:USERPROFILE\.gemini\oauth_creds.json设置环境变量：
export GEMINI_API_KEY="sk-你的令牌" export GOOGLE_GEMINI_BASE_URL="https://www.huiliuapi.com/gemini"重启终端，再次启动
gemini，应该会进入 API Key 模式。
Q: 报 Invalid API Key
- 令牌错误：重新复制完整
sk-开头令牌 - 分组错误：必须是 Gemini 分组
Q: 报 Endpoint not found
GOOGLE_GEMINI_BASE_URL 配置错。正确格式：
https://www.huiliuapi.com/gemini不要写成：
- ❌
https://www.huiliuapi.com/v1 - ❌
https://www.huiliuapi.com/gemini/v1 - ❌
https://generativelanguage.googleapis.com
调用相关
Q: 工具调用（如读文件）失败
Gemini CLI 的工具调用依赖项目级配置。
检查项目根目录有没有 .gemini/settings.json：
{
"selectedAuthType": "gemini-api-key",
"apiKey": "sk-你的令牌"
}Q: 长上下文很慢
Gemini 2.5 Pro 支持 1M context，但越长越慢。
优化方法：
- 用
/clear清空不必要的历史 - 拆分任务，单次只问一个问题
- 简单任务用
gemini-2.5-flash
Q: 流式响应中断 / 卡住
检查本地网络代理设置。建议：
- 关闭本机的 HTTP 代理
- 或者把
huiliuapi.com加入代理白名单
模型相关
Q: 推荐模型
| 场景 | 推荐 |
|---|---|
| 长上下文 / 编程 | gemini-2.5-pro |
| 快速响应 | gemini-2.5-flash |
| 多模态（图像 / 视频） | gemini-2.5-pro |
Q: 怎么切换模型？
启动时加参数：
gemini --model gemini-2.5-pro或在 CLI 内输入 /model。