Gemini CLI 使用踩坑及解决
使用 Gemini CLI 遇到一些问题,分享一下,希望能帮到大家。
结论:
-
Auth 方式影响模型: API Key -> Gemini 2.5 Flash ; Google 登录 -> Gemini 2.5 Pro 。
-
API Key 容易 429 。

问题及解决:
-
Google 登录失败( Workspace ):
- 报错:
Failed to login. Ensure your Google account is not a Workspace account... - 解决: 切换为
Login with Google Workspace登录。(参考)
- 报错:
-
缺少
GOOGLE_CLOUD_PROJECT环境变量:- 报错:
GOOGLE_CLOUD_PROJECT environment variable not found.Add that to your .env and try again, no reload needed! - 解决 (mac 实测 Win 应该同理):
- GCP 开启
Gemini Cloud API(Gemini Code Assist Standard & Enterprise)。 ~/.env添加:export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"(YOUR_PROJECT_ID 见 GCP 控制台)。- 重启 Gemini CLI 。
- GCP 开启
- 报错:
-
断开问题:
- 解决: 梯子开 TUN 模式,或终端
export https_proxy=xxx。
- 解决: 梯子开 TUN 模式,或终端
体验:
- 5 Pro 效果不错,但处理速度慢,基本一次小改动都要等好几分钟,不知道是不是和我有关系。




