
Gemini CLI 登录失败怎么解决?5 类报错对照修法
Gemini CLI 登录失败先别重装,按报错原文分类最快。复制终端第一行报错,对下表,找到对应段照做。
先判断你属于哪一类
| 报错关键词 | 你属于 | 去哪儿改 |
|---|---|---|
This client is no longer supported for individual |
第 1 类:个人账号通道停用 | 换认证方式 |
Failed to login + GOOGLE_CLOUD_PROJECT |
第 2 类:缺项目 ID | 加环境变量 |
卡在 Waiting for authentication... 转圈 |
第 3 类:回调失败 | 换认证方式 |
fetch failed / local proxy failed |
第 4 类:代理没生效 | 终端代理 |
429 / RESOURCE_EXHAUSTED / retryDelay |
第 5 类:额度用尽 | 等重置或换 Key |

第 1 类:个人账号 OAuth 已停用
报错原文:This client is no longer supported for Gemini Code Assist for individuals。原因不是账号坏,是 Google 从 2026 年 6 月 18 日起,不再为 Gemini CLI 提供服务,Login with Google 入口整体取消。
个人用户迁到 Antigravity。这是全文最重要的时效前提,前排旧教程全没写。官方说明见 Gemini Code Assist consumer accounts。
路线 A:改 API Key,留在 Gemini CLI。到 aistudio.google.com/apikey 拿 Key,设环境变量。
export GEMINI_API_KEY="你的KEY"
gemini
永久生效写进 ~/.zshrc 或 ~/.bashrc。Key 申请细节见 Gemini CLI API Key 配置。
路线 B:个人付费或 AI Pro 用户,官方迁移目标是 Antigravity CLI,命令从 gemini 变 agy,迁移指南 antigravity.google/docs/gcli-migration。
第 2 类:GOOGLE_CLOUD_PROJECT 缺失
报错原文:Error: Failed to login. Message: Request contains an invalid argument,社区版本常带 must configure GOOGLE_CLOUD_PROJECT。原因:CLI 拿不到免费额度资格时,需要知道把调用记到哪个 Cloud 项目名下。
三步:console.cloud.google.com 新建项目,复制项目 ID(形如 my-project-123456,是 ID 不是名称),回启动 gemini 的同一终端设变量。
export GOOGLE_CLOUD_PROJECT="你的项目ID"
gemini

最常踩坑:A 窗口设了变量去 B 窗口跑。变量只对当前会话生效,两窗口不通,关终端就失效,所以回同一窗口启动,想永久就写进 shell 配置。
第 3 类:OAuth 浏览器回调卡住
现象:终端停在 Waiting for authentication...,浏览器 authorize 页一直转圈。原因两个叠加:一是网络出口地区不被支持,二是 CLI 拿不到回调结果。
按顺序做:先确认代理真生效(第 4 类);关标签页重跑 gemini;若浏览器没弹出(远程服务器、WSL、SSH 常见),把终端打印的带 code= 授权链接整段贴回本机浏览器;仍不行就换 API Key,跳过浏览器授权。
第 4 类:代理没被读到
报错原文:TypeError: fetch failed、local proxy failed、connect ETIMEDOUT,共同点是请求没出去。根因:Gemini CLI 默认不读系统代理,只看终端里的代理环境变量。开着代理软件、浏览器能上,不代表 CLI 能上,社区验证过,见博客园这篇实测。
先看终端有没有代理变量。
env | grep -i proxy
没输出说明没读到,设上;输出了已关掉的端口是残留,先清再重设。设置(端口按你代理改):
export https_proxy="http://127.0.0.1:7890"
export http_proxy="http://127.0.0.1:7891"
清理残留:
unset HTTP_PROXY HTTPS_PROXY ALL_PROXY http_proxy https_proxy all_proxy

第 5 类:免费额度用尽
报错原文:API Error: code 429, message You exceeded your current quota,完整结构见官方 Issue 6986。两个字段定位:quotaId 带 FreeTier 是免费层用完;retryDelay(如 13s)是短时限流,等这个时间再来。
另别踩:用 API Key 时项目没开计费,报 Quota exceeded ... limit: 0,这个 0 是「从没给过额度」不是用完,别等重置,先查付费。官方规则见 Gemini API rate limits。

修复从低到高:看 retryDelay 等够再发;gemini-2.5-pro 换 flash 轻量;换认证方式,切有计费 Key 或 Vertex AI;去 AI Studio 申请提升。
收尾:清缓存、自查、验证
改完还不生效,九成是本地旧凭据。先备份再删(bash 为例)。
cp -R ~/.gemini ~/.gemini.bak
rm -f ~/.gemini/oauth_creds.json ~/.gemini/google_accounts.json
启动后敲 /about 看 Auth Method:oauth-personal 是停用老路,gemini-api-key 表示 Key 生效,vertex-ai 走 Google Cloud。最后端到端验证,能返回回复才算通。
gemini -p "回复:收到"
若还在配 Skill,配完也建议跑这条验证,别把认证和 Skill 加载混在一起,步骤见 Gemini CLI 自定义 Skill 教程。
如何避免下次重犯
把代理和 Key 固化进 shell 配置(bash 在 ~/.zshrc 加判断,进程在就自动设变量)。.env 进版本管理时 Key 别提交,CI 用 Secret 注入。同一思路对 Claude Code 也管用,见 Claude Code 登录失败怎么办:先分清认证、网络还是额度。
常见问题
Gemini CLI 装好了但 gemini 命令找不到?
不是登录问题,是安装没进 PATH。Windows 执行 `$env:Path += ";$env:APPDATA pm"` 补上或重开终端;macOS 用 `npm install -g @google/gemini-cli` 重装确认全局路径。
个人 Gmail 为什么也要求配 GOOGLE_CLOUD_PROJECT?
按官方文档,带 Google Workspace 属性或关联过 Google Cloud 的 Gmail 账号,可能拿不到 Code Assist 免费层资格,所以要显式指定项目 ID 挂靠,项目创建使用不收费,只是记账容器。
设完环境变量还是报同样的错?
三个检查点:变量设 A 窗口却 B 窗口启动;`~/.gemini/oauth_creds.json` 残留旧凭据,CLI 优先读缓存;当前目录 `./.gemini/settings.json` 覆盖用户级。启动后跑 `/about` 看 Auth Method 那行是真实在用的认证方式。
Gemini CLI 现在还能免费用吗?
个人账号免费 OAuth 通道 2026 年 6 月 18 日已停,不能再 Login with Google。现在能走的免付费路径是 AI Studio 出的 API Key,额度规则和 Code Assist 免费层是两码事,以 AI Studio rate limits 页为准。

京ICP备2024094994号-29