title: "Gemini CLI" seoTitle: "Gemini CLI 评测 2026：Google AI 终端编程工具，免费使用对比" slug: "coding/cli/gemini-cli" domestic: false free: true pillar: "coding" category: "cli" tagline: "Google 开源终端 AI Agent，2M 上下文 + 免费额度 + Google Search grounding" description: "Gemini CLI 真实评测：Google 官方开源（Apache-2.0）终端 AI Agent，2026 已接入 Gemini 3 Pro / 3.1 Pro / 3.5 Flash，最高 2M token 上下文、Google Search grounding、MCP、自定义 GEMINI.md、headless 脚本模式；个人 Google 账号可用 60 requests/min、1,000 requests/day 免费额度。" website: "https://google-gemini.github.io/gemini-cli/" github: "https://github.com/google-gemini/gemini-cli" pricing: "开源免费 / 个人 Google 账号免费额度 / Gemini API 或 Vertex AI 按量计费" platforms: windows, macos, linux languages: en chinese_friendly: 3 opensource: true self_host: false api_compatible: "gemini", "vertex-ai" models: "gemini-3-pro", "gemini-3.1-pro", "gemini-3.5-flash" score: power: 4 ux: 3 price: 5 cn_support: 3 stability: 4 tags: cli, agent, terminal, google, gemini, mcp, opensource, free-tier alternatives: "coding/cli/claude-code", "coding/cli/codex", "coding/cli/aider" verdict: "终端 Agent 里最适合『低成本试水』的一支：免费额度大、1M 上下文、内置 Google Search。短板是产品打磨和长任务稳定性还不如 Claude Code / Codex，生产级任务建议把它当第二意见或低成本探索工具。" priceTable:

{ plan: "个人 Google 账号", price: "$0", limit: "60 requests/min，1,000 requests/day", note: "官方文档标注的免费入口，适合个人探索" }
{ plan: "Gemini API Key", price: "按量计费", limit: "取决于 AI Studio / API tier", note: "适合自动化脚本和 CI" }
{ plan: "Vertex AI", price: "GCP 按量计费", limit: "企业配额与 IAM", note: "适合生产与合规场景" } suitable:
"想低成本体验终端 Coding Agent 的个人开发者"
"需要 1M token 长上下文做代码库理解 / 文档阅读"
"需要 Google Search grounding 辅助查新资料的任务"
"想在脚本里用 headless 模式批量分析 issue / PR" notSuitable:
"要求最稳长任务交付的生产重构"
"不能访问 Google 服务的纯内网环境"
"强依赖中文界面和本地化文档的用户" faq:
q: "Gemini CLI 和 Claude Code / Codex CLI 最大区别？" a: "它的核心差异是免费额度和 Google 生态：个人 Google 账号即可获得较高免费请求额度，并内置 Google Search grounding。Claude Code 更稳，Codex 与 ChatGPT 订阅绑定更深，Gemini CLI 更适合低成本探索和大上下文阅读。"
q: "Gemini CLI 支持 MCP 吗？" a: "支持。可以在 ~/.gemini/settings.json 里配置 MCP server，把 GitHub、数据库、Slack、内部 API 等工具接入 CLI。"
q: "能不能非交互使用？" a: "可以。gemini -p \"解释这个代码库\" 会以 headless 模式输出结果，也可以加 --output-format json 做脚本化处理。"
q: "国内开发者适合吗？" a: "如果能稳定访问 Google 服务，它的免费额度很有吸引力；如果网络不稳，建议优先 Aider + 国内模型或 Claude/Codex 的稳定代理方案。" relatedPlaybooks:
"onboarding/terminal-agent-stack-2026" cover: "/img/tools/gemini-cli.webp" sources:
{ title: "Gemini CLI 官方文档", url: "https://google-gemini.github.io/gemini-cli/" }
{ title: "Gemini CLI GitHub", url: "https://github.com/google-gemini/gemini-cli" } published: 2026-06-25 updated: 2026-06-25

lastVerified: 2026-08-02 relatedReviews: "claude-code-deep-review", "codex-deep-review", "aider-deep-review"

TL;DR

一句话： Gemini CLI 是 Google 官方开源的终端 AI Agent。它把 Gemini 模型、文件读写、shell、web fetch、Google Search grounding 和 MCP 接到一个命令行工具里，最大卖点是 1M token 上下文 + 个人账号免费额度。

如果你已经在用 Claude Code / Codex CLI，Gemini CLI 不一定替代它们，但很适合作为「第二意见」「低成本大仓库阅读」「联网查新资料」的工具。

它是什么

Gemini CLI 是一个 Apache-2.0 开源的终端 Agent。使用方式和 Claude Code / Codex CLI 类似：进入项目目录，运行 gemini，然后用自然语言让它读文件、解释架构、修改代码、跑命令、调试错误。

它的特点不是「最强代码生成」，而是三件事：

上下文大：官方文档强调可访问 Gemini 2.5 Pro 的 1M token context window。
免费额度大：个人 Google 账号入口标注 60 requests/min、1,000 requests/day。
搜索原生：Google Search grounding 是内置能力，查新资料、查报错、查 API 文档时很顺手。

安装与启动

# 免安装试用
npx https://github.com/google-gemini/gemini-cli

# 全局安装
npm install -g @google/gemini-cli

# 启动当前目录会话
gemini

要求 Node.js 20+，支持 Windows / macOS / Linux。

常用命令：

# 非交互问答
gemini -p "Explain the architecture of this codebase"

# 指定模型
gemini -m gemini-2.5-flash

# 额外包含目录
gemini --include-directories ../docs,../packages

# JSON 输出，方便脚本串联
gemini -p "Summarize open issues" --output-format json

三种认证路径

路径	适合谁	关键点
Google OAuth	个人开发者	免费额度最大，上手最简单
Gemini API Key	脚本 / CI	更适合自动化，额度跟 API tier 走
Vertex AI	企业 / GCP 团队	IAM、审计、合规、配额更可控

个人使用优先 OAuth；生产和团队内使用优先 Vertex AI。

MCP 与项目记忆

Gemini CLI 支持两类扩展：

MCP server：把 GitHub、数据库、内部 API 暴露给 Agent。
GEMINI.md：类似 Claude Code 的 CLAUDE.md / Copilot 的 AGENTS.md，用于写项目约定、测试命令、编码风格。

这让 Gemini CLI 可以进入 2026 年主流终端 Agent 的标准形态：项目记忆 + 工具协议 + headless 自动化。

真实适用场景

1. 大仓库先读懂

先读 package.json、README、src 入口文件，输出这个项目的架构图和关键风险点。

1M 上下文让它在「读文档 + 读代码」阶段很有优势，尤其适合 monorepo 的初始摸底。

2. 查新资料后改代码

查一下 Nuxt 4 最新 route rules 写法，然后检查本项目 nuxt.config.ts 是否需要调整。

Google Search grounding 的价值在这里体现：它不是只靠训练数据，而是能把搜索结果纳入推理。

3. 低成本 issue triage

gh issue list --json title,body \
  | gemini -p "按修复难度给这些 issue 排序，输出 JSON"

和 Jules Tools / GitHub CLI 组合时，可以把 Gemini CLI 当「任务分拣器」。

与同类怎么选

维度	Gemini CLI	Claude Code	Codex CLI	Aider
默认生态	Google / Gemini	Anthropic	OpenAI / ChatGPT	任意模型
免费入口	✅ 很强	❌	取决于 ChatGPT 订阅	本体免费，模型自费
上下文	1M	1M 级别模型可用	取决于模型	取决于模型
搜索	Google Search 内置	需工具 / MCP	内置 web 能力	取决于模型 / 工具
长任务稳定性	中上	强	强	中上
开源	✅	❌	✅	✅

AIHO 建议：

预算敏感 / 想免费试：Gemini CLI
最稳长任务：Claude Code
已有 ChatGPT Plus/Pro：Codex CLI
想接国内模型 / 自定义 base_url：Aider

避坑清单

不要把免费额度当生产 SLA：个人额度适合探索，生产任务走 API Key / Vertex AI。
长任务先拆小：即使上下文大，Agent 执行链路也可能漂移；30 分钟以上任务建议拆成 issue。
MCP server 要审计：给 Agent 接工具等于扩权，第三方 server 先看源码和权限。
GEMINI.md 别写太散：只放稳定约定、测试命令、目录说明，别塞临时需求。
国内网络先验证 OAuth：登录流程不稳定会影响体验，必要时用 API key 路径。

适合 / 不适合

✅ 适合：个人开发者、学生、开源项目维护者、大仓库阅读、联网查新、低成本脚本化分析。
❌ 不适合：强合规生产环境、纯内网开发、预算不敏感但追求最高长任务稳定性的团队。

来源

Gemini CLI 官方文档：https://google-gemini.github.io/gemini-cli/
Gemini CLI GitHub：https://github.com/google-gemini/gemini-cli

本卡片由 AIHO 编辑部根据公开资料整理，非厂商付费内容；功能和额度以官网为准。

Gemini Cli