# 终端白嫖Pro：Gemini CLI八个暗功能 你以为免费的终端 AI Agent 只有帮你补全代码的份？2026 年中国开发者圈对 **Gemini CLI** 的认知还停在"哦，Google 出了个命令行 ChatGPT"。但海外早把它的 **checkpoint 回滚机**、**`.toml` 自定义命令**、**`--yolo` 无人值守**玩出花了。这个工具最狠的信息差不是"它存在"，而是——**它免费给到 Gemini 2.5 Pro 级模型，每天 1000 次请求，而 90% 用户只用到了打字聊天那一成功能**。今天这一篇，我把终端里八个被埋没的"暗功能"一次性掏给你，每一个都能立刻复制粘贴到你的项目里。 ## 先把价格差说清楚：为什么它值得你折腾 在进入技巧之前，先看一组让国内同行酸的数据。Gemini CLI 用个人 Google 账号认证（走 Gemini Code Assist for individuals 通道），免费层就是这样的水位： | 维度 | Gemini CLI（免费） | 对比对象 | |------|------------------|---------| | 模型 | Gemini 2.5 Pro 级 | 别家 Pro 多要按 token 收费 | | 每日请求 | **1000 次/天**（约 60 次/分钟） | 很多免费工具一天几十次封顶 | | 形态 | 开源、本地终端 Agent | 代码不离开本机 | | 是否开源 | 是（Apache-2.0） | 可自部署、可改 | > 实操前提：你需要一个能访问 Google 服务的环境和一个 Google 账号，具体额度以官方 quota 页为准。安装就一行：`npm install -g @google/gemini-cli`，或 `npx https://github.com/google-gemini/gemini-cli`。开源仓库在 `github.com/google-gemini/gemini-cli`。 一句话：这是目前 **Pro 模型水位最高、最不要钱**的终端 Agent。下面八个暗功能，才是把这份"白嫖红利"榨干的关键。 --- ## 暗功能一：`@` 注入 + `!` 透传——一行话干完三件事 大多数人进 Gemini CLI 就是打字聊天。但你输入框里其实藏着两个"前缀开关"，海外老手几乎每次都在用。 **操作步骤**： - `@` 前缀：在 prompt 里写 `@src/api.ts 这段鉴权逻辑有漏洞吗`，Gemini 会把整个文件内容注入上下文（**而且是 git-aware 的，自动跳过 `.gitignore` 里的东西**，连目录都行：`@src/`）。 - `!` 前缀：写 `!git status` 直接执行 shell 命令，输出留在会话里供后续对话引用。 - 单独敲一个 `!` 回车，进入**持久 shell 模式**，之后每行都是 shell 命令，再敲一次退出。 **预期效果**：不用切窗口、不用复制粘贴代码块，"看代码—问问题—跑命令"在一个框里闭环。 **适用场景**：边排查 bug 边看日志，边改代码边跑测试。国内用 Cursor/插件的人习惯用 `@`，但把 `!` 也用起来的人很少——这是终端 Agent 相对 IDE 插件的独家红利。 --- ## 暗功能二：`--checkpointing` + `/restore`——AI 改坏了能逐笔回滚 这是我心中 Gemini CLI **最被低估、也最该被国人知道**的一个功能。很多人让 Agent 重构完才发现改崩了，只能 `git stash` 一把梭。Gemini 自带一台"时光机"。 **操作步骤**： - 启动时加 `--checkpointing`（或写进 `settings.json` 永久开启）。 - 之后**每一次工具调用前，Gemini 都自动给文件状态打快照**。 - 翻车了，敲 `/restore` 弹出回滚点列表；或精准回滚某一步：`/restore `。 - 想连对话历史一起往回走？`/rewind`（或连按两次 `Esc`），对话和代码同步倒带。 **预期效果**：Agent 大胆重写也不怕，每一个原子改动都能撤销，**不依赖你提前 `git commit`**。 **适用场景**：让 Agent 接手陌生大型重构、批量改文件、跑迁移脚本。这是它和很多"只进不出"的 Agent 工具的本质区别——**给放手权限，配一个刹车**。 --- ## 暗功能三：`.toml` 自定义命令——把团队 SOP 压成一两个字母 这条是海外团队从 2025 年 7 月（自定义斜杠命令上线）就在偷偷用的生产力杠杆，国内几乎没人讲。 **操作步骤**： - 在项目里建 `.gemini/commands/review.toml`（或全局 `~/.gemini/commands/`）： ```toml description = "只做战略规划，不写实现。" prompt = "针对以下任务做分步计划：{{args}}。不要写代码。" ``` - 关键在于两个占位符：`{{args}}` 接你命令后面的参数，`!{shell}` 可以**注入 shell 执行结果**（比如 `!{git diff}` 把当前改动喂进 prompt）。 - 在会话里敲 `/commands reload` 刷新，之后就能 `/review 这段支付逻辑`。 - 额外彩蛋：你配置的 **MCP server 暴露的 prompts 会自动变成斜杠命令**，免开发。 **预期效果**：把团队反复要用的 prompt（code review 模板、提交规范、测试生成、安全审计）固化成一两个字母，新人 0 学习成本。 **适用场景**：多人协作、新人多、有固定流程的团队。这是 Gemini CLI 比同类命令体系**最可扩展**的一点——对比下来 Codex/Claude Code/OpenCode 在自定义命令上都各有取舍，`.toml` + shell 注入的组合是独一份。 --- ## 暗功能四：`/compress`——长会话不重开，免费额度塞进更多轮 免费 1000 次/天听着多，但一个长任务跑一下午就烧光了。`/compress` 是省额度的核心旋钮。 **操作步骤**：对话变慢、上下文堆满时，敲 `/compress`。它会**把历史对话摘要替换进上下文，释放 token**，但保留关键决策和文件状态。配合 `/stats`（见下条）对比压缩前后的 token 占用。 **预期效果**：不重启会话、不丢失主线，把一个长会话从"撑满即崩"变成"可持续跑到第二天"。 **适用场景**：跨多天的大重构、长链路调试、读一整个大仓库。海外叫它 "free context mid-session"，和 Claude Code 的 `/compact` 同思路，但在免费 Pro 模型上用，性价比更高。 --- ## 暗功能五：`/stats`——看清 token 都被谁吃了 免费额度时代，"看得见花在哪"比"会省"更重要。 **操作步骤**：随时敲 `/stats`，它会分三块给你账单——`session`（整体会话用量）、`model`（各模型消耗）、`tools`（工具调用次数与性能）。 **预期效果**：一眼定位"是哪个 `@` 大文件、哪个目录扫进来在烧 token"，然后针对性用 `.gitignore` 或更窄的 `@` 路径排除。 **适用场景**：免费额度优化、排查"为什么突然变慢/变贵"、决定该不该 `/compress`。这是把 Agent 从"黑箱"变"白箱"的第一步。 --- ## 暗功能六：`--include-directories`——一个 Agent 同时盯多个仓库 国内微服务、前后端分离项目多，但很多人不知道可以让一个 Agent 同时看见多个目录。 **操作步骤**：启动时 `gemini --include-directories /repo/backend,/repo/frontend`（逗号分隔，也可重复传多个 `--include-directories`）。 **预期效果**：改后端 API 的同时，Agent 能看到前端调用处，一次性把接口和调用方一起改对，不用你在两个项目间来回 `cd`。 **适用场景**：monorepo 拆分的前后端、微服务改一个接口要联动多个仓库、做全栈联调。配 `--extensions` 还能按需加载扩展，控制加载范围。 --- ## 暗功能七：`--yolo` + `--sandbox`——放手让它自己跑（安全版 vs 野版） 这是 Gemini CLI 最"刺激"的一对旋钮，也是海外 Reddit 上讨论最热的玩法。 **两个分支要分清**： - **野版 `--yolo`**：`gemini --yolo`（等价 `--approval-mode yolo`，会话中按 `Ctrl+Y` 也能切）。它**自动批准每一个动作**，包括写文件、跑命令、联网。⚠️ **官方原话级别警告：仅在一次性 VM 或沙箱 worktree 里用**，别在你生产仓库根目录裸跑。 - **安全版 `--sandbox`**：`gemini --sandbox`，把工具调用关进 **Docker 或 Podman 沙箱**，默认拦截越界的网络和文件访问。想要更细的可选 `--approval-mode default`（每步问）或 `auto_edit`（自动改文件、命令仍问你）。 **预期效果**：要么完全无人值守跑长任务（野版 + 隔离环境），要么在受控沙箱里大胆试错（安全版）。 **适用场景**：批处理、大规模迁移、跑别人传上来的不信任代码。核心心智模型是——**`--yolo` 是油门，`--sandbox` 是护栏，两个永远成对出现在海外老手的脚本里**。 > 还有个坑要提：Gemini CLI **拒绝在未受信任（untrusted）的文件夹里运行**。在服务器上第一次进一个目录会卡住，用 `--skip-trust` 或 `/permissions trust [path]` 先信任。 --- ## 暗功能八：`-p/--prompt` 无头模式 + `/setup-github`——把 Agent 塞进 CI 最隐蔽、也最值钱的一条。绝大多数人把 Gemini CLI 当交互工具用，但它天生是**可脚本化、可塞进 CI**的。 **操作步骤**： - **无头一次性执行**：`gemini -p "给这个 diff 写一段符合规范的 commit message"`，非交互、跑完即退，完美适合写进 shell 脚本。 - **接入 GitHub Actions**：在会话里敲 `/setup-github`，它会帮你配好 GitHub Actions workflow，实现 **issue 自动 triage（分类）+ PR 自动 AI review**。 - 搭配 `--model pro`/`flash` 按任务挑模型：写代码用 pro，跑杂活/分类用 flash-lite 省额度，`/model set --persist` 把选择固化。 **预期效果**：团队每提一个 PR 自动有 AI 先过一遍、每个 issue 自动打标签分流，**省掉大量人肉 review 和分类时间**——这才是"白嫖 Pro"在生产环境里的真正变现。 **适用场景**：开源项目、小团队缺 reviewer、想给流程加自动化护栏。 --- ## 一张图串起完整工作流 把上面八条放进一个真实 session，节奏是这样的： ```mermaid flowchart LR A["/init
生成 GEMINI.md"] --> B["/memory show
确认上下文记忆"] B --> C["--checkpointing 启动
打开时光机"] C --> D["/plan
只读规划，锁定方案"] D --> E["@src 注入 + !git
看码又跑命令"] E --> F["改崩了 /restore
逐笔回滚"] F --> G["/stats 看账
→ /compress 瘦身"] G --> H["-p 无头 / setup-github
固化进 CI"] style A fill:#e8f5e9 style C fill:#fff3e0 style F fill:#ffebee style H fill:#e3f2fd ``` --- ## 信息差总结：你知道的 vs 别人不知道的 | 维度 | 大多数人的认知 | 海外老手在用的暗功能 | |------|--------------|-------------------| | 价格 | "终端 AI 都要订阅" | **Pro 级模型，1000 次/天免费** | | 输入 | 只会打字 | **`@` 注文件 / `!` 跑命令 / 单 `!` 进 shell 模式** | | 翻车 | 改崩了手动 `git stash` | **`--checkpointing` + `/restore` 逐笔回滚** | | 复用 | 每次重写 prompt | **`.toml` 自定义命令 + `{{args}}` + `!{shell}`** | | 额度 | 用满就重开 | **`/compress` + `/stats` 精打细算** | | 范围 | 一次一个目录 | **`--include-directories` 跨多仓** | | 自动化 | 全程盯着 | **`--yolo`+`--sandbox`、`-p` 无头、`/setup-github` 进 CI** | | 模型 | 一直用默认 | **`/model set --persist` 按任务挂 pro/flash** | --- ## 行动指南：今晚就能上手的三步 1. **今天**：`npm install -g @google/gemini-cli`，用 Google 账号登录，进任意项目敲 `/init` 生成 `GEMINI.md`，感受一下免费的 Pro 水位。 2. **本周**：开启 `--checkpointing`，建第一个 `.gemini/commands/review.toml` 自定义命令，把你最常用的 review 模板固化成一两个字母。 3. **本月**：在隔离环境里试 `--sandbox` 跑一次迁移，再把 `-p` 无头模式或 `/setup-github` 接进你的 CI——把"白嫖的 Pro"真正变成团队生产力。 如果只能记一条：**别把 Gemini CLI 当聊天框，把它当成一个带时光机（checkpoint）、能被脚本化（`-p`）、还能自己长出团队命令（`.toml`）的 Agent 内核。** 现在的免费水位不会永远在，早把工作流迁过去的人，先吃到这波红利。 --- ## 参考来源 - Gemini CLI 官方开源仓库（安装、文档起点）：[github.com/google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli) - 官方 Quotas & Pricing（免费层额度）：[geminicli.com/docs/resources/quota-and-pricing](https://geminicli.com/docs/resources/quota-and-pricing/) - 官方 Commands 参考（50+ 斜杠命令）：[geminicli.com/docs/reference/commands](https://geminicli.com/docs/reference/commands/) - 社区高赞技巧合集（~30 条 pro-tips）：[github.com/addyosmani/gemini-cli-tips](https://github.com/addyosmani/gemini-cli-tips) - 斜杠命令与 CLI flags 速查表：[computingforgeeks.com/gemini-cli-cheat-sheet](https://computingforgeeks.com/gemini-cli-cheat-sheet/) - 免费 1000 次/天接入教程：[apidog.com/blog/gemini-cli-setup-guide](https://apidog.com/blog/gemini-cli-setup-guide/) --- > 本文由「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 等场景全覆盖。