Gemini CLI

概述

Gemini CLI 是 Google 推出的开源终端 AI 智能体，将 Gemini 模型的能力直接带入命令行，开发者可以用自然语言在终端里对话，让模型读写代码、执行系统命令、调用工具，是目前把大模型能力直接接入终端的代表性工具之一。项目基于 Apache 2.0 协议开源发布在 GitHub 上，star 数超过 10 万。

Gemini CLI 支持接入能力更强的 Gemini 3 系列模型，并提供 100 万 tokens 的上下文窗口。使用个人 Google 账号登录即可直接使用，不需要单独申请或管理 API Key，登录方式本身就带有免费的请求额度；有更大用量需求，或需要团队、企业级管理能力的用户，也可以改用 Gemini API Key、已启用计费的 Google Cloud 账号，或企业版 Gemini Code Assist 授权接入。

核心功能

• 代码理解与生成：可以查询和修改大型代码库，还能基于 PDF、图片或手绘草图等多模态输入生成新应用，并用自然语言辅助调试和排查问题。
• 自动化与工具集成：可以自动处理查询 Pull Request、复杂分支合并等操作性任务，支持通过 MCP 协议连接外部服务器（包括 Imagen、Veo、Lyria 等媒体生成能力），也可以在脚本中非交互式运行以实现工作流自动化。
• 搜索增强与会话管理：内置 Google 搜索为回答提供实时信息，支持会话检查点用于保存和恢复复杂任务，还可以用 GEMINI.md 自定义文件为不同项目定制行为。
• GitHub 集成：通过官方 GitHub Action 自动进行 Pull Request 代码审查、Issue 分类，也可以在 Issue 或 PR 中提及 @gemini-cli 请求帮助，并支持搭建自定义的自动化工作流。
• Gemini 3 系列模型：接入能力更强的 Gemini 3 模型，支持 100 万 tokens 的上下文窗口。
• 个人账号免费额度：用 Google 个人账号登录即可使用，无需单独管理 API Key，登录方式自带每分钟 60 次、每天 1000 次请求的免费额度。
• 开源与多渠道接入：项目以 Apache 2.0 协议开源，除个人账号登录外，还支持 Gemini API Key、Google Cloud 计费账号或企业版 Code Assist 授权等接入方式。

适用场景

• 个人开发者用 Google 账号登录，在终端里直接调用 Gemini 模型编写、修改和调试代码，几乎不需要额外配置。
• 需要更高请求额度、已有 Gemini API Key 或 Google Cloud 账号的开发者，希望突破个人免费额度的限制。
• 使用企业版 Code Assist 授权的团队，希望在命令行中统一管理和使用 AI 编程能力，并纳入现有的管理和审计流程。
• 需要把 Gemini 模型接入自动化脚本、持续集成流程或其他现有开发工具链中的场景。
• 希望在开源项目基础上自行部署、审查代码或定制终端编程智能体的技术团队和安全团队。

如何开始使用

1. 在终端运行安装命令，例如直接用 npx @google/gemini-cli 运行，或用 npm、Homebrew 等方式全局安装。
2. 首次运行时选择身份验证方式：个人开发者可以直接用 Google 账号登录，免费获得每分钟 60 次、每天 1000 次请求的额度；也可以选择 Gemini API Key、已启用计费的 Google Cloud 账号或企业版 Code Assist 授权。
3. 在项目目录中启动 Gemini CLI，用自然语言清楚描述需要完成的开发任务和限制条件。
4. 查看模型给出的代码修改或命令执行结果，确认无误后再继续下一步操作或提交代码。
5. 如需连接更多工具或数据源，可以配置 MCP 服务器进行扩展。

价格与版本

版本	价格	主要内容
个人免费额度	0 美元	用 Google 个人账号登录即可使用，限速每分钟 60 次、每天 1000 次请求，无需管理 API Key
Gemini API Key	按官方 API 用量计费	自备密钥接入，费用按 Gemini API 官方价格计算，额度高于个人免费登录
Google Cloud 计费账号	按 Google Cloud 用量计费	通过已启用计费的云项目调用，适合已在云上部署应用的开发团队
Code Assist Standard	需查看官方文档	面向团队用户，提供高于免费额度的使用限额和基础管理功能，具体价格以官方文档为准
Code Assist Enterprise	需查看官方文档	面向企业客户，包含 SLA 保障与更完善的用户管理控制，具体价格以官方文档为准

以上信息截至 2026 年 9 月；超出个人免费额度的用量按 Gemini API、Google Cloud 或 Code Assist 的官方计价规则收费，货币单位为美元，具体额度和价格请以官方文档为准。

优势与局限

优势

• 项目完全开源，代码透明可审查，也支持开发者自行部署、修改和长期维护。
• 个人开发者用 Google 账号登录即可免费使用，不需要单独申请或管理 API Key。
• 接入 Gemini 3 系列模型，支持 100 万 tokens 的上下文窗口，并可通过 MCP 协议连接丰富的外部工具和数据源。
• 与 Google Cloud 和企业版 Code Assist 深度集成，适合已经使用该生态、需要更高额度或企业级管理能力的团队。

局限

• 个人账号的免费额度有每分钟和每日请求次数限制，超出后需要改用 API Key、Cloud 计费账号或企业授权，配置方式相对分散。
• 作为命令行工具，相比图形界面的编程助手学习门槛更高，不太适合完全不熟悉终端操作的用户直接上手。
• Preview 和 Nightly 发布渠道可能包含尚未完全验证的变更，生产环境建议使用 Stable 版本。
• 涉及企业合规、SLA 等具体条款和价格，需要查阅官方文档确认最新信息。

与同类工具对比

工具	定位	与本工具的主要区别
Claude Code	Anthropic 推出的终端编程智能体	同为命令行形式的编程智能体，其模型和计费体系均来自 Anthropic 公司
GitHub Copilot	AI 编程助手	以编辑器插件形式为主，命令行并不是它的主要交互方式
Cursor	AI 代码编辑器	提供图形化编辑器界面和 Agent 模式，而不是纯命令行工具

使用建议与注意事项

• 个人开发者如果只是想免费体验，直接用 Google 账号登录即可使用免费额度；达到每分钟或每日的请求次数限制后，再考虑改用 API Key 或其他计费方式。
• 使用 API Key 接入时，建议在官方文档中确认当前的免费额度、速率限制和计费规则，避免产生超出预期的费用。
• 企业采购 Code Assist 授权前，建议先按团队规模、使用频率和管理需求估算 Standard 与 Enterprise 版本的实际成本差异。
• 作为开源项目，自行部署或修改代码时应持续关注官方仓库的安全更新和版本变化，及时升级依赖。
• 服务与 Google 账号、Google Cloud 生态绑定，实际可用性和访问速度会因所在地区的网络环境不同而有差异。

常见问题

Gemini CLI 现在还能免费使用吗？

可以。用个人 Google 账号登录即可免费使用 Gemini CLI，免费额度为每分钟 60 次、每天 1000 次请求，且不需要单独申请或管理 API Key。如果需要更高的请求额度，可以改用 Gemini API Key、已启用计费的 Google Cloud 账号，或企业版 Code Assist 授权。

Gemini CLI 都有哪些安装和更新方式？

可以通过 npx 直接运行，也可以用 npm、Homebrew（macOS/Linux）、MacPorts（macOS）等方式全局安装；官方还提供 Stable、Preview 和 Nightly 三个发布渠道，分别对应稳定版本、每周预览版本和每日构建版本，可以根据对稳定性的要求选择安装。

Gemini CLI 支持哪些模型？

Gemini CLI 目前支持 Gemini 3 系列模型，提供 100 万 tokens 的上下文窗口和较强的推理能力。

Gemini CLI 是开源的吗？

是的，Gemini CLI 以 Apache 2.0 协议在 GitHub 上开源发布，开发者可以查看源码、自行部署，或在其基础上进行二次开发和功能扩展。

官方资源

• 项目 README
• GitHub 仓库

本文信息整理于 2026 年 9 月，价格、功能和可用地区以官方最新公布为准。