Gemini CLI 入门指南：安装与你的第一条 AI 命令

Google 的 Gemini CLI 把大语言模型直接搬进了终端。你不需要付费订阅、不需要信用卡、也不需要申请 API Key，只要一个 Google 账号，就能让 AI 读懂整个代码库、自动生成单元测试，并执行各种文件操作任务。本文基于 YouTube 的「Gemini CLI Masterclass」第一集，梳理从零到跑通第一条命令的完整流程。

安装前提与一行命令完成部署

Gemini CLI 的安装门槛极低。唯一的硬性要求是 Node.js 20 或更高版本，建议在动手前先用 node -v 确认环境。

满足前提后，只需一条 npm 命令即可将 Gemini CLI 全局安装。安装完成后，它在任意终端、任意目录下都可直接调用，不受项目位置限制。这种「一次安装，处处可用」的设计，让它更像一个系统级工具，而非绑定在某个项目里的依赖。

整个过程没有复杂的配置文件，也不涉及环境变量的繁琐设置——这是它相比许多需要手动管理 API Key 的 AI 工具的明显优势。

Node.js 20 于 2023 年 4 月发布，是当前的 LTS（长期支持）版本，其内置的 npm（Node Package Manager）是安装 Gemini CLI 的基础工具。全局安装（npm install -g）会将可执行文件写入系统路径，这与局部安装（仅限某个项目的 node_modules 目录）不同——前者让命令在任何工作目录下都可直接调用，后者则需要通过 npx 或项目脚本触发。如果本机同时管理多个 Node.js 版本，推荐使用 nvm（Node Version Manager）或 fnm 等版本管理工具，可以在不同项目间灵活切换，同时确保 Gemini CLI 运行在满足要求的环境中。

零成本认证：一个 Google 账号搞定

安装后运行 gemini 命令，选择第一个选项，浏览器会自动打开一个授权页面。点击你的 Google 账号，认证就完成了。

这里值得强调的是整个认证流程的「无摩擦」特性：没有信用卡，没有 API Key，没有付费墙。认证成功后即可享受每天 1000 次免费请求的额度。对大多数个人开发者和日常工作流而言，这个额度相当充裕。额度每 24 小时自动重置。

这种定价策略明显是 Google 为了快速扩大开发者使用基数——用免费额度降低尝鲜成本，让更多人把 AI 工具纳入日常终端习惯。

理解代码库：几分钟而非几小时

Gemini CLI 最直接的价值体现在代码理解上。进入任意项目目录，启动 Gemini，然后用自然语言描述你想了解的内容即可。

在获得许可后，它会读取项目文件，并解释它所发现的结构与逻辑。对于接手一个陌生代码库的场景，这意味着从过去需要数小时的人工梳理，压缩到几分钟就能建立起整体认知。

这一能力对新加入团队的工程师、或是维护老旧项目的开发者尤其实用。它不是替你写代码，而是先帮你「看懂」代码——这往往是最耗时的前置工作。

斜杠命令：你的操作驾驶舱

Gemini CLI 用斜杠命令（slash commands）作为核心交互入口。两个最基础也最实用的命令是：

• /stats model：查看今天的 1000 次请求还剩多少，帮助你掌握用量、避免突然触顶。
• /help：随时调出所有可用命令的列表，适合在摸索阶段快速查阅。

/stats model 的存在让免费额度的使用变得透明——你始终清楚自己处在什么位置，而不是在不知不觉中被限流。这种对用量的可视化，是一个负责任的工具设计细节。

自动生成单元测试

让 Gemini 为任意文件编写测试，是本集展示的核心能力之一。你只需指明目标文件，它会读取源码、理解业务逻辑，然后生成一整套测试套件。

开发者唯一要做的，是审核并批准生成的文件。不需要再手动复制样板代码（boilerplate），也不用逐个填充测试桩（test stubs）。这把编写测试中最机械、最枯燥的部分自动化了，让人专注在测试逻辑的正确性审查上。

单元测试（Unit Test）是软件工程中验证最小功能单元（通常是单个函数或类方法）行为正确性的测试类型，与集成测试、端到端测试共同构成测试金字塔。传统编写单元测试的流程需要开发者逐一理解函数的输入输出边界、边缘情况和异常路径，再据此手动构造断言（assertion）。其中「样板代码」（boilerplate）指每个测试文件都必须重复编写的固定结构，如测试框架的 import、describe/it 块的嵌套；「测试桩」（test stub）则是用来替代真实依赖的占位实现，用于隔离被测单元。这两部分工作重复性高、创造价值低，正是 AI 辅助自动化收益最大的场景。Gemini CLI 通过先读取源码理解业务逻辑，再映射到对应的测试结构，将这一机械过程压缩到秒级。

用自然语言替代一次性脚本

除了代码任务，Gemini CLI 还能承担各类文件操作，直接替代那些临时编写的 bash 脚本。无论是「批量重命名这些图片」还是「合并这几个 CSV 文件」，你都可以用纯英文描述需求。

关键的安全机制在于：Gemini 在真正改动任何文件之前都会先请求许可。这保证了自动化操作的可控性——你不会因为一句含糊的指令而丢失数据。相比每次都要从头写一遍脚本，用自然语言下达指令显然更快捷。

「一次性脚本」（one-off script）是指开发者为临时任务单独编写、用完即弃的 Shell 脚本，通常以 Bash 或 Python 实现。这类脚本的问题在于：编写需要记忆特定命令语法（如 find、xargs、awk），调试耗时，且写完后往往不会复用，积累形成「脚本债务」。Gemini CLI 将自然语言作为这一层的抽象接口，用户无需关心底层实现细节，工具会将意图翻译成具体的文件操作序列。其「先请求许可再执行」的机制在技术上属于「人在回路」（Human-in-the-Loop）设计模式——AI 规划操作步骤，人类保留最终确认权，在自动化效率与操作安全之间取得平衡，避免批量操作中因歧义指令导致不可逆的数据损失。

小结与后续

到这一步，Gemini CLI 已经完成安装、认证，并在终端里开始真正干活：读懂代码库、生成测试、执行文件任务。整个过程零成本、低门槛。

系列的第二集将深入文件工作流、多文件编辑，以及那些过去需要耗费数小时的编码任务。如果你正在寻找一个免费且能力扎实的终端 AI 助手，Gemini CLI 值得一试。