KechuAI

Gemini CLI：Google 开源的终端 AI Agent，以及它在 2026 年被官方"让位"给 Antigravity 的现实

AI
Google
Gemini
CLI
开源
Agent
2026/10/22
·

阅读时间: 大约 12 分钟

Gemini CLI：Google 开源的终端 AI Agent，以及它在 2026 年被官方”让位”给 Antigravity 的现实

Google 官方发布信息图：免费档位 60 次模型请求/分钟、1000 次/天，Apache-2.0 开源（官方博客）

2025 年 6 月 25 日，Google 在 The Keyword 官方博客宣布开源 Gemini CLI：一个把 Gemini 能力直接带进终端的开源 AI Agent，Apache-2.0 协议，个人 Google 账号登录即可免费用。科技周报收录的正是这次发布。本文基于官方发布博客、GitHub 仓库 README（调研时点 2026-10-22）做一手梳理，并重点核对一个容易被旧文章忽略的最新事实：这个项目在 2026 年已经被官方定位为”让位”状态。

一、发布背景：终端为什么需要一个 Agent

官方发布文的判断是：CLI 对开发者不只是工具而是”家”，终端的效率、普适性与可移植性使其成为干活的默认界面，因此集成式 AI 助手的需求持续存在。Gemini CLI 的定位是”最轻量地访问 Gemini，从 prompt 到模型路径最短”，不只做编码，还覆盖内容生成、问题求解、深度研究与任务管理等本地杂务，并与 Google 的 Gemini Code Assist 共享底层技术。

二、免费配额与三种认证方式

发布时（preview）个人用户用 Google 账号登录即可获得免费 Gemini Code Assist 许可，访问 Gemini 2.5 Pro 与 100 万 token 上下文，官方给出的免费用量为 60 次模型请求/分钟、1000 次请求/天（上图官方信息图）。需要特定模型或并发多 Agent 的专业用户，则走三条认证路径（README 当前口径）：

认证方式适用关键环境变量/说明
Google 账号 OAuth个人免费档组织付费 Code Assist 许可需设置 GOOGLE_CLOUD_PROJECT
Gemini API Key需要选具体模型、按量计费GEMINI_API_KEY，取自 AI Studio
Vertex AI企业合规、高配额GOOGLE_API_KEY + GOOGLE_GENAI_USE_VERTEXAI=true

三、能力与扩展机制

README 列出的核心能力：查询/编辑大型代码库；借助多模态从 PDF、图片或草图生成新应用；自然语言调试；自动化运营任务（查 PR、处理复杂 rebase）；通过 MCP 服务器接入新工具（包括 Imagen、Veo、Lyria 的媒体生成）；非交互脚本运行（-p 直出文本，--output-format json 取结构化结果，--output-format stream-json 取逐行事件流）。

内置工具覆盖文件系统操作、Shell 命令、Web Fetch 与搜索；持久上下文靠仓库根的 GEMINI.md；另有会话检查点（Checkpointing）、Token 缓存、受信任文件夹（Trusted Folders）与沙箱执行策略。扩展侧除 MCP 外，2025 年 10 月 8 日官方又推出 extensions 框架：一条 gemini extensions install <GitHub URL 或本地路径> 即可装入带内置 “playbook” 的预打包集成（发布合作方含 Dynatrace、Elastic、Figma、Postman、Shopify、Snyk、Stripe 等），官方称发布三个月已有超一百万开发者在用。2025 年 8 月 6 日还发布了 beta 版 GitHub Actions（issue 分诊、PR 评审、@gemini-cli 委派，支持 WIF 无凭证认证、命令白名单与 OpenTelemetry 遥测）。

安装方式（README）：npx @google/gemini-cli 免安装直跑，或 npm install -g @google/gemini-cli、Homebrew、MacPorts、conda。发布分三条通道：Preview（每周二 23:59 UTC，未经完整审查）、Stable（每周二 20:00 UTC，上周 Preview 晋升 + 修复）、Nightly（每日 00:00 UTC，main 分支未验证）。

四、仓库体量：人气很高，但人气不等于质量

GitHub 仓库 About 区（调研时点 2026-10-22 截图）

调研时点仓库数据（截图快照，会随时间变动）：约 107.5k stars、14.8k forks、586 watching，Apache-2.0，6,524 次提交，开放 issues 487、PR 259。需要注意：star 数反映关注度而非工程质量；Apache-2.0 开放的是 CLI 代码本身，底层 Gemini 模型仍走 Google API 配额，并非权重开源。

五、关键口径：2026 年 README 的两条”让位”声明（必须读）

当前 README 顶部以 Note 形式写明两条旧文章不会告诉你的事实：

  1. “Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026.”——免费档与 Google One 用户已于 2026 年 6 月 18 日被 Antigravity CLI 替代；
  2. “Gemini CLI has not been optimized for Gemini 4 Argon. To use Gemini 4 Argon, please use Antigravity.”——未针对最新 Gemini 4 Argon 优化，README 在安装与上手两节重复建议”要最佳编码体验请用 Antigravity CLI”。

这意味着：2025 年”免费登录即用 Gemini 2.5 Pro”的叙事在 2026 年对免费用户已不成立，新项目选型应以 Antigravity 为准，本仓库进入维护/遗留状态。

六、评测与口径批判

  • 60/分钟、1000/天是 preview 期数字，发布博客原文强调”preview 期间尽量不触限”，后续配额随档位与政策调整，不能当作永久报价；
  • “行业最大免费额度”是官方对标口径，未给出横向对比的完整榜单与时间点；
  • 终端 Agent 的安全风险在使用者侧：Shell 执行能力强，必须依赖受信任文件夹、命令白名单与沙箱策略，官方提供了开关但不强制；
  • 百万开发者、top-rated 类表述均为官方自述，无独立第三方编码基准排名背书。

七、客观分析：优势与局限

优势：

  1. Apache-2.0 全开源 + 可自查安全，适合需要审计 Agent 行为的团队；
  2. 标准生态齐全：MCP、GEMINI.md、自定义命令、extensions、脚本化 headless 模式，易嵌入 CI/CD；
  3. 多认证路径覆盖个人免费、API 按量与企业 Vertex；
  4. 三条发布通道让稳定版与尝鲜版分离。

局限：

  1. 官方已将主力迁移至 Antigravity，免费 OAuth 路径对 unpaid 用户关闭，新项目不应再以它为默认；
  2. 未适配最新 Gemini 4 Argon，模型代际上落后；
  3. 代码开源但模型闭源，成本与配额受 Google 政策约束；
  4. 终端执行权限大，安全配置不到位时有误删/越权风险。

八、谁该关注

  • 已有脚本化工作流的个人开发者：可继续用 API Key 方式作为轻量终端助手；
  • 企业 Vertex 用户：评估前先确认官方推荐路径是否已转向 Antigravity；
  • 想学习开源终端 Agent 实现的读者：仓库 TypeScript monorepo 结构、工具层与 MCP 集成仍是不错的教材；
  • 2026 年新启动的编码项目：优先看官方现在主推的 Antigravity CLI，而非本文主角。

补充一个工程视角：headless 模式（gemini -p "..." --output-format json）让 CLI 可以被 shell 脚本、CI 与内部自动化直接调用，stream-json 还能逐行消费长任务事件，这是它区别于纯聊天面板的价值点；但也正因为它能直接执行 Shell 命令，团队落地时应先用受信任文件夹与命令白名单圈定可操作目录，再放开自动化，避免 Agent 在脚本里误删文件或访问凭证目录。三条发布通道（Nightly/Preview/Stable）适合不同人群：个人尝鲜可追 Preview，生产脚本应锁定 Stable，Nightly 只建议贡献者自测。

参考来源