🔥 Gemini CLI：Google 官方 104k Stars 的开源 AI Agent，npx 一行命令跑起来
项目地址：google-gemini/gemini-cli | ⭐ 104k Stars | 🛠 TypeScript | 作者 Google
老实说，当 Google 把 Gemini CLI 开源的时候我以为是又一个 Claude Code 套壳。结果试了一下午发现——这玩意儿是 Google 官方出的、直接面向终端开发者的 AI Agent，完全开源（Apache 2.0），而且免费额度够你每天 1000 次请求。
最骚的操作是：不用装任何东西，一行命令就能跑。
一、为什么你需要 Gemini CLI
市面上的 AI 编码 Agent 越来越多——Claude Code、Codex、OpenCode……每个都要 API Key，每个都有自己的收费模式。Gemini CLI 的路子不一样：
- 免费层给得够大方：个人 Google 账号 60 次/分钟、1000 次/天
- Gemini 3 模型：1M Token 上下文窗口，推理能力跟得上
- 内置 Google Search 联网：不需要额外配插件
- MCP 协议支持：想拓展能力自己写 Server
别整那些花里胡哨的，直接上手看代码。
二、安装：一行命令搞定
# 最快的方式，不用装任何东西
npx @google/gemini-cli
想装到系统里：
# npm 全局安装
npm install -g @google/gemini-cli
# macOS/Linux 用 Homebrew
brew install gemini-cli
装完第一次运行会跳浏览器让你 Google 登录认证，完事了直接用。
三、实战用法
交互模式
进到项目目录直接跑：
cd your-project/
gemini
然后就进入聊天界面，你可以问代码架构、让它改 bug、生成新功能。
指定模型
gemini -m gemini-2.5-flash
非交互模式（适合脚本）
# 简单咨询
gemini -p "解释一下这个项目的架构"
# 输出 JSON 格式，适合 CI 集成
gemini -p "检查代码里的安全问题" --output-format json
多目录分析
gemini --include-directories ../lib,../docs
四、配置 GEMINI.md
跟 Claude Code 的 CLAUDE.md 一样，Gemini CLI 也支持项目级上下文配置。在项目根目录放一个 GEMINI.md，里面写项目的规则、风格偏好、技术栈说明，每次对话它都会自动加载。
五、MCP 扩展
支持的 MCP Server 配置在 ~/.gemini/settings.json 里配。装好后可以直接在对话里用 @ 符号调用：
> @github 列出我开的 PR
> @slack 给 #dev 频道发今日进度
六、踩坑记录
- 第一次运行要登录：不是静默认证，会弹浏览器，在 CI 环境里要用 API Key 模式
- API Key 模式更简单：
export GEMINI_API_KEY="你的Key"，然后gemini直接跑，适合不想 Google 账号绑定的场景 - 免费额度够个人用：1000 次/天的免费调用量，正常开发完全够用，重度用户考虑 Vertex AI 企业版
总结
- Google 官方出品，Apache 2.0 开源，104k Stars 证明社区认可度
- 免费层给得实在，1000 次/天不用心疼钱
- npx 一行命令就能体验，零门槛
- 支持 MCP 协议，可扩展性强
- GEMINI.md 上下文配置让项目级 AI 理解更精准
想找个不烧钱的 AI 编码 Agent 试试？Gemini CLI 是目前免费额度最大方的选择了。
标签：#AI #Agent #Google #Gemini #CLI #OpenSource