2. 安装 (Installation)

Gemini CLI 基于 Node.js 构建，因此需要先确环境中有 Node.js。

前置要求

• Node.js: 版本需 v18.0.0 或更高 (建议 v20+)。
• 操作系统: Windows, macOS, 或 Linux。

安装命令

打开终端（Terminal / PowerShell / CMD），运行以下命令进行全局安装：

如果你不想全局安装，也可以使用 npx 临时运行：

3. 初始化与认证 (Authentication)

安装完成后，第一次运行会引导你进行设置。

启动 CLI：
在终端输入：

1. 选择认证方式：
   CLI 会提示你选择认证方法，通常有以下几种：

   • Login with Google (推荐个人用户)：会自动打开浏览器弹窗，使用你的 Google 账号登录。

     • 优势：免费额度（通常每天 1000 次请求，每分钟 60 次）。

   • Gemini API Key：如果你有 Google AI Studio 的 API Key。

     • 设置方法：你也可以通过环境变量设置：export GEMINI_API_KEY="你的key"。

   • Vertex AI：企业级用户使用。

4. 基础使用 (Basic Usage)

认证成功后，你会进入一个交互式对话界面（REPL）。

交互模式

直接输入问题即可：

> 帮我写一个 Python 脚本来抓取网页标题

单次命令模式 (Non-interactive)

如果你不想进入对话模式，只想快速问一个问题，可以使用 -p 参数：

gemini -p "解释一下什么是 REST API"

管道操作 (Piping) ????(最强功能)

你可以将终端命令的输出直接“喂”给 Gemini。

场景 1：解释 Git 变更

场景 2：分析日志错误

5. 常用命令与技巧 (Commands & Tips)

在 Gemini CLI 的交互模式中（即输入 gemini 进入后），你可以使用以 / 开头的特殊命令：

上下文引用技巧 (@)

这是 Gemini CLI 最核心的技巧。你可以通过 @ 符号将文件内容直接作为 Context 发送给 AI。

分析代码文件：

Gemini 会自动读取 server.js 的内容并基于此回答。

多文件关联：

6. 高级配置：项目级上下文 (GEMINI.md)

如果你希望 Gemini 在进入某个项目文件夹时，自动知道这个项目的背景（比如“这是一个 React 项目，使用 TypeScript，风格要求严格”），你可以创建一个 GEMINI.md 文件。

在项目根目录新建文件 GEMINI.md。

在里面写下提示词（Prompt），例如：

当你在这个目录下运行 gemini 时，它会自动加载这个文件的内容作为系统提示词 (System Prompt)。

7. 常见问题排查

权限报错 (EACCES)：
如果在 Linux/macOS 上安装失败，可能需要 sudo：

Node 版本过低：
如果报错提示 SyntaxError 或版本不支持，请使用 nvm 升级 Node.js：

希望这篇教程能帮你快速上手！你可以现在就打开终端输入 gemini 试试看。

Gemini CLI 常用命令速查表

1. 终端命令行参数 (Shell Arguments)

这些命令直接在你的系统终端（Terminal/PowerShell）中执行。

2. 交互模式指令 (REPL Commands)

这些命令仅在进入 gemini 交互界面后使用（输入时通常有自动补全）。

3. 上下文与特殊语法 (Context Syntax)

在交互模式或 -p 参数中均可使用的特殊技巧。

???? 组合使用示例

场景：让 AI 帮你写 Git Commit 信息

场景：基于特定文件提问