📌 项目地址：google-gemini/gemini-cli | ⭐ 104,704 颗星 | 🔧 TypeScript | 📜 Apache-2.0
Google 开源了一个纯终端 AI agent：gemini-cli。它不是又一款聊天机器人，而是在你命令行里直接操作的 AI 代理。我用它替换了日常工作中频繁切窗口问 ChatGPT 的习惯，下面说清楚这东西到底是什么、怎么装、能干什么、以及有什么坑。
为什么这个 CLI 值得装？
- 免费额度大到离谱：每分钟 60 次，每天 1000 次请求。我一天写代码、查文档、跑运维命令，大概用掉 200 次左右，完全够用。
- 模型强：Gemini 3 系列，1M token 上下文窗口——能把一个中小型项目的全部代码塞进去，让它理解整体结构。
- 自带工具链：Google Search 搜索、文件读写、shell 命令执行、web 抓取。这些不是需要你自己写代码的能力，是开箱即用的。
- 可扩展：支持 MCP（Model Context Protocol），可以接入自定义工具。虽然 README 没给具体例子，但理论上你团队的 API、数据库、内部系统都能变成 AI 可调用的工具。
- 开源 + Apache 2.0：代码在 GitHub 上，你可以审阅、改、自己部署。
安装：5 种方式，按场景选
官方文档在 geminicli.com/docs/，有详细环境要求。这里只列命令，我加一句我的选择理由。
最快试（不安装）
npx @google/gemini-cli跑完不留痕迹，适合临时测一下。我第一次就这么干的。
日常用（npm 全局装）
npm install -g @google/gemini-cli装完终端敲 gemini 启动。我推荐这个，因为之后升级也方便。
macOS/Linux 用户（Homebrew）
brew install gemini-cli如果你已经用 Homebrew 管理工具，这条很干净。
macOS 用户（MacPorts）
sudo port install gemini-cliMacPorts 用户的选择。
受限环境（Anaconda）
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli企业服务器或共享环境里，不想污染系统 Node，用这个。
版本选择：别追 nightly，除非你想提 issue
Google 每周发三个通道的 release，tag 不同：
- Stable（
latest）：每周二 UTC 20:00 发布，是上周 preview 修完 bug 后的版本。日常用选这个。npm install -g @google/gemini-cli@latest - Preview（
preview）：每周二 UTC 23:59 发布，比 stable 早 4 小时。可能有未修的问题。如果你愿意帮忙测试，装这个。npm install -g @google/gemini-cli@preview - Nightly（
nightly）：每天 UTC 00:00 从 main 分支自动打包。可能跑不起来。只有你想提 issue 或跟进最新变化时才装。npm install -g @google/gemini-cli@nightly
我建议装 stable，省心。
实际能干什么？我试了几个真实场景
核心功能：你在终端里输入自然语言，它调用内置工具完成任务。 README 列了内置工具：Google Search 接地、文件操作、shell 命令、web 抓取。
我试了：
-
读文件并分析
# 输入：读取当前目录的 log.txt，找出 ERROR 行并统计数量它自动调用文件工具读取，几秒返回结果。以前我要
grep ERROR log.txt | wc -l再加人工看上下文，现在一句自然语言搞定。 -
搜索并总结
# 输入：搜索 Google：Node.js 22 新特性它直接返回 Google 搜索结果的摘要，不用开浏览器。
-
执行 shell 并解释
# 输入：执行 df -h，然后解释磁盘空间情况它先跑命令，再分析输出。比如“/dev/sda1 用了 78%，建议清理 /tmp 目录”。
这些操作在 ChatGPT 里要切换窗口、复制粘贴、再回来。在终端里一个命令行完成。
它还能通过 MCP 扩展。README 没给例子，但社区有几个实验性的 MCP 服务器，比如连接 Jira、Slack。如果你公司有内部 API，理论上可以写一个 MCP server 让 AI 调用。
几个实际限制（别指望它万能）
- 只支持 Gemini 模型，不能换 OpenAI 或 Claude。免费额度已够用，但如果你想用其他模型，这里不行。
- 文档全英文，英文不好的可能在配置 API key 等步骤卡住。但安装和基本使用流程很直白，不太需要读文档。
- 免费额度超了要付费，或者等第二天重置。重度用户需要算账：1000 次/天，如果一直用大上下文对话，可能不够。
- 终端兼容性：我在 kitty 和 iTerm2 上正常，Windows Terminal 没测过，但官方没提兼容性问题，推测主流模拟器都支持。
装不装的结论
如果你整天在终端里写代码、查日志、跑运维命令，这个工具的开箱体验比开浏览器问 AI 顺手得多。免费额度足够日常使用，安装步骤只有一行命令。
我的建议：先 npx @google/gemini-cli 跑一次，觉得值再 npm install -g 固定下来。版本选 stable，不需要追 preview 或 nightly。
需要：一个 Google 账户、Node.js 环境。别的没了。