Gemini CLI 卡在 thinking 状态一直转圈不动

问题

在使用 Gemini CLI 执行任务时，界面停留在转圈的 "thinking..." 状态，持续 10 分钟、20 分钟甚至更久，毫无任何进展，也没有给出任何错误提示。强制 Ctrl+C 退出后重启，现象依然复现。

根本原因：绝大多数情况下，这是 429 Too Many Requests（配额耗尽） 错误的表现。Gemini CLI 在遭遇 429 时不会立即报错，而是静默重试或假性等待，导致看起来像是"卡死"。

你可以通过浏览器 F12 开发者工具观察网络请求，会看到 status: 429, statusText: 'Too Many Requests'。

解决方案

方案一：等待配额重置（最根本的解决方式）

Gemini CLI 免费配额按日重置（UTC 午夜）。如果今天已用完，只能等到次日：

• Google 账号免费层：每日 1,000 次
• API Key 免费层：每日 250 次

查看当前用量：

/stats model

方案二：升级配额套餐

如果频繁遇到 429，考虑升级到更高配额套餐：

• Google AI Pro：每日 1,500 次
• Google AI Ultra：每日 2,000 次
• Gemini API Key 按量付费：无每日限制，按 Token 计费

详情参考：配额与定价指南

方案三：切换为 API Key 认证

如果使用 Google 账号认证，切换到 API Key 可能拥有独立的配额池：

export GEMINI_API_KEY=你的APIKey
gemini

方案四：按 Ctrl+C 中断并缩小任务范围

在配额未耗尽时，如果长时间卡顿，先按 Ctrl+C 中断，再将任务分解为更小的步骤逐个执行，减少单次 Token 消耗。

注意：此问题不是 Gemini CLI 的 bug，而是 Google 服务端的速率限制机制。官方正在改进 CLI 对 429 的错误提示方式，以避免用户误以为"卡死"。