🛠️ **先说背景**
如果你平时只在浏览器里和 ChatGPT 摆龙门阵，突然有人跟你说“用 Gemini CLI 在终端直接对话”，你会不会脑袋一阵嗡嗡？其实这玩意儿跟在命令行里打开一个“智能小伙伴”没啥区别。我们把它想象成把 Google 的大模型装进了电脑的黑框框里，你写几个指令，它就能帮你写代码、查天气、甚至把本地文件给总结。下面，我把所有常见的装机、认证、基本用法、技巧和坑点全拆开来讲，保证你看完之后能直接在终端里玩得飞起。
---
## 1️⃣ 为什么要装 Gemini CLI？
- **随时随地**：不需要打开网页，打开终端敲个 `gemini`，马上进入对话。
- **本地文件穿透**：可以直接把本地代码或文档丢进去，让 AI 基于真实文件给出建议，远比复制粘贴到网页要靠谱。
- **自动化利器**：它自带的工具可以直接跑系统命令、搜索网络、写文件，配合脚本几行代码就能把日常琐事自动化。
- **免费配额**：个人账号每天 1000 次请求，足够日常学习、写代码、写报告等。
> 像我一样，平时写代码总是卡在找文档、写单元测试的环节，装了 CLI 后只要一句 “帮我把这段 Python 函数写成支持 async 的版本”，立马得到完整代码，省下的时间足够泡杯咖啡。
---
## 2️⃣ 环境准备（别慌，超简单）
| 步骤 | 操作 | 小贴士 |
|------|------|--------|
| 1 | **安装 Node.js 20+**（推荐使用官方 LTS） | 在终端输入 `node -v` 看有没有。如果没有，去 nodejs.org 下载并安装。 |
| 2 | **全局安装 Gemini CLI** | `npm install -g @google/gemini-cli`（mac/linux 需要 `sudo`，Windows 用管理员权限打开 PowerShell） |
| 3 | **检查安装成功** | `gemini --version`，看到版本号就 OK。 |
| 4 | **登录 Google 账号** | 第一次运行 `gemini`，会弹出浏览器页面让你授权。点几下确认，回到终端就完成。 |
| 5 | **（可选）配置 API Key** | 如果想要更高配额或在没有 Google 账号的机器上使用，去 makersuite.google.com 生成 API Key，设环境变量 `GEMINI_API_KEY` 即可。 |
> 小技巧：把环境变量写进 `~/.bashrc`、`~/.zshrc`（mac/linux）或者系统环境变量（Windows），这样每次打开终端都会自动生效。
---
## 3️⃣ 第一次和 AI 对话
打开终端，直接敲：
```
gemini
```
看到 `>` 提示符后，你就可以像在聊天软件里一样输入自然语言了。
**案例 1：查询天气**
```
> 今天东京天气怎么样？
```
AI 会直接返回天气信息，背后其实用了内置的 Google Search 工具。所以如果你想要实时信息，只要在提示里提出来就行。
**案例 2：本地文件摘要**
把项目根目录下的 `README.md` 丢进去：
```
> @README.md 帮我把这份文档浓缩成 3 行要点。
```
AI 会先读取文件内容，然后基于上下文给出精简版。用 `@` 开头的方式是 Gemini CLI 的“文件读取”快捷键，省去手动 copy‑paste 的麻烦。
---
## 4️⃣ 常用斜杠命令（/ 开头）
| 命令 | 用途 | 示例 |
|------|------|------|
| `/help` | 查看帮助列表 | `/help` |
| `/quit` / `/exit` | 退出会话 | `/quit` |
| `/tools` | 查看已经加载的工具 | `/tools` |
| `/chat save <标签>` | 保存当前对话，后续可以恢复 | `/chat save my‑project` |
| `/chat resume <标签>` | 恢复已保存的对话 | `/chat resume my‑project` |
| `/memory add <文字>` | 临时添加记忆，让后面的对话能引用 | `/memory add 项目用到的数据库是 PostgreSQL` |
| `/theme` | 更换终端配色主题 | `/theme` |
| `/auth` | 更改认证方式（Google 登录、API Key） | `/auth` |
> 记住：斜杠命令是 “内部指令”，不需要加句号或其它标点，直接敲进去就好。
---
## 5️⃣ 进阶玩法：工具链 + Shell 模式
### 5.1 调用系统命令（! 前缀）
在提示前面加 `!`，就可以让 Gemini 直接执行系统命令并把结果交给模型。
```
! ls -l
```
AI 会把 `ls -l` 的输出带回来，你可以继续让它基于文件列表做分析，比如 “帮我把 src 目录下的所有 .js 文件统计行数”。
### 5.2 多步任务（工具自动串联）
**例子：抓取新闻并生成摘要**
```
> 从 https://mainichi.jp/ 抓取今天的新闻，只要体育版块，帮我生成 5 条要点。
```
AI 会依次调用 `WebFetch` 把页面拉下来、用 `GoogleSearch` 找到体育新闻的链接、再调用 `ReadFile` 读取内容，最后用语言模型生成要点。整个过程全自动，唯一需要你确认的是写文件的权限。
### 5.3 开启 /yolo（不推荐）
默认情况下每次使用写文件、网络请求等敏感工具时都会弹出确认。若你已经熟悉并且不想每次点“允许”，可以在启动时加 `--yolo` 参数一次性全部授权。记得仅在可信的本地环境使用，否则可能会被恶意指令利用。
---
## 6️⃣ 常见坑 & 解决方案
1. **认证失败**：多数是因为浏览器弹窗被拦住或者使用了企业账号。解决办法是先在浏览器手动登录 Google，确认 cookie 正常，然后在 Cloud Shell 或本地重新运行 `gemini` 并选择 `/auth` → “使用 Google 登录”。
2. **找不到 Node**：Windows 用户常见 PATH 没配置。重新打开终端或在系统环境变量里手动把 `C:\Program Files\nodejs` 加进去。
3. **网络代理**：在公司内网时会出现连不上的情况，需要在终端里设置 `HTTP_PROXY`、`HTTPS_PROXY` 环境变量，或使用 VPN。示例（mac/linux）：
```
export HTTP_PROXY="http://user:[email protected]:8080"
export HTTPS_PROXY=$HTTP_PROXY
```
4. **配额用完**：免费额度每天 1000 次，偶尔会被 IDE 插件刷太多。可以通过在 `.env` 或 `~/.gemini/settings.json` 中配置 `GEMINI_API_KEY`，用自己的 API Key 把配额提升到更高（付费版每分钟 200 次、每日 10k 次）。
---
## 7️⃣ 小案例：让 AI 写井字棋网页小游戏
下面演示一下，我只用了三行提示，就让 Gemini 生成了完整的 HTML、CSS、JS 三文件。
```
> Please develop a Tic‑Tac‑Toe game with separate HTML, CSS and JavaScript files. The JavaScript should contain most of the game logic.
```
AI 返回了 `index.html`、`style.css`、`script.js` 的代码。我们把它们分别保存到项目文件夹，用 `python -m http.server 8080` 启动本地服务器，打开浏览器就能玩。
> 这类“代码生成+文件写入”是 Gemini CLI 的强项：只要记得在提示里加上 “保存为 index.html” 之类的指示，CLI 会自动调用 `WriteFile` 完成保存。
---
## 8️⃣ 个人感悟：把 AI 当成“会写代码的同事”而不是“万能的搜索引擎”
最开始我把 Gemini CLI 当成“终端版 ChatGPT”，只问它一些随意的问题。后来我发现，它的真正价值在于 **能够直接操作本地环境**。例如在项目里想快速生成单元测试，只要输入 `帮我为 src/utils.js 写 5 条 Jest 测试`，它会把测试文件写好、跑一次 `npm test`，甚至把报错信息给你解释。于是我把它当成了每日的代码助手，很多本来要翻文档、打开 IDE、手动敲代码的操作，都在几秒钟内完成。
**一句话总结**：装上 Gemini CLI，就像在电脑里装了一个随叫随到的智能助理，省时省力，还能让你更专注在创意本身，而不是机械的搬砖。
---
## 9️⃣ 结语
装、登录、跑、玩，这四步基本就能让任何人上手 Gemini CLI。再配合上斜杠命令、文件读取 (`@`)、系统命令 (`!`) 三大技巧，你可以把它当成终端版的 “AI 小秘书”。如果你在使用中碰到任何卡点，记得先检查认证和网络代理，绝大多数问题都能在这两块快速定位。
祝你玩得开心，代码写得更快，生活也更省心！ 🎉
评论 (0)