Google Gemini CLI

Gemini CLI 是 Google 推出的开源终端 AI 编程代理，使用 Gemini 2.5 Pro 模型，最大亮点是免费额度极其慷慨和 100 万 token 超长上下文。

GitHub: github.com/google-gemini/gemini-cli

核心特点

• 完全免费的每日额度 — 每天 60 次请求，不花钱
• 100 万 token 上下文 — 一次性理解整个大型代码库
• 开源 — Apache 2.0 许可证
• Google 生态 — 原生集成 Google Search
• MCP 支持 — 兼容 Claude Code 的 MCP 生态

安装

npm install -g @google/gemini-cli

需要 Node.js 18+。

登录

首次运行会引导你通过 Google 账号 OAuth 登录：

gemini
# 弹出浏览器，授权 Google 账号

也支持 API Key 方式：

export GEMINI_API_KEY="AIzaSy..."

免费额度

这是 Gemini CLI 最吸引人的特性：

对比： Claude Code 需要 $20/月起订阅，Codex CLI 需要 API 额度。Gemini CLI 是唯一有大量免费额度的。

基本使用

交互模式

gemini

带指令启动

gemini "解释这个项目的架构"

管道输入

cat error.log | gemini "分析这个错误日志"

在项目中使用

cd your-project
gemini
# Gemini 会自动识别项目上下文

内置工具

Google Search 优势

这是 Gemini CLI 独有的能力——可以在编码过程中实时搜索 Google：

搜索一下 Next.js 16 的 Server Actions 最新用法

Claude Code 和 Codex CLI 没有内置搜索引擎集成。

GEMINI.md

类似 CLAUDE.md 和 AGENTS.md：

# 项目说明
- 这是一个 Vue 3 + Vite 项目
- 使用 Pinia 做状态管理
- 测试用 Vitest

# 编码规范
- 组件用 Composition API
- 样式用 UnoCSS

MCP 支持

Gemini CLI 兼容 MCP 协议，可以复用 Claude Code 的 MCP 生态：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-github"]
    }
  }
}

已有的 MCP 服务器（GitHub、数据库、文件系统等）可以直接迁移到 Gemini CLI 使用。

上下文窗口优势

100 万 token 意味着什么？

Gemini 2.5 Pro 可以一次性加载大部分中型项目的全部源码，无需像 Claude Code 那样频繁 /compact。

Google 生态集成

• Google Cloud — 通过 Vertex AI 接入企业级环境
• Firebase — 未来可期待与 Firebase 的深度整合
• Google Workspace — 可能与 Docs、Sheets 等工具联动

适合谁？

• 预算有限 — 免费额度足够日常轻度使用
• 大型代码库 — 100 万上下文一次性吃下
• Google 生态用户 — 已在用 GCP / Firebase 的团队
• 需要实时搜索 — 编码时经常需要查文档