# Gemini CLI

Gemini CLI 是 Google 推出的开源终端 AI 智能体，用于编程、代码库探索、任务自动化以及基于 MCP 的工作流。由于 Google 正在将个人用户迁移至 Antigravity CLI，目前该工具被视为具有明确迁移路径的传统 Gemini 终端智能体。

Canonical URL: https://aiidelist.com/zh/ide/gemini-cli

Language: zh

更新日期: 2026-10-06

## 概览

- 分类: Terminal / CLI Coding Agents
- Gemini CLI 是 Google 为 Gemini 驱动的开发工作流推出的开源终端编程智能体，目前定位为向未来“智能体优先”开发模式（Antigravity CLI）过渡的传统工具。
- 编辑器基础: CLI
- 平台: macOS, Linux, Windows, Terminal, Node.js/npm, GitHub Actions, Google AI Studio, Vertex AI, Google Cloud, Zed via agent integrations where supported
- 开源: 是
- 本地模型支持: 否
- 自带 API 密钥: 是

## 简评

Gemini CLI 作为 Google 重要的开源终端智能体值得记录，但新个人用户应优先考虑 Antigravity CLI，因为 Google 已将其定为后续迁移路径。现有用户应保留有效配置，检查配额，并在消费级服务变更生效前规划迁移。

## 适合场景

- 现有的 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 等工具。

## 为什么选择 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 的核心概念，但运行时、命令行为和智能体编排模型可能存在差异，团队在将其用于生产工作前应进行充分测试。

## 功能

### 终端 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 对于现有工作流、企业配置和迁移规划仍然具有参考价值。

## 价格

freemium

- 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 Ultra: Plan-dependent — 月 — 更高层级的 Google AI 方案，扩展了对 Google AI 功能的访问，并在支持的情况下提供更高的开发者工具配额。
- Gemini API Key: Usage-based — 通过 Google AI Studio API 密钥使用 Gemini CLI，按 Gemini API 的 Token 价格计费。
- Vertex AI / Enterprise: Usage-based — 在专业和组织工作流中，通过 Vertex AI 或企业级 Google Cloud 身份验证使用 Gemini CLI。
- Antigravity CLI Migration: $0+ — Google 官方为消费者提供的后续路径是 Antigravity CLI，作为全新的 Antigravity 智能体优先开发平台的一部分提供。

价格核对日期: 2026-06-14

## 支持的模型

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

## 隐私与数据处理

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

## 企业功能

- Vertex AI 身份验证
- 基于 Google Cloud 项目的使用模式
- Gemini Code Assist 企业级工作流
- 通过 Google Cloud 和 Code Assist 方案进行配额管理
- GitHub Actions 自动化
- MCP 服务器集成
- 向 Antigravity CLI 和 Google Antigravity 的企业迁移路径

## 替代工具

- Google Antigravity
- Antigravity CLI
- Claude Code
- Codex CLI
- OpenCode
- Aider
- Qwen Code
- Cline
- Roo Code
- Cursor
- Windsurf
- GitHub Copilot

## 资料来源

- [官方网站](https://developers.google.com/gemini-code-assist/docs/gemini-cli)
- [Gemini CLI 文档](https://developers.google.com/gemini-code-assist/docs/gemini-cli)
- [Gemini CLI GitHub 仓库](https://github.com/google-gemini/gemini-cli)
- [Gemini CLI 配额与定价](https://github.com/google-gemini/gemini-cli/blob/main/docs/resources/quota-and-pricing.md)
- [Gemini CLI 方案](https://geminicli.com/plans/)
- [Gemini API 定价](https://ai.google.dev/gemini-api/docs/pricing)
- [Gemini CLI 介绍](https://blog.google/innovation-and-ai/technology/developers-tools/introducing-gemini-cli-open-source-ai-agent/)
- [Gemini CLI GitHub Actions 发布公告](https://blog.google/innovation-and-ai/technology/developers-tools/introducing-gemini-cli-github-actions/)
- [run-gemini-cli GitHub Action](https://github.com/google-github-actions/run-gemini-cli)
- [Gemini Code Assist 配额](https://developers.google.com/gemini-code-assist/resources/quotas)
- [Gemini CLI 向 Antigravity CLI 的过渡说明](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)
- [Google Antigravity 官网](https://antigravity.google/)

最近核对日期: 2026-06-14

## 更新记录

- 2026-06-14: 创建条目，涵盖 Gemini CLI 开源状态、终端智能体工作流、Gemini Code Assist 与 API 定价路径、MCP 与 GitHub Actions 支持，以及 Google 宣布的 Antigravity CLI 迁移计划。
- 2026-08-14: 关联了新的 Antigravity CLI 条目并更新了迁移对比路径。
