它是什么

Gemini CLI 是 Google 开源的终端 AI Agent。你可以在终端中启动它，用自然语言描述任务，把 AI 协作放进日常项目工作中。

与单纯询问一个知识点相比，使用这类工具更需要交代任务背景、处理范围和完成标准。例如，“解释这个项目”比较宽泛，“说明项目的主要目录、入口位置和运行流程，先不要修改文件”就更容易得到可检查的结果。

项目仓库是 https://github.com/google-gemini/gemini-cli ，官方文档是 https://www.geminicli.com/docs/ 。本文只使用已核实的安装和启动方式，其他操作细节以官方文档为准。

适合谁

Gemini CLI 适合愿意使用终端，并希望通过自然语言辅助理解项目、整理文档或分析代码的人。

如果你已经经常在终端里处理项目，可以先把它用于边界明确的小任务。如果你刚接触命令行，建议从解释文件、总结内容等任务开始，熟悉交互过程后再尝试修改工作。

它更适合作为协作工具。涉及业务规则、代码正确性和重要文件的结果，仍需要你检查，不能只看回答是否流畅。

安装：按系统选择方式

Gemini CLI 的 npm 包名是 @google/gemini-cli，需要 Node.js。开始前先确认本机具备相应环境；Node.js 的安装与环境检查细节，以官方文档为准。

Windows

可以先用以下方式运行，不必先执行全局安装：

npx @google/gemini-cli

如果准备经常使用，也可以全局安装：

npm install -g @google/gemini-cli

完成后启动：

gemini

如果遇到权限、环境或命令无法识别的问题，不要随意套用不明来源的修复命令，具体处理以官方文档为准。

macOS

可以使用前面的 npm 安装方式。如果已经使用 Homebrew，也可以选择：

brew install gemini-cli

安装完成后运行：

gemini

初次使用时，选择一种安装方式即可，便于后续确认自己使用的是哪套安装环境。

Linux

可以通过以下方式直接运行：

npx @google/gemini-cli

也可以全局安装后启动：

npm install -g @google/gemini-cli

gemini

不同系统环境下的安装问题可能不同，发行版相关细节以官方文档为准。

首次登录与配置

启动 Gemini CLI 后，可以选择使用 Google 账号登录。首次体验时，按照实际界面提示完成流程即可；具体选项与操作细节以官方文档为准。

另一种方式是使用 API Key。在支持以下环境变量写法的终端中，先设置：

export GEMINI_API_KEY="YOUR_API_KEY"

再运行：

gemini

其中 YOUR_API_KEY 需要替换成你自己的密钥。这段写法不能直接视为所有终端通用，Windows 等环境中的具体配置方式以官方文档为准。密钥获取、使用条件与费用信息也应查阅官方文档。

项目上下文文件是 GEMINI.md。可以把它理解为项目说明的集中位置，用来记录协作时需要了解的背景，例如项目目标、目录用途、写作规范和需要谨慎处理的内容。具体放置位置、加载规则与格式细节，以官方文档为准。

编写上下文时，应优先保留稳定、准确的信息，避免把临时猜测写成项目规则。

上手示例：用自然语言描述任务

第一次使用，建议选择一个熟悉的小项目，从理解内容开始。下面的任务描述可以作为参考，实际处理范围以工具提示和官方文档为准。

理解项目：

请说明这个项目的主要用途，梳理核心目录之间的关系。先不要修改文件；无法从现有内容确认的地方，请明确标注。

检查文档：

请检查项目说明中是否存在术语不一致、步骤缺失或表达含糊的问题。先列出问题和修改建议，等待我确认后再处理。

分析代码：

请分析这段代码的输入、输出和异常情况，指出需要进一步验证的地方。不要把推测当作已经确认的缺陷。

提出局部修改：

请围绕这个问题提出最小修改方案，说明可能影响的内容和验证方法，暂时不要扩大处理范围。

这些示例都明确了目标、边界和输出要求。比起一次提出多个模糊目标，先完成一个小任务，更方便判断工具是否理解了你的意图。

实用技巧与安全注意

把大任务拆成几个阶段：先理解，再提出方案，最后处理和检查。每一步都保留可核对的结果，发现方向不对时及时纠正。

任务描述中尽量说明完成标准。例如，要求整理文档时，可以明确“保留原有事实、统一术语、列出无法确认的信息”。这样更容易检查结果，也能减少无关改动。

不要把 API Key、密码或其他敏感信息写进 GEMINI.md、公开文档或准备分享的对话记录。演示和截图前，也应检查是否暴露密钥。

处理重要项目之前，保留可恢复的副本。涉及文件修改、依赖调整或其他可能影响环境的操作，应先理解其作用，再决定是否继续。权限机制和确认流程以官方文档为准。

最后，主动核对 AI 给出的判断。解释看起来合理，并不等于符合项目实际情况；需要验证的结论，应通过项目自身的检查过程确认。

小结

上手 Gemini CLI，可以从选择安装方式、完成登录、提出一个小任务开始。熟悉之后，再通过 GEMINI.md 整理项目背景，逐步形成自己的协作习惯。

使用时，把目标说清楚、控制任务范围、检查实际结果，比追求一次完成所有工作更可靠。遇到本文没有覆盖的配置或操作细节，以官方文档为准。

官方链接

命令与版本核对于 2026-11-03，产品迭代较快，请以官方文档为准。