Gemini CLI 怎么用？安装、登录与 Google AI Pro 额度

Gemini CLI 是什么，适合谁？

它是运行在终端里的 Gemini 客户端，适合习惯命令行、希望让 AI 直接理解项目文件的开发者。

和网页版相比，CLI 的上下文来自当前目录：它可以看到你允许它读取的文件，帮你解释代码、生成改动建议、整理命令输出。优势是贴近项目，风险也是贴近项目——权限给得越多，越需要谨慎。

如果你只是偶尔问答，网页版更简单；如果你每天在终端里工作，CLI 能减少复制粘贴。先用小项目试，确认工作流合适再迁移到主项目。

安装前要准备什么？

准备 Node.js LTS、一个可用的终端、稳定的网络环境，以及能正常登录的 Google 账号。

• Node.js：按官方 README 要求安装 LTS 版本，避免用过旧的 Node。
• 终端：Windows 可用 PowerShell/Windows Terminal，macOS/Linux 用系统终端。
• Google 账号：能正常登录，且没有触发异常验证。
• 项目目录：第一次用一个不含敏感信息的测试仓库。

怎么安装并完成第一次登录？

按官方 README 用 npm 全局安装，运行 `gemini` 后选择 Google 登录，按浏览器提示完成授权。

如果 npm 全局安装报权限错误，优先用 Node 版本管理器或官方推荐的安装方式，不要直接改系统目录权限。命令与包名可能随版本变化，安装前以官方 README 为准。

1. 1打开终端，确认 `node -v` 与 `npm -v` 能正常输出版本。
2. 2按官方说明执行全局安装命令（常见形式为 `npm install -g @google/gemini-cli`）。
3. 3运行 `gemini`，选择使用 Google 账号登录。
4. 4浏览器弹出授权页后，确认是你要使用的账号并完成登录。
5. 5回到终端，看到交互提示后再进入项目目录测试。

第一次在项目里怎么用？

先进入测试项目，问只读问题，再逐步尝试生成改动；任何执行命令的请求都要先看清内容。

1. 1`cd` 到一个测试项目目录，再运行 `gemini`。
2. 2先让它解释目录结构或某个文件，确认它读取的范围符合预期。
3. 3再尝试让它给出修改建议，要求先展示 diff，不要直接写入。
4. 4遇到需要执行 shell 命令的步骤，逐条确认命令内容与影响范围。
5. 5确认工作流后再在主项目使用，并保留版本控制以便回滚。

免费账号与 Google AI Pro 的额度差在哪？

免费账号有基础额度，AI Pro 通常提供更高额度与更完整的模型访问，但两者都不是无限量。

不要按「每天固定多少次」做预算，官方限额会随模型、地区和负载调整。更稳的做法是先用免费额度跑一周，记录触顶频率，再决定要不要升级。

登录失败/命令不可用怎么排查？

先查 Node 版本、安装路径、网络与账号验证，再查官方 issue；不要把 token 或完整日志发到公开聊天。

• `gemini` 找不到：检查 npm 全局 bin 是否在 PATH 中。
• 登录循环：确认浏览器登录账号与终端选择一致，清除旧授权后重试。
• 网络超时：检查代理、防火墙或公司网络策略。
• 账号验证：先按 Google 账号恢复流程处理，不要反复换号。
• 命令报错：记录版本与错误摘要，查阅官方 README/issue，隐去密钥与个人信息。