你以为免费的终端 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 <tool_call_id>。
- 想连对话历史一起往回走？/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，节奏是这样的：
flowchart LR
A["/init<br/>生成 GEMINI.md"] --> B["/memory show<br/>确认上下文记忆"]
B --> C["--checkpointing 启动<br/>打开时光机"]
C --> D["/plan<br/>只读规划，锁定方案"]
D --> E["@src 注入 + !git<br/>看码又跑命令"]
E --> F["改崩了 /restore<br/>逐笔回滚"]
F --> G["/stats 看账<br/>→ /compress 瘦身"]
G --> H["-p 无头 / setup-github<br/>固化进 CI"]
style A fill:#e8f5e9
style C fill:#fff3e0
style F fill:#ffebee
style H fill:#e3f2fd
| 维度 | 大多数人的认知 | 海外老手在用的暗功能 |
|---|---|---|
| 价格 | "终端 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 |
npm install -g @google/gemini-cli，用 Google 账号登录，进任意项目敲 /init 生成 GEMINI.md，感受一下免费的 Pro 水位。--checkpointing，建第一个 .gemini/commands/review.toml 自定义命令，把你最常用的 review 模板固化成一两个字母。--sandbox 跑一次迁移，再把 -p 无头模式或 /setup-github 接进你的 CI——把"白嫖的 Pro"真正变成团队生产力。如果只能记一条：别把 Gemini CLI 当聊天框，把它当成一个带时光机（checkpoint）、能被脚本化（-p）、还能自己长出团队命令（.toml）的 Agent 内核。 现在的免费水位不会永远在，早把工作流迁过去的人，先吃到这波红利。
本文由「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 等场景全覆盖。