本页汇总 Gemini CLI 用户在 GitHub Issues 和社区中报告的已知问题及解决方案。所有条目均经过筛选，只收录有明确解决方法的问题，宁缺毋滥。

Gemini CLI 已知问题总索引 #

本索引持续更新，来源包括 GitHub Issues 和社区讨论。

Agent 行为 #

• Agent 过于激进地修改代码，不经确认直接大范围变更
• Ctrl+C 无法中断 Gemini CLI 正在执行的 Agent 任务

认证与登录 #

• Google 账号登录后提示 403 PERMISSION_DENIED 错误
• [社区] Gemini CLI 认证登录失败：auth login 卡住或报错

MCP 集成 #

• [社区] Gemini CLI 连接 MCP 服务器时报错 MCP error -32000: Connection closed

Windows 兼容性 #

• 粘贴多行内容时字符逐个输入且卡顿
• Windows 下斜杠命令自动补全失效或崩溃

模型过载与配额 #

• API Key 使用时频繁出现 503 模型过载错误（The model is overloaded）

网络与代理 #

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

性能问题 #

• Gemini CLI 启动时间过长，高达 9.77 秒

其他 #

• [社区] Gemini CLI 在 macOS Intel 启动时因 TypeError: fetch failed (undici) 崩溃

运行 gemini-cli-docs-updater 技能可自动拉取最新 GitHub Issues 并更新此索引。