Gemini CLI

Gemini CLI 快速入门

⚠️ 重要状态提示：2026-06-18 起，Gemini CLI 已停止向个人用户（免费层、Google AI Pro/Ultra）提供服务，官方继任者是闭源的 Antigravity CLI。通过 Gemini API key / Vertex AI 的按量付费路径仍然可用。本词条按当前实际状态撰写。

这是什么？适合谁？

Gemini CLI 是 Google 开源的终端 AI 编程助手（Apache 2.0，TypeScript，GitHub 88,759 stars），2025 年 6 月发布时以”每天 1,000 次免费请求”的个人免费额度迅速走红。它能读写代码库、执行 Shell 命令、联网搜索（内置 Google Search）、通过 MCP 扩展工具，支持 100 万 token 上下文。

现在还适合谁？两类用户：一是已有 Gemini API key 或 Google Cloud Vertex AI 账号的开发者/企业，按量付费路径不受影响，可以继续用；二是想研究一个高质量开源终端 Agent 实现的人——它的代码库仍是很好的参考。如果你是个人免费用户，它已经不是可选项了：官方引导迁移到 Antigravity CLI（闭源），或者你可以转投仍提供免费额度的替代品。

准备工作

• 运行环境：Node.js（npm 安装）或 Homebrew（macOS）
• 账号要求（关键）：二选一——
  • Gemini API key（AI Studio 申请，免费层 250 请求/天，仅 Flash 模型，以官方配额页为准）
  • Google Cloud Vertex AI 项目（企业级，按 token 计费）
• 不可用的路径：Google 账号直接登录的个人免费层、AI Pro/Ultra 订阅绑定，均已于 2026-06-18 停止服务
• 网络要求：需要能访问 Google 服务

3 步快速上手

第 1 步：安装

npm install -g @google/gemini-cli
# 或 macOS: brew install gemini-cli

第 2 步：配置 API key

export GEMINI_API_KEY="你的 API key"
gemini

预期输出：进入交互式终端界面。如果用 Google 账号 OAuth 登录，会收到服务停止的提示——这是 2026-06-18 后的预期行为，不是你配置错了。

第 3 步：跑第一个任务

在项目目录下输入：“解释这个仓库的构建流程”。预期输出：它会读取构建配置文件并给出说明。日常也可以用非交互模式嵌入脚本：gemini -p "总结 git log 最近 10 条提交"。

常见踩坑

踩坑 1：Google 账号登录后无法使用

• 症状：OAuth 登录成功但请求被拒绝
• 原因：个人免费层和 AI Pro/Ultra 路径已于 2026-06-18 停服（官方 GitHub Discussion #27274）
• 解决：改用 GEMINI_API_KEY 环境变量走 API 路径，或迁移到 Antigravity CLI

踩坑 2：API key 免费层很快触发限流

• 症状：大量请求后返回 429
• 原因：API key 免费层为 250 请求/天且仅 Flash 模型
• 解决：开启按量付费，或降低调用频率、合并请求

踩坑 3：找不到官方更新路线图

• 症状：仓库仍有代码但消费级功能不再演进
• 原因：Google 的消费级 CLI 重心已转向闭源 Antigravity CLI
• 解决：关注官方 Discussion 区；社区 fork（如 llxprt-code）延续了部分开发，但需自行评估维护风险

初级用法

1. GEMINI.md 项目记忆：在仓库根目录放 GEMINI.md 写明项目约定（技术栈、命令、代码风格），每次会话自动生效。

2. 会话 checkpoint：长任务中随时保存/恢复会话状态，试错成本低。

3. 非交互模式做自动化：-p 参数 + JSON 输出，可以直接接进 CI 脚本做提交摘要、变更审查。

高级玩法

1. MCP 扩展：配置 MCP server 接入内部工具（issue 系统、文档库），让它在终端里操作你的工作流。

2. GitHub Action：官方的 Gemini CLI Action 可做 PR 审查、Issue 分类，在评论里 @gemini-cli 召唤——注意这条路径同样依赖 API key 计费。

3. Vertex AI 企业接入：企业用户走 Vertex 认证，数据适用 Google Cloud 条款（不用于训练），合规性最好。

小技巧

• API key 免费层只给 Flash 模型，复杂推理任务请显式切换到付费模型
• 大仓库先用 /memory 确认 GEMINI.md 已加载再提问
• 批量脚本任务加 --yolo 前务必在干净分支上跑，它会直接改文件

常见问题 FAQ

Q: Gemini CLI 现在还能免费个人使用吗？ A: 不能。2026-06-18 起个人免费层和 AI Pro/Ultra 路径已停服，官方继任者是 Antigravity CLI（闭源）。API key 免费层（250 请求/天、仅 Flash）仍可用。

Q: 和 Claude Code、Codex CLI 比怎么选？ A: Claude Code 闭源订阅制、口碑领先；Codex CLI 开源、走 OpenAI 生态；Gemini CLI 开源且曾有最慷慨的免费额度，但该优势已随个人版停服消失。现在选它 mainly 是因为你已在 Google 生态内。

Q: 开源仓库还会继续维护吗？ A: 仓库仍开源（Apache 2.0），API/Vertex 路径仍受支持，但消费级功能演进已转向闭源继任者。长期维护节奏以官方仓库为准。

Q: 我的代码数据会被训练吗？ A: 取决于认证方式：Vertex AI 适用 Google Cloud 条款（不用于训练）；API key 适用 Gemini API 条款（免费/付费服务政策不同）；工具本身提供使用统计的 opt-out。企业用户建议走 Vertex。

Q: Antigravity CLI 是什么？ A: Google 官方的继任 CLI（命令 agy，Go 重写的单二进制），闭源、需订阅。是否迁移取决于你对闭源和订阅模式的接受度。

参考链接

• 官网：https://geminicli.com/
• GitHub 仓库：https://github.com/google-gemini/gemini-cli
• 个人版停服公告（Discussion #27274）：https://github.com/google-gemini/gemini-cli/discussions/27274
• 配额与定价说明：https://geminicli.com/docs/resources/quota-and-pricing/
• 隐私与条款说明：https://github.com/google-gemini/gemini-cli/blob/main/docs/tos-privacy.md

本文基于官方文档和公开资料整理，AI辅助生成。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。