Gemini CLI

Gemini CLI 是 Google 为 Gemini 驱动的开发工作流推出的开源终端编程智能体,目前定位为向未来“智能体优先”开发模式(Antigravity CLI)过渡的传统工具。

安装文档

资料核对: 2026年6月14日 ·查看来源

工具信息

工具类型
CLI 代理
平台
macOS, Linux, Windows, Terminal, Node.js/npm, GitHub Actions, Google AI Studio, Vertex AI, Google Cloud, Zed via agent integrations where supported
免费方案
支持
开源
支持
自带密钥
支持
本地模型
不支持
Gemini CLI

工具概览

适合场景

  • 现有的 Gemini CLI 用户
  • 终端优先的 Gemini 工作流
  • 使用 Google AI Studio 或 Vertex AI 的开发者
  • 代码库探索
  • Bug 修复
  • 测试生成与测试覆盖率提升
  • GitHub Issue 分拣
  • 拉取请求(PR)审查自动化
  • 连接 MCP 的开发任务
  • 计划迁移至 Antigravity CLI 的团队

优点

  • 由 Google Gemini 生态系统支持的开源终端智能体。
  • 在支持期间提供慷慨的个人免费访问额度。
  • 直接在开发者终端工作流中运行。
  • 支持 MCP 以进行工具和上下文集成。
  • Google AI Studio 和 Vertex AI 路径同时支持个人和云端工作流。
  • 官方 GitHub Actions 集成可实现仓库自动化。

局限与取舍

  • 寻求 Google 最新编程智能体平台的个人新用户
  • 需要本地模型运行的用户
  • 希望跨供应商进行模型路由的开发者
  • 寻找“对话即应用”构建器的非技术用户
  • 无法允许 AI 智能体读取文件或运行命令的团队
  • 想要完整的 AI 原生编辑器而非终端智能体的用户
  • 消费级 Gemini CLI 正在逐步停用,由 Antigravity CLI 取代。
  • 对于新的个人用户,其前瞻性不如 Google Antigravity。
  • 使用配额和计费因身份验证方法和方案而异。
  • 终端智能体需要谨慎的命令审批和严格的安全纪律。
  • 并非完整的 AI IDE 或可视化应用构建器。
  • 供应商灵活性低于 OpenCode 或 Aider 等工具。

开始使用

价格与使用额度

提供免费方案

Individual Free$0 / 月

通过面向个人的 Gemini Code Assist 免费获取个人 Gemini CLI 访问权限,需 Google 账号身份验证并受配额限制。消费级支持将于 2026 年 6 月 18 日迁移至 Antigravity CLI。

Google AI Pro$19.99 / 月

Google AI 方案,在 Gemini CLI 可用期间提供更高的 Gemini CLI 和 AI 工具使用限制。

Google AI UltraPlan-dependent / 月

更高层级的 Google AI 方案,扩展了对 Google AI 功能的访问,并在支持的情况下提供更高的开发者工具配额。

Gemini API KeyUsage-based

通过 Google AI Studio API 密钥使用 Gemini CLI,按 Gemini API 的 Token 价格计费。

Vertex AI / EnterpriseUsage-based

在专业和组织工作流中,通过 Vertex AI 或企业级 Google Cloud 身份验证使用 Gemini CLI。

Antigravity CLI Migration$0+

Google 官方为消费者提供的后续路径是 Antigravity CLI,作为全新的 Antigravity 智能体优先开发平台的一部分提供。

价格核对: 2026年6月14日 · 额度、模型费用与订阅价格可能分别计算。

功能与详细介绍

终端 AI 智能体

  • 在本地开发工作流中通过命令行运行 Gemini。
  • 使用“思考-行动”循环(Reason-and-act loop)及内置工具来检查、修改和验证工作。
  • 支持 Bug 修复、功能开发和测试覆盖率提升等编程任务。

项目感知工作流

  • 结合本地项目上下文和仓库文件进行工作。
  • 协助解释代码、生成实现计划、更新文件并运行命令。
  • 支持面向任务的提示词,而非仅限于单次对话响应。

MCP 与工具访问

  • 支持本地和远程 MCP 服务器。
  • 可通过配置好的 MCP 集成连接到外部工具和数据源。
  • 适用于需要文档、API、数据库或服务上下文的工作流。

身份验证路径

  • 支持 Google 账号身份验证,供个人 Gemini Code Assist 用户使用。
  • 支持来自 Google AI Studio 的 Gemini API 密钥。
  • 支持 Vertex AI 身份验证,适用于 Google Cloud 和企业环境。

GitHub 自动化

  • Gemini CLI GitHub Actions 可支持 Issue 分拣和 PR 审查工作流。
  • run-gemini-cli Action 将 Gemini CLI 集成到基于 GitHub 的开发流程中。
  • 可通过明确的工作流配置委托仓库自动化任务。

迁移状态

  • Google 已宣布面向消费级用户的 Gemini CLI 正在向 Antigravity CLI 迁移。
  • Gemini CLI 的重要概念(如智能体技能、钩子、子智能体和扩展)将在 Antigravity CLI 中延续。
  • Gemini CLI 对于现有工作流、企业配置和迁移规划仍然具有参考价值。

为什么选择 Gemini CLI?

Gemini CLI 的重要性在于它为开发者提供了直接在终端调用 Google Gemini 模型的路径。开发者无需打开浏览器聊天窗口,即可在处理 Git、包管理器、测试和部署脚本的同一个 Shell 中提问、检查代码库、运行命令、连接工具并自动化日常软件任务。

关键的注意事项是产品方向。Google 已宣布面向消费级用户的 Gemini CLI 将迁移至 Antigravity CLI。这一变化影响了购买和采用决策:Gemini CLI 对于理解现有工作流和企业级配置仍然有用,但新的个人用户应将 Antigravity CLI 视为战略性的继任者。

核心工作流

实际的 Gemini CLI 工作流通常从本地项目开始。开发者要求智能体检查文件,分析 Bug 或功能需求,然后使用工具和命令完成特定范围的任务。最有效的模式不是发送一个巨大的提示词,而是一个“审查循环”:解释问题、检查相关文件、提出计划、执行更改、运行检查并审查结果。

当任务需要外部上下文时,MCP(模型上下文协议)至关重要。配置好的 MCP 服务器可以让 Gemini CLI 访问特定项目的工具、文档、API 或数据库。这使其比普通的终端聊天机器人更有用,但也增加了安全责任,因为每个连接的工具都会扩大智能体的可见范围和操作权限。

适用场景

Gemini CLI 适合在终端中自然进行的编程任务:解释陌生代码、修复小 Bug、更新测试、提高覆盖率、生成脚本、创建文档以及自动化仓库维护。对于希望在 Vertex AI、Gemini Code Assist 或 Google AI Studio 工作流附近使用原生 Gemini 助手的 Google Cloud 用户来说,它也非常有用。

对 GitHub Actions 的支持使其适用于 Issue 分拣和拉取请求(PR)审查自动化。然而,这些工作流应进行保守配置。在 CI 中运行的智能体可以节省时间,但在没有明确控制的情况下,不应允许其更改高风险文件、触发部署或根据不可信的指令采取行动。

竞品对比

与 Claude Code 相比,Gemini CLI 是 Google 原生的,与 Gemini、Google AI Studio、Vertex AI 和 Gemini Code Assist 的结合更紧密。Claude Code 则更适合深耕 Anthropic Claude 生态系统的团队。与 Codex CLI 的选择主要取决于模型偏好、组织政策、定价,以及团队是否已在使用 OpenAI 或 Google 的基础设施。

与 Aider 和 OpenCode 相比,Gemini CLI 的供应商中立性较低。Aider 和 OpenCode 更适合希望有广泛模型选择、进行本地模型实验或追求更独立开源工作流的开发者。Gemini CLI 则更适合想要 Google 模型栈和身份验证路径的开发者。

与 Google Antigravity 相比,Gemini CLI 现在是较旧的终端优先路径。Antigravity 是更新的以智能体为中心的平台,拥有 CLI、桌面控制中心、SDK 和多智能体编排功能。对于新的个人用户,Antigravity 是更具前瞻性的选择。

最佳配置建议

对于现有的 Gemini CLI 用户,最佳配置应保持保守并做好迁移准备。保持项目指令清晰,在进行重大更改前确保 Git 状态干净,将 MCP 服务器限制在受信任的工具内,并避免在未知仓库上运行智能体。如果使用 API 密钥计费,请在允许大规模代码库扫描或长自动化循环之前,设置预算警报并了解 Token 定价。

对于组织,应将实验性用法与生产仓库分开。在适用情况下使用 Google Cloud 身份和配额控制,审查 GitHub Actions 权限,并定义 Gemini CLI 可以读取、写入或执行的内容。任何计划大规模推广的团队现在都应评估是否应将工作流直接移至 Antigravity CLI。

迁移说明

最重要的迁移路径是从 Gemini CLI 到 Antigravity CLI。在切换之前,请盘点当前的 Gemini CLI 使用情况:身份验证方法、MCP 服务器、扩展、钩子(Hooks)、技能、子智能体、GitHub Actions 工作流、Shell 别名、脚本和 CI 任务。然后在截止日期影响消费级使用之前,在 Antigravity CLI 中测试相同的工作流。

迁移应通过实际任务进行验证:一个代码库问题、一个 Bug 修复、一个测试更新、一个由 MCP 驱动的工作流以及一个 GitHub 自动化任务。不要假设功能完全等同。Antigravity CLI 保留了 Gemini CLI 的核心概念,但运行时、命令行为和智能体编排模型可能存在差异,团队在将其用于生产工作前应进行充分测试。

模型支持与数据隐私

支持的模型

  • Gemini 2.5 Pro
  • Gemini models via Gemini API
  • Gemini models via Vertex AI

隐私与数据处理

根据身份验证方法的不同,Gemini CLI 可能会将提示词、本地项目上下文、文件内容、命令输出、MCP 工具结果和仓库元数据发送给 Google 或选定的 Google Cloud 模型端点。用户应避免在提示词、终端输出、MCP 工具或包含在上下文的文件中暴露密钥、凭据、客户数据、生产 Token 或私密文件。在针对不可信仓库运行 Gemini CLI 时需格外小心,因为终端智能体可能会受到项目文件中嵌入的恶意指令的影响。

指南、评测与常见问题

查看全部 8 篇

产品动态

暂时没有经过核对的产品动态。关注后,新的相关内容会出现在「我的收藏」。

查看相关内容动态

替代工具

信息来源与核对记录

核对日期记录本站何时检查信息;不代表产品发版日期。

本站资料修订记录

  1. 关联了新的 Antigravity CLI 条目并更新了迁移对比路径。

  2. 创建条目,涵盖 Gemini CLI 开源状态、终端智能体工作流、Gemini Code Assist 与 API 定价路径、MCP 与 GitHub Actions 支持,以及 Google 宣布的 Antigravity CLI 迁移计划。