<!-- title: 谷歌免费终端没人用：Gemini CLI八道暗门 -->
<!-- domain: tips-tricks -->

中国开发者聊 AI 终端，开口闭口 Claude Code、Aider、Cursor，几乎没人提 **Gemini CLI**。这恰恰是当下最大的信息差：它不要订阅、不要海外信用卡、不靠你的 API Key，**一个 Google 账号登录就能白嫖谷歌当时最强的模型**，还自带后悔药、沙箱、分层记忆和 MCP 扩展。海外把它当"穷人版 Claude Code + 免费额度"在疯狂薅，国内却几乎零声量。这篇挖出八道 90% 用户碰都没碰过的暗门，看完你会想把 AI 编码的主战场挪一截过去。

## 先把账算明白：为什么说它"白嫖"

国内 AI 编码工具的真实成本经常被低估：Claude Code 要 Claude Pro/Max 订阅（约 20 美元/月起）或按量付 API 费，Cursor Pro 是 20 美元/月，Aider 你得自备各家 API Key 照单全收。而 Gemini CLI 的 **`/auth`** 提供三条路：

- **Login with Google（OAuth）**——用你的 Google 账号登录，直接走谷歌给的免费层，**这是绝大多数人不知道的开关**。模型和当时 Gemini API 上的顶配一致，起步就给到每分钟几十、每天上千次量级的 Pro 额度，个人开发强度基本用不完。
- **Gemini API Key**——想超额或企业记账，换成自己的 Key 按量付费。
- **Vertex AI**——走 GCP 计费，企业级。

一句话信息差：**别人月付 20 美元跑的活，你登录个账号就在跑同样的前沿模型。**（需要可访问 Google 服务的网络环境，这点自行解决。）
## 暗门一：`/checkpoint` + `/restore`，自带后悔药

让 AI 大刀阔斧改代码，最怕改崩。Gemini CLI 默认就开着 `--checkpointing`：**每次会动到文件系统的工具调用之前，它会自动打一个快照**，不需要你手动 git stash。

- 想回滚？输入 `/restore`，列出最近一批 checkpoint，挑一个秒级恢复。
- 改崩了不慌，AI 没改好你拉回上一个点重来，比手忙脚乱 git reset 干净。

适用场景：放手让 agent 做大规模重构、批量重命名、跨文件迁移时，这套机制就是你的安全网。

## 暗门二：沙箱先跑一遍，再决定要不要它落地

很多人在"逐条确认好烦"和"yolo 好爽但好慌"之间反复横跳。Gemini CLI 的 `default` 模式里藏着一个中间态：**工具调用先在沙箱里执行一次**（macOS 走 seatbelt、Linux 走等价的隔离机制），把"如果真跑会发生什么"先演给你看。

- 你看到沙箱预演结果，再决定 accept / edit / reject。
- 既不是闭眼放行，也不是每条命令都打断节奏。

适用场景：AI 要执行某个你不完全信任的 shell 命令时，让沙箱替你先踩雷。

## 暗门三：三档审批模式 `--approval-mode`

把上面两道暗门拧成一套可调的旋钮，就是审批模式：

```bash
gemini                    # default：文件改动+命令都问你（带沙箱预演）
gemini --auto-edit        # 自动改文件，但命令仍需确认
gemini -y                 # yolo：全自动，配合沙箱兜底
```

进阶玩法是 **yolo + checkpoint**：放手让它全自动跑，但每一步都有快照兜底，出问题 `/restore` 回滚。这才是"既快又稳"的真实姿势，而不是赌运气。配置也能写进 `settings.json`，按项目固定。

适用场景：跑测试、改文档、写脚本用 yolo；碰生产代码、动数据库用 default。

下面这张图把"一条指令怎么穿过这几层安全网"画清楚了：

```text
flowchart TD
    A[你输入指令] --> B[模型决定调用工具]
    B --> C{会修改文件吗?}
    C -->|是| D[自动 /checkpoint 打快照]
    C -->|否| E[跳过快照]
    D --> E
    E --> F[沙箱内先跑一遍预演]
    F --> G{审批模式}
    G -->|default| H[弹确认: accept/edit/reject]
    G -->|auto_edit| I[自动改文件, 命令仍问]
    G -->|yolo| J[全自动放手跑]
    H --> K[真正执行]
    I --> K
    J --> K
    K --> L{结果不对?}
    L -->|是| M[/restore 选快照回滚]
    M --> A
    L -->|否| N[✅ 继续]
```

## 暗门四：`@` 万物皆可点名，省 token 的关键

新手最烧钱的行为是把整个仓库无脑塞进上下文。Gemini CLI 的 **`@` 语法**让你精确点名：

- `@src/api.ts 帮我看下这个模块的鉴权逻辑`
- `@docs/ 按这份文档生成接口`
- `@https://某篇博客 把这篇的方案落到我的代码里`——直接抓网页内容入上下文
- 在交互界面里敲一个 `@`，会弹出**文件选择器**，不用手敲路径

效果：只把真正相关的片段喂进去，上下文窗口不爆、token 不浪费、回答更聚焦。这是"用免费额度"和"用爆免费额度"的分水岭。

适用场景：大仓库里精确定位、把外部资料（文档/网页）就地变成上下文。

## 暗门五：分层 GEMINI.md + `/memory`，记忆不用每次重说

每次对话都重申"我喜欢简洁代码、注释用英文"，蠢且费 token。Gemini CLI 的记忆是**分层**的，启动时自动**向上回溯拼接**：

```mermaid
graph TD
    H["~/.gemini/GEMINI.md<br/>全局人设: 个人偏好"]
    R["项目根 GEMINI.md<br/>架构/约定/常用命令"]
    S["子目录 GEMINI.md<br/>模块级提示"]
    H --> R --> S
    S -. 自动向上回溯拼接 .-> T["最终注入上下文"]
```

- 全局那份放"我习惯 TypeScript、测试用 vitest"——所有项目共用。
- 项目根放架构约定、目录说明、构建命令。
- 子目录还能放更细的模块提示。

会话内还能用 **`/memory show`** 看当前记忆、**`/memory add`** 追加一条、**`/memory refresh`** 重新加载——不用退出 CLI 改文件。

适用场景：跨项目统一风格、把团队约定固化成 AI 默认行为。

## 暗门六：自定义 slash 命令，把高频提示词固化进 git

天天复制的提示词，值得固化成命令。在项目里建 `.gemini/commands/lint-fix.toml`（名字即命令），就能用 `/lint-fix` 一键触发：

- 支持参数替换（如 `$ARGUMENTS`），命令可带参。
- 团队把 `.gemini/commands/` 提交进 git，**新人 clone 下来就有统一工作流**。

适用场景：固定的"修 lint→跑测试→提 PR 描述"流水线、团队复用代码审查提示词。

## 暗门七：MCP 接万物，`/mcp` `/tools` 看清家底

Gemini CLI 原生支持 **MCP（Model Context Protocol）**，这是它从"会写代码"升级成"长手长眼"的钥匙：

- 配置：项目根 `.mcp.json` 或 `~/.gemini/settings.json` 的 `mcpServers`。
- 接上数据库、浏览器自动化、Notion、本地文件系统、Sentry……CLI 就能查数、翻页、读工单。
- **`/mcp`** 看各服务器连接状态，**`/tools`** 列出当前所有可用工具——很多机器装了 MCP 却不知道有哪些能力，先 `/tools` 看一眼。

适用场景：让 agent 直接读你的真实数据来决策，而不是你手工复制粘贴。

## 暗门八：`/stats` 看账、`/chat` 续命、长上下文压缩

省钱的第一步是**看见账**。最后三件套收尾：

- **`/stats`**——看本次会话烧了多少 token，培养成本直觉。
- **`/chat save <tag>`** 存档、**`/chat resume <tag>`** 续命——长任务断点续跑，不用从头喂上下文。
- 长会话上下文撑满时，用压缩（`--compress` 等机制）自动瘦身，避免越聊越贵越蠢。

适用场景：长周期的重构、跨天推进的大任务。
## 信息差总结

| 维度 | 大多数人以为 | Gemini CLI 实际暗门 |
|---|---|---|
| 价格 | AI 终端要订阅/海外卡 | Google 账号 OAuth 免费用顶配模型 |
| 安全 | yolo 太危险 / 逐条确认太烦 | 沙箱预演 + checkpoint 自动兜底 |
| 上下文 | 整个仓库塞进去 | `@` 精确点名，省 token |
| 记忆 | 每次重说偏好 | 分层 GEMINI.md + `/memory` 会话内改 |
| 复用 | 天天复制提示词 | `.toml` 自定义命令，团队提交 git |
| 扩展 | 只能写代码 | MCP 接数据库/浏览器/办公套件 |
| 续命 | 长任务断了重来 | `/chat save/resume` 断点续传 |

**一句话**：Claude Code 的体验，零订阅的价格，外加谷歌的免费额度——这道信息差，谁先用上谁先省。

## 行动指南（照做即可）

1. `npm install -g @google/gemini-cli` 安装，命令行敲 `gemini` 启动。
2. `/auth` → 选 **Login with Google**，登录即开通免费层。
3. 项目根放一份 `GEMINI.md`（架构 + 约定 + 常用命令），全局 `~/.gemini/GEMINI.md` 放个人偏好。
4. 默认就是 `default + checkpoint + 沙箱`，先在安全模式下跑通；信任度高后切 `yolo` 提速。
5. 建一个 `.gemini/commands/` 目录，把最高频的提示词固化成 slash 命令，提交进 git。
6. 配一个 `.mcp.json`，接上你最常用的服务（数据库/浏览器/工单），然后 `/tools` 看清家底。
7. 习惯性 `/stats` 看消耗，长任务记得 `/chat save`。

## 参考来源

- [Gemini CLI 官方仓库（含完整文档）](https://github.com/google-gemini/gemini-cli)
- [Gemini CLI 文档站](https://google-gemini.github.io/gemini-cli/)
- [Google AI for Developers — Gemini API 文档](https://ai.google.dev/gemini-api/docs)
- [Model Context Protocol 官网](https://modelcontextprotocol.io/)
- [Google Developers Blog](https://developers.googleblog.com/)
> 本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵**爱卫生**（微信ID: gprshome201101）维护。
> 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。
**完成摘要（给用户）**

**下一步建议**

> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)