Gemini CLI 是什么？
Gemini CLI 是 Google 的命令行代理：它在你的终端中运行 Gemini，在那里它可以读取文件、编辑文件、运行命令以及处理多步任务，而无需你离开 shell。
这种集成是其特色所在。终端代理可以与你已经从终端运行的所有其他东西协同工作，这意味着它可以集成到脚本、git hooks 和 CI 管道中，而桌面 IDE 永远无法做到这一点。
工具本身是廉价的。模型调用是经常性成本，而 AI Perks 跟踪 194 家公司总计 770 万美元的 AI 和云服务积分，这些积分可以覆盖这些成本。
如何安装 Gemini CLI
安装过程只需一个 npm 命令，唯一真正的先决条件是安装了当前的 Node.js。
请先检查你的 Node 版本，因为 CLI 代理更新很快，并且通常需要最新的 LTS 版本。如果你的 Node 版本过旧，请在调试其他任何问题之前先进行升级。令人惊讶的是，很大一部分安装问题其实是 Node 版本问题伪装的。
安装完成后，请进行身份验证。Google 提供了一个个人账户登录流程和一个 API 密钥路径。这个区别比看起来更重要：
个人登录 最快捷，适合在笔记本电脑上进行个人工作。
API 密钥 是你在 CI、共享机器以及任何脚本化场景中需要的东西，因为交互式登录无法无人值守运行。
如果你打算在自动化中使用 CLI，请从一开始就设置好 API 密钥路径。事后进行改造意味着需要重写你在交互式流程中构建的所有内容。
Gemini CLI vs Claude Code vs Codex CLI
这三者都是具有相同基本结构的终端代理，有意义的区别在于模型行为、上下文处理和价格。
| 工具 | 提供商 | 优点 | 注意事项 |
|---|---|---|---|
| Gemini CLI | 大上下文，强大的免费套餐 | 新生态系统 | |
| Claude Code | Anthropic | 精心进行多步编辑 | 大批量成本 |
| Codex CLI | OpenAI | 与 OpenAI 紧密集成 | 模型锁定 |
| Aider | 开源 | 模型无关，git 原生 | 需要更多设置 |
老实说，每天使用这些工具的开发者往往会安装两个，并根据任务选择使用。它们的安装成本很低，并且失败模式不同，因此拥有第二个选项比选择一个赢家更有价值。
它们共同的成本模型是：按 token 付费，而代理消耗的 token 比聊天窗口多得多。这就是 AI Perks 存在的目的。
Gemini CLI 有免费套餐吗？
Google 为 Gemini CLI 提供了一个使用量受限的免费套餐，与竞争性的终端代理相比，这非常慷慨。
配额和条款会发生变化，因此请根据 Google 的文档核实当前限制，而不是依赖任何博文中的数字，包括这篇。稳定的是战略层面：Google 一直以来都在以吸引开发者的方式为 Gemini 访问定价，而免费套餐是其中的一部分。
无论当前数字是多少，有两件事需要计划：
免费套餐会限速，但不会停止。 当你在任务进行中达到限制时，一个半途而廃的多文件编辑代理比从未开始更糟糕。
免费套餐用于评估，而非生产。 一旦 CLI 进入你的 CI 管道，你将开始付费使用。
这种过渡正是初创公司积分发挥作用的地方。AI Perks 会跟踪哪些提供商提供积分以及获得积分的条件。
在 CI 中使用 Gemini CLI
CI 中的终端代理是这些工具中杠杆率最高、风险也最高的使用场景。
高杠杆率是因为这些任务非常有价值：为新代码生成测试脚手架、起草日志条目、分类失败、提议依赖项升级。
高风险是因为一个拥有仓库写入权限且没有人为干预的代理是一种很难撤销的错误类型。
三个规则可以使其安全：
永远不要让代理推送到受保护的分支。 让它打开一个 pull request，永远如此。
为每个任务设置一个 token 限额。 一个卡在重试循环中的代理，针对一个不稳定的测试，可以在被注意到之前消耗大量资金。
记录完整的对话记录。 当它做了一些奇怪的事情时，对话记录是理解原因的唯一方法。
Gemini CLI 在实际使用中的成本
成本驱动因素不是你运行了多少任务，而是代理在采取行动之前读取了多少内容。
针对三个已知文件进行范围明确的指令，成本仅为开放式指令针对大型仓库成本的一小部分，因为后者花费了大部分 token 进行探索。
实际的控制手段，按影响程度排序：
命名文件。 告知代理在哪里查找，消除了任务中最昂贵的部分。
保持仓库的可导航性。 清晰的结构和良好的 README 可以降低未来所有任务的探索成本。
先运行便宜的检查。 一个在两秒内失败的类型检查，可以避免代理花费两分钟在错误的假设上构建。
用积分资助。 每个主要提供商都运行初创公司计划，妥善组合可以覆盖大多数早期团队的第一年。这就是 AI Perks 的全部理念。
如何支付模型账单
步骤 1：在扩大使用规模之前获取积分，而不是之后。 打开 getaiperks.com 并按“AI 工具”和“云基础设施”进行筛选。这些类别对应模型调用。
步骤 2：申请多个计划。 各提供商的批准标准不同，广泛申请可以让你获得八个中的三个，而不是一个中的零个。
步骤 3：注意到期日期。 积分是有时间限制的。在淡季开始一个为期十二个月的赠款，会导致团队浪费积分。
步骤 4：每季度重新检查。 计划条款会不断变化，上个季度适用的计划通常不再适用于现在。
常见问题
我如何安装 Gemini CLI？
使用 npm 安装，并通过个人 Google 登录或 API 密钥进行身份验证。如果你打算在 CI 中运行它，请使用 API 密钥路径，因为交互式登录无法无人值守运行。请先检查你的 Node.js 版本，因为大多数安装失败都是 Node 版本问题。通过 getaiperks.com 的积分资助模型使用。
Gemini CLI 可以免费使用吗？
Google 提供了一个使用量受限的免费套餐，与竞争性终端代理相比非常慷慨。限制会变化，因此在规划特定配额之前，请查看当前文档。免费套餐适用于评估；生产使用是付费的，而初创公司积分可以在此时发挥作用。
Gemini CLI 比 Claude Code 更好吗？
没有绝对的哪个更好。Gemini CLI 在上下文大小和免费套餐慷慨度方面通常占优；Claude Code 在谨慎的多步编辑方面通常占优。大多数每天使用终端代理的开发者都会同时安装两者，并根据任务进行选择。
我可以在 GitHub Actions 中运行 Gemini CLI 吗？
可以，使用 API 密钥身份验证而不是交互式登录。将其限制为打开 pull requests 而不是直接推送，为每个任务设置 token 限额，并记录完整的对话记录，以便能够调试失败。
Gemini CLI 每月花费多少？
它在很大程度上取决于你如何向它下达指令，而不是你使用它的频率，因为探索是主要的成本。大多数初创团队不进行预测，而是通过提供商积分来支付费用。AI Perks 在 getaiperks.com 跟踪了 194 家公司总计 770 万美元的费用。
我需要 Google Cloud 账户吗？
对于 API 密钥路径，你将在 Google 的开发者工具中进行操作。如果你已经在争取 Google Cloud 初创公司积分，那么两者可以很好地结合，这值得在选择提供商时加以考虑。在 getaiperks.com 上查看适用内容。
从哪里开始
安装它，指向一个小型、机械化的任务，然后观察它在采取行动之前读取了什么。这一项观察比任何定价页面都能让你更多地了解成本控制。
然后，在扩大使用规模之前确保资金到位，因为这是有截止日期的部分。
运行代理。让别人来支付 token 的费用。