Gemini CLI 是什么？为什么值得用
你可能听说过 Claude Code、Cursor 这类 AI 编程助手，但它们要么收费，要么有使用限制。2026 年初，谷歌悄悄开源了一个叫 Gemini CLI 的工具，直接在终端（命令行）里运行，用你的谷歌账号登录就能免费用。
它在 GitHub 上已经积累了 97,000+ 颗星，是目前最热门的开源 AI 工具之一。社区里很多人把它叫做"平替 Claude Code"——功能差不多，但完全免费。
| 对比项 | Gemini CLI（免费） | Claude Code（付费） |
|---|---|---|
| 每日请求次数 | 1,000 次 | 按 token 计费 |
| 上下文窗口 | 100 万 token | 20 万 token |
| 开源协议 | Apache 2.0（完全开源） | 闭源 |
| 谷歌搜索集成 | ✅ 内置 | ❌ 无 |
| MCP 支持 | ✅ 支持 | ✅ 支持 |
准备工作：你需要什么
- 一个谷歌账号（Gmail 就行，不需要特殊账号）
- 电脑上安装了 Node.js 18 或更高版本（下面会教你怎么装）
- 能打开终端（Mac 用 Terminal，Windows 用 PowerShell 或 Git Bash）
5 步安装并上手 Gemini CLI
安装 Node.js（已安装可跳过）
打开终端，输入以下命令检查是否已安装：
node --version如果显示 v18.x.x 或更高版本，直接跳到第 2 步。
如果提示"找不到命令"，前往 nodejs.org 下载 LTS 版本安装包，安装完成后重新打开终端。
安装 Gemini CLI
在终端输入以下命令（二选一）：
方式一：全局安装（推荐，以后随时可用）
npm install -g @google/gemini-cli方式二：临时运行（不安装，直接用）
npx @google/gemini-cliMac/Linux 用户如果遇到权限错误，在命令前加 sudo。
启动并登录谷歌账号
安装完成后，在终端输入：
gemini首次运行会弹出浏览器，要求你用谷歌账号授权。点击"允许"即可。
进入你的项目目录，开始对话
用 cd 命令切换到你的项目文件夹，然后运行 gemini。它会自动读取当前目录的所有文件。
cd /你的项目路径
gemini然后直接用中文提问，比如：
> 帮我解释一下这个项目的结构
> 找出 index.js 里所有的 bug
> 帮我写一个读取 CSV 文件的函数掌握几个最常用的斜杠命令
在对话框里输入 / 开头的命令可以控制 Gemini CLI 的行为：
/model— 切换模型（Gemini 3 Pro / Flash）/memory— 查看或添加持久记忆（跨会话保留）/chat— 开始新对话（清空上下文）/directory— 指定分析的目录范围
3 个最实用的使用场景
场景一：分析整个代码库
进入项目目录后直接问：
> 这个项目用了哪些技术栈？主要逻辑在哪几个文件里？Gemini CLI 会扫描所有文件，给你一份清晰的项目地图。接手别人的老项目时特别好用。
场景二：实时搜索 + 回答（不会给你过时信息）
Gemini CLI 内置了谷歌搜索，问它最新的技术问题时，它会先搜索再回答：
> React 19 有哪些新特性？给我一个迁移指南场景三：连接 MCP 服务器扩展能力
MCP（模型上下文协议）是 AI 工具的"万能插座"，可以让 Gemini CLI 连接数据库、API、文件系统等外部工具。在项目根目录创建 .gemini/settings.json 文件，按格式添加 MCP 服务器配置即可。
想了解 MCP 协议的原理，可以看这篇：AI 的"万能插座"——MCP 协议保姆级入门教程。
免费额度够用吗？
| 使用场景 | 每次大约消耗 | 每天 1000 次能用多久 |
|---|---|---|
| 简单问答 | 1 次 | 1000 次问答 |
| 分析一个文件 | 1-3 次 | 300-1000 次分析 |
| 分析整个项目 | 5-20 次 | 50-200 次项目分析 |
对于个人开发者日常使用，1000 次/天完全够用。如果你是重度用户，可以申请 API Key 切换到付费模式，价格也比 Claude Code 便宜很多。
✅ 验证你已经成功上手
- 终端里能运行
gemini命令并看到欢迎界面 - 用谷歌账号登录成功，显示剩余请求次数
- 能用中文提问并得到回答
- 在项目目录里运行时，它能正确识别你的文件