Gemini CLI

它是什么

Gemini CLI 是 Google 官方的命令行 agent，配 Gemini 模型家族用。2025 年以 Apache-2.0 开源，给你一个常驻终端的 agent —— 能读文件、跑 shell、用 Google Search 上网，再叠上 Google 自家的一等扩展：Stitch、Google Workspace、Code Review、Postgres、Vertex AI 等。

什么时候应该用：

• 想要真免费额度 —— Gemini CLI 自带的 Gemini API 免费配额够日常 coding loop
• 本来就在 Google Cloud / Workspace 里，想要原生进 Vertex、BigQuery、Drive、Calendar
• 想要一个多模态强的终端 agent —— Gemini 2.5 / 3 原生看图看视频，CLI 把这个能力接出来

它为什么突出

怎么装

# macOS / Linux / WSL
npm install -g @google/gemini-cli

# 或者 Homebrew
brew install gemini-cli

装完在任意项目跑 gemini。首次会让你登 Google 账号或设 GEMINI_API_KEY。免费额度立刻起效；企业用 SSO / 审计就切 Vertex。

在 Gemini CLI 里装啥

Gemini CLI 有自己的扩展清单（~/.gemini/extensions.json）加通用 MCP。三个 TokRepo pack 起手：

• MCP 服务器全家桶 —— Postgres / GitHub / Filesystem，跨工具都能用
• Google Cloud MCP 套件 —— Vertex AI、BigQuery、Cloud Run 接进 Gemini CLI
• 多模态工作流 pack —— 图转 Stitch、视频转写流，Gemini 3 调优过

tokrepo install 装好就跟 Google 内部团队 demo 的配置对齐了。

常见坑

• 不锁模型版本 —— Gemini CLI 默认 "latest"，会无预警换。要复现就在 .env 里设 GEMINI_MODEL=gemini-2.5-pro
• 免费额度长 loop 撞限流 —— 突发限速大约 60 req/min，要么加退避，要么切付费 Vertex
• CI 里走 OAuth 登录 —— 交互登录在 headless 跑不通。用 service-account key + GEMINI_API_KEY
• 扩展权限范围 —— Workspace 和 Calendar 扩展会读你整个收件箱 / 日历。分享目录前审 ~/.gemini/extensions.json
• Search 接地气的成本 —— 每次接地气响应单独走 Search API 配额，跟 Gemini token 分开计费

与其他工具的关系

Gemini CLI 是 Google 对 Claude Code 和 Codex CLI 的回应。三家差异：Claude Code 赢在 agent 质量（Opus 4.7 + 最成熟的 subagent 生态）；Codex CLI 赢在 AGENTS.md 约定的采纳度；Gemini CLI 赢在免费额度、多模态、Google Cloud 集成。2026 年多数资深开发都同时装三个，按任务挑 —— Gemini 截图出规格，Claude 长重构，Codex 配 ChatGPT Pro 一起用。