很多人对 Gemini CLI 的印象还停留在“谷歌跟风出的命令行 AI”：装一下，问两句，然后回头继续用 Cursor。海外社区（HN、Reddit r/Bard）从 2025 年 6 月它开源那天起就没这么看过——因为翻开它的仓库文档你会发现，这个免费、Apache 2.0 开源的命令行工具，塞了一堆国内教程几乎没讲过的暗门：三层记忆系统、自定义斜杠命令、文件级“后悔药”、MCP 外挂、无头模式管道。今天这篇把其中 8 个最有价值的暗门一次拆完，每一个都能今晚就上手。
更香的是：阿里巴巴的 Qwen Code 就是直接 fork 自 Gemini CLI（仓库：github.com/QwenLM/qwen-code），所以这 8 招基本原样平移到国产 Qwen 上——学一次，两头白嫖。
npm install -g @google/gemini-cli，装完在项目根目录敲 gemini 回车，用个人 Google 账号登录即可。/auth 里切换成自己的 API Key 或 Vertex AI 按量付费。安装这步 90% 的人都会，真正的差距从敲下 gemini 之后开始。
! 直通模式，终端里的终端怎么做：在对话框里直接输入 !git status 或 !npm test。单独输入一个 ! 可以切换整个 shell 模式，再按一次退出。
效果：命令不经过 AI、不烧 token，直接本地执行，但执行输出会自动进入对话上下文——AI 看得见，你可以紧接着问“这个报错怎么修”。
适用场景：跑测试、看日志、查端口占用之后再让 AI 分析结果。以前你需要复制粘贴，现在一个 ! 搞定，上下文无缝衔接。
@ 引用整个目录，不只是单个文件怎么做：输入 @ 会弹出文件自动补全，这是常识；冷知识是 @ 后面可以跟目录：@src/utils/ 总结这个目录下所有模块的职责。
效果：一次把整个目录的代码喂进上下文，不用一个个 @ 文件。
适用场景：接手陌生项目让它画架构图、重构前让它盘点某个包里的重复逻辑。配合下一招的子目录记忆，威力翻倍。
大多数人知道项目根目录可以放 GEMINI.md 当项目说明书，但不知道它是三层结构：
~/.gemini/GEMINI.md —— 你的个人偏好（比如“回答用中文”“默认用 pnpm 不用 npm”），对所有项目生效；GEMINI.md —— 项目约定（技术栈、目录结构、提交规范），团队可共享进 git；三个配套命令：/init 让 AI 扫描项目自动生成一份初稿；/memory add "这条记下来" 在对话中随时追加；/memory show 查看当前生效的全部记忆。
还有一个几乎没人用的设置：在 ~/.gemini/settings.json 里写 "contextFileName": "AGENTS.md"，把说明书文件名改成 AGENTS.md——这样 Codex、Cursor 等工具可以和它共用同一份项目说明书，一份维护，全家受益。
怎么做（5 分钟版）：项目根目录敲 /init → 人工补上团队规范 → 提交进 git。
flowchart TD
A["终端敲 gemini 回车"] --> B["第一层:全局记忆<br/>~/.gemini/GEMINI.md"]
B --> C["第二层:项目记忆<br/>根目录 GEMINI.md"]
C --> D["第三层:子目录记忆<br/>干活时按需加载"]
D --> E["对话中 memory add<br/>随时追加记忆"]
E --> F["模型带着三层记忆干活"]
/一行怎么做：在项目里建 .gemini/commands/review.toml（全局版放 ~/.gemini/commands/），内容：
description = "以资深审查者身份审查改动"
prompt = """
请审查以下改动，按严重程度列出问题，最后给一行结论：
{{args}}
"""
效果：以后在任何对话里敲 /review 就是一套完整提示词，{{args}} 位置接收你的附加参数。放全局目录则跨项目通用；放进 git 全组共享，团队 prompt 规范从此不再是群公告里的“请用这段话”。
适用场景：代码审查、写周报、生成 commit message、按固定模板写测试——凡是你要“反复说同样的话”的场景。
--checkpointing，AI 每次改文件前自动存档，改崩了敲 /restore 一键还原到任意一步。/chat save 分支A 保存当前对话快照，/chat list 列出存档，/chat resume 分支A 读档。让 AI 试两条不同的重构路线？先存档再开跑，哪条不行读档重来。适用场景：大规模重构、批量改动。免费工具配免费后悔药，比很多人想象中稳。
/stats、/compress、模型切换免费额度也是钱，HF 社区调 API 的老哥们最懂。三个习惯：
/stats：随时查看本次会话 token 消耗明细，知道钱花在哪；/compress：把冗长的历史对话压缩成一份摘要替换掉原上下文，长会话续命神器——上下文越肥，每次请求烧的额度越多，长对话定期压一次能省一大截；/model 切换：跑腿活（改注释、写脚本）切到 flash 级小模型，硬仗（架构设计、复杂调试）再切回 Pro。全用 Pro 是最常见的浪费。Gemini CLI 原生支持 MCP（Model Context Protocol），改 .gemini/settings.json：
{
"mcpServers": {
"browser": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
效果：重启后它多了一双“手”——可以直接操作浏览器：打开你本地跑起来的页面、点按钮、填表单、截图回来分析。“改完这个 Bug 自己验一遍”从愿望变成一条指令。
配套两个自查命令：/tools 列出当前所有可用工具，/mcp list 查看 MCP 连接状态。接上 Playwright 只是入门，文件系统、数据库、Figma 等各类 MCP server 都能按同样格式挂进来（各 server 的具体配置以其官方文档为准）。
这是国内外教程差距最大的一块。Gemini CLI 有完整的非交互模式：
gemini -p "用一句话总结这个仓库是干嘛的"：单发问、单发答，不进交互界面；git diff | gemini -p "为这次改动写一条 commit message"：标准输入管道，任何命令的输出都能喂给它；flowchart TD
A["cron 定时任务"] --> B["脚本抓数据<br/>git diff 或日志"]
B --> C["管道喂给 gemini -p"]
C --> D["无界面模式直接出结论"]
D --> E["写回文件或发通知"]
适用场景：日常脚本里加一步“AI 判断”、CI 里自动审 PR、定时任务跑日报。这一招让 Gemini CLI 从“聊天工具”升级成“可编排的自动化引擎”。
加 --approval-mode yolo 可以让 AI 免确认自动执行一切，配合前两招确实爽，但等于把键盘整个交出去。正确姿势是套一层 --sandbox（基于 Docker/Podman 容器或 macOS Seatbelt 沙箱）再开 YOLO——先关进笼子，再放权限。
| 你以为的 | 实际上的 |
|---|---|
| Gemini CLI 就是个免费聊天框 | 它是能挂 MCP、能进 CI 的自动化引擎 |
| 提示词要每天重新打 | 三层 GEMINI.md + 自定义命令，一次沉淀终身复用 |
| 免费额度不经用 | /stats + /compress + 大小模型切换，能省一半以上 |
| 它只能人肉交互 | 无头模式 + 管道，是写给脚本和 CI 用的 |
| 国内用不上 | Qwen Code fork 自它，八招几乎原样通用 |
npm install -g @google/gemini-cli，项目根目录 gemini 登录；/init 生成项目说明书，补上团队规范后提交进 git；.gemini/commands/review.toml，把你最常重复的提示词固化成 /命令；gemini -p 写 commit message”写进你的 shell 别名——这是最容易坚持下来的第一个自动化。注：以上均为官方固定地址。个别命令参数可能随版本更新变化，以仓库 docs 目录的最新说明为准。
本文由「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 等场景全覆盖。