# 白嫖千次却只会聊天：Gemini CLI 八暗门 > 一句话信息差：Gemini CLI 每天免费 1000 次、顶着 Gemini 3 的脑子、GitHub 上 **106k star**——但九成中国开发者只拿它当个"免费聊天框"。真正值钱的是 8 个几乎没人提的隐藏开关：能让 AI 改崩的代码一键回滚、能用 API Key 自动开 token 缓存省钱、能塞进 cron 当免费自动化脚本。今天一次性扒开。 ## 先认清这个工具的"身家" 如果你对 Gemini CLI 的印象还停留在"Google 出的免费命令行玩具"，那先刷新一下数据： - **免费额度**：个人 Google 账号登录，**每分钟 60 次、每天 1000 次**请求，跑的是 **Gemini 3**，**100 万 token 上下文**。相比之下 Claude Code 要订阅（\$20/月起）、Codex 要 ChatGPT Plus——Gemini CLI 这条线是真·零成本。 - **活跃度**：`google-gemini/gemini-cli` 仓库 106k star、14.2k fork，截至发稿最新版是 **0.51.0-nightly（2026-06-25）**，主分支几乎每天都有提交，迭代极快。 - **社区真相**：Hacker News 上有个 **304 分、365 评论**的热帖标题叫 *I watched Gemini CLI hallucinate and delete my files*（我眼睁睁看 Gemini CLI 产生幻觉、删了我的文件）。还有个 403 分的 *Gemini CLI tips and tricks for agentic coding*。 第一帖是事故，第二帖是补救。这两条加起来，恰好点出本文的核心信息差——**大多数翻车，不是因为工具不行，是因为没开那几个保命+省钱+自动化的暗开关**。下面 8 个，按"先保命、再省钱、最后开挂"的顺序拆。 --- ## 暗门一：AI 改崩了能回滚，但这功能默认是关的 这是最该第一个打开、却 90% 人不知道的开关。 Gemini CLI 有个 **Checkpointing（检查点）** 机制：每次 AI 要动你的文件前，它会在一个**影子 Git 仓库**里自动存一份快照（位于 `~/.gemini/history/<项目哈希>`），完整记录"文件状态 + 对话历史 + 即将执行的工具调用"，**完全不干扰你自己的 git 仓库**。出事了，一条 `/restore` 命令把文件和对话一起拉回改之前。 但关键坑来了：**这个功能默认关闭**（且 `--checkpointing` 这个命令行 flag 在 0.11.0 版本就被移除了，只能改配置）。想用必须手动开。 **操作步骤**：打开 `~/.gemini/settings.json`，写入： ```json { "general": { "checkpointing": { "enabled": true } } } ``` **预期效果**：之后 AI 每改一次文件就有快照，`/restore` 列出所有检查点（文件名形如 `2026-06-22T10-00-00_000Z-主文件.txt-write_file`），`/restore <检查点名>` 直接时光倒流。 **适用场景**：所有让 AI 大规模改代码的场景。HN 那个"AI 删我文件"的事主，要是早开这个，一条命令就救回来了。**这个暗门值整个订阅费。** ## 暗门二：Esc 按两下 = 时光机 `/rewind` 和 `/restore` 配套的还有个更快的手感——**双击 `Esc`**，唤出 `/rewind`。 区别在于：`/restore` 是"回到某次改文件之前"，而 `/rewind` 是在对话历史里逐步后退，并且让你**选择回退力度**： - 只回退对话历史（代码改动留着） - 只回退代码改动（对话留着） - 两者都回退 **适用场景**：AI 跑偏了一两步，你不想从头来，只想撤掉最近这一两次"自由发挥"。双击 Esc 比敲命令快得多，这是 vim 党和老命令行用户才会发现的手感差。 ## 暗门三：用 API Key 登录，自动白嫖 token 缓存 大多数人图省事，直接选"Sign in with Google"（OAuth 登录）。但官方 `token-caching.md` 文档白纸黑字写着一条认知差： > **Token caching 不可用于 OAuth 用户**（Google 个人/企业账号）——Code Assist API 目前不支持缓存内容创建。Token caching **仅对 API Key（Gemini API key）和 Vertex AI 用户**可用。 什么意思？同样一段系统提示和上下文反复出现时，**API Key 登录会把这部分缓存复用，按更低的成本计费**；而 OAuth 登录没有这个优化。对免费党来说，这直接关系到你 1000 次/天的额度能撑多久。 **操作步骤**： ```bash # 去 https://aistudio.google.com/apikey 拿 key export GEMINI_API_KEY="你的KEY" gemini ``` 然后跑 `/stats`，输出里会专门显示 **cached token（已缓存 token）** 省了多少。API Key 模式同样送 1000 次/天（Gemini 3，flash + pro 混合）。 **预期效果**：长上下文、重复系统提示的场景下，有效 token 消耗明显下降。**同一台机器，换个登录方式就开始省钱。** ## 暗门四：`-p` 无头模式，把它当免费 cron 脚本 这是"别人拿它写脚本、你拿它聊天"的方法差。 加一个 `-p`（或 `--prompt`）flag，Gemini CLI 就进入 **headless（无头）非交互模式**，直接吃 stdin、吐结构化输出，完美适合塞进 shell 脚本、cron 定时任务、CI 流水线。配合 `--output-format json` 拿到带 token 用量的 JSON： ```bash # 例：每天凌晨让 AI 扫一遍日志写摘要 gemini -p "分析 /var/log/app.log 今天的 ERROR，写一份中文摘要" \ --output-format json > daily_report.json ``` **进阶用法**： - `--prompt-interactive`（`-i`）：先跑一条 prompt，然后继续留在交互界面。 - 退出码是脚本可判断的：**0 成功、1 一般错误、42 输入错误、53 超过 turn 上限**——写自动化时照着分支处理。 - 配合 GitHub Action（`@google-github-actions/run-gemini-cli`），在 issue / PR 里 `@gemini-cli` 就能叫它干活的，HN 上相关帖 252 分。 **适用场景**：日志摘要、定时生成周报、批量改文件、CI 里自动 review。每天 1000 次免费额度，跑定时脚本绰绰有余。**这是把"聊天工具"变成"免费员工"的开关。** ## 暗门五：`auto` 模型路由 + 本地 Gemma 做决策 很多人不知道 Gemini CLI 默认模型是 `auto`——它不是固定一个模型，而是**根据任务自动路由**，主模型失败时自动 fallback 到备用模型，全程不用你管。 更狠的是**本地路由（实验性）**：用 `gemini gemma setup` 一键配置后，**路由决策改由你本地跑的 Gemma 模型来做**，不再把路由请求发给云端模型，"在保持相似延迟和质量的前提下，降低托管模型成本"。 模型选择的完整优先级链（记下来，排障时有用）： 1. `--model` 命令行 flag（最高优先级，写死） 2. `GEMINI_MODEL` 环境变量 3. `settings.json` 里的 `model.name` 4. 本地 Gemma 路由（实验性） 5. 默认 `auto` **操作步骤**：想固定省钱用小模型，`export GEMINI_MODEL=gemini-3-pro-flash`（具体别名以文档为准）；想让 CLI 自己省，保持 `auto` 并 `gemini gemma setup` 开本地路由。 **适用场景**：在意成本和速度的长期使用。**一条 setup 命令，路由费就地砍掉。** ## 暗门六：`/compress` 压上下文，`/stats model` 盯配额 免费额度再香也会用爆，这两个命令是省 token 的日常开关。 - **`/compress`**：把当前整个对话上下文替换成一份摘要。官方原话——"在保留高水平摘要的同时，节省后续任务用的 token"。长会话跑久了上下文膨胀，一刀压缩，立省后续每轮的输入成本。 - **`/stats`**（默认 `/stats session`）看会话级统计；**`/stats model`** 看 token 计数和配额信息，免费额度还剩多少一目了然；**`/stats tools`** 看哪个工具被调用最多——方便发现"AI 是不是在反复读文件烧 token"。 **适用场景**：连续干几小时的复杂任务、接近 1000 次/天上限时。**先 `/stats model` 看一眼，再决定要不要 `/compress`，这是高手的肌肉记忆。** ## 暗门七：`@`注入、`!`穿透、`/vim`——三个手感暗门 这是命令行老炮才会念叨的三个小开关，但每个都省一次"退出 CLI 再回来"。 - **`@<路径>` 注入**：`@src/my_project/ 总结下这个目录的代码`。它会读文件/目录内容塞进 prompt，而且**默认 git-aware 过滤**——`node_modules/`、`dist/`、`.env`、`.git/` 这些被 git ignore 的文件自动排除。想改过滤行为去 `context.fileFiltering` 设置。 - **`!<命令>` shell 穿透**：`!git status` 直接在 CLI 里跑 shell，输出返回后继续聊，不用退出。单独打个 `!` 还能切换"shell 模式"。注意：穿透命令的权限和你直接在终端敲一样，沙箱模式下要小心。顺带，穿透执行时子进程会带上 `GEMINI_CLI=1` 环境变量，你的脚本可以靠它检测"是不是被 Gemini 调用"。 - **`/vim`**：开 vim 模式，NORMAL/INSERT 双模式，支持 `dd`、`cw`、`3h` 这种计数前缀，状态栏显示 `[NORMAL]`/`[INSERT]`，偏好存进 `settings.json`。**vim 党狂喜。** **适用场景**：天天泡在 CLI 里的人，这三个开关能让你的手不离开键盘。 ## 暗门八：`/skills`、`/agents`、`--worktree` 三工地并行 最后是新版三个高阶开关，适合把单机当团队用。 - **`/skills`（Agent Skills）**：按需加载的"专业技能包"。`/skills list` 看全部、`/skills enable <名字>` 启用、`/skills reload` 重扫。也可命令行 `gemini skills enable --all`。这是 Gemini CLI 向 Claude Code skills 体系靠拢的新基建（仓库里 2026-05 还专门加了 agent-tui / tui-tester skills）。 - **`/agents`（子代理）**：管理本地和远程子代理，`/agents list`、`/agents enable/disable <名>`、`/agents config <名>` 还能调子代理的 model、temperature、执行上限——**相当于在 CLI 里编排一支小队**。 - **`--worktree`（`-w`）多工地**：`gemini --worktree` 直接在一个新 git worktree 里开工，一条命令开一个隔离工地，多个并行不互相踩。需要先在 settings.json 开 `experimental.worktrees: true`。配合 `--approval-mode`（`default`/`auto_edit`/`yolo`/`plan` 四档，老 `--yolo` 已废弃）控制自主权。 **适用场景**：同时推进多个功能分支、让子代理分头查资料。**一台机器跑出三人小组的并行度。** --- ## 暗门速查：遇到问题选哪个 ```mermaid flowchart TD A[打开 Gemini CLI] --> B{你的目标?} B -->|保命/防翻车| C[暗门一: 开 checkpointing
settings.json 里 enabled:true] B -->|改了一半想撤| D[暗门二: 双击 Esc 唤 /rewind] B -->|想省钱/省 token| E{哪种登录?} E -->|OAuth 谷歌账号| F[暗门三: 换 API Key 登录
自动开 token 缓存] E -->|已在 API Key| G[暗门五: gemini gemma setup
本地路由 + auto] B -->|长会话烧 token| H[暗门六: /compress 压缩
/stats model 盯配额] B -->|想当自动化脚本| I[暗门四: -p 无头模式
塞 cron / GitHub Action] B -->|多任务并行| J[暗门八: --worktree + /agents] C & D --> K[/restore 一键回滚到改文件前/] F & G & H --> L[日常省 token] I & J --> M[方法差: 别人当员工用] ``` ## 信息差总结 | 维度 | 你以为的 Gemini CLI | 别人知道的 Gemini CLI | |---|---|---| | 文件安全 | AI 改崩了就完蛋 | 开 checkpointing，`/restore` 一键回滚（暗门一） | | 登录方式 | 谷歌账号一键登录最省事 | API Key 才有 token 缓存，更省额度（暗门三） | | 用法 | 交互式聊天框 | `-p` 无头模式塞 cron / CI，免费自动化（暗门四） | | 成本 | 免费就够了 | `auto` 路由 + 本地 Gemma 决策再砍一刀（暗门五） | | 上下文 | 越聊越慢越贵 | `/compress` 压摘要、`/stats` 盯配额（暗门六） | | 多任务 | 一次一个活 | `--worktree` + `/agents` 并行多工地（暗门八） | ## 行动指南（今晚就能上手） 1. **升级到最新版**：`npm install -g @google/gemini-cli@latest`（或 `brew install gemini-cli`），确认 `/about` 显示 0.50+。 2. **第一件事开保命开关**：编辑 `~/.gemini/settings.json`，写入暗门一的 checkpointing 配置。这是不可逆操作前的安全网。 3. **换登录方式**：去 `aistudio.google.com/apikey` 拿 key，`export GEMINI_API_KEY=...` 后 `gemini` 启动，跑 `/stats` 看缓存生效。 4. **跑通一次无头脚本**：用暗门四的 `-p ... --output-format json` 写个真实的小任务（比如日志摘要），验证退出码。 5. **开本地路由**：`gemini gemma setup`，长期用再省一笔。 6. **建组合习惯**：长任务前 `/stats model` 看配额，膨胀时 `/compress`，改崩了 `/restore` 或双击 Esc。 **一句话**：Gemini CLI 的免费额度已经是同档位最慷慨的，但这 8 个暗门才是把它从"聊天框"变成"免费员工+保命工具+省钱机器"的真正钥匙。开一个赚一个。 --- **参考来源**（均为可点击一手链接）： - Gemini CLI 官方仓库（README，免费额度/认证/核心功能）：https://github.com/google-gemini/gemini-cli - 斜杠命令完整文档（`/restore`、`/rewind`、`/compress`、`/stats`、`/skills` 等）：https://github.com/google-gemini/gemini-cli/blob/main/docs/reference/commands.md - Token 缓存与成本优化文档：https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/token-caching.md - 检查点（Checkpointing）文档：https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/checkpointing.md - 无头模式 / CLI 参数参考文档：https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/cli-reference.md - HN 社区讨论 *I watched Gemini CLI hallucinate and delete my files*（暗门一的反面教材）：https://news.ycombinator.com/item?id=44651485 - HN 社区技巧合集 *Gemini CLI tips and tricks for agentic coding*：https://news.ycombinator.com/item?id=46060508 --- > 本文由「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 等场景全覆盖。