用惯 Claude Code 和 Cursor 的国内开发者,十有八九忽略了 Google 那个开源的 Gemini CLI。多数人拿它就当个终端里的聊天框,问两句就关了——但这个项目在 GitHub 上开源(google-gemini/gemini-cli)以来,真正值钱的不是模型本身,而是藏在文档里的一整套工程化机关:分层记忆、自定义命令、检查点回滚、沙箱隔离、MCP 外接。更关键的是它的免费额度:官方公布的开服政策是个人 Google 账号登录后,每分钟 60 次请求、每天 1000 次请求(以 Gemini 2.5 Pro 档位),这个量级足够一个人全天的编码工作。本文带你把这 8 个机关一个个挖出来,全部可复制操作。
Claude Code 有 CLAUDE.md,Gemini CLI 对应的是 GEMINI.md,而且是三层合并的:
~/.gemini/GEMINI.md,写你的个人偏好,比如「回复用中文」「commit message 不加版本号」,所有项目都生效;GEMINI.md,写技术栈约定、目录结构、禁改区域,团队可以提交进 git 共享;会话里用 /memory show 可以查看当前生效的完整记忆,/memory add 直接往里追加规则,/memory refresh 重新加载文件。国内教程几乎没人讲「三层合并」这个特性——大多数人只会在根目录放一个文件。
适用场景:接手老项目时,把「哪些目录不能动、构建命令是什么」写进项目级 GEMINI.md,之后每次会话都不用重复交代。
这是被严重低估的功能。在 ~/.gemini/commands/(全局)或项目 .gemini/commands/(项目级)下放 TOML 文件,就能注册成你自己的斜杠命令:
# ~/.gemini/commands/review.toml
prompt = "请审查当前 git diff 中的改动,重点看:1) 空指针风险 2) 并发问题 3) 资源泄漏。用中文输出,按严重程度排序。"
description = "代码审查三件套"
重启会话后输入 /review 即可触发。文件放子目录还能形成命名空间,比如 commands/git/squash.toml 对应 /git:squash。把你反复用的 prompt 全部固化,这本质上是在给自己搭一个私人指令库。
! 直通 Shell 和 @ 文件注入两个单字符前缀,效率天差地别:
!ls -la 直接执行 shell 命令,结果留在上下文里让 AI 接着分析;单独输 ! 回车进入常驻 shell 模式;@src/api/ 会把整个目录结构注入上下文,@README.md 注入单文件,比手动「请阅读这个文件」快得多。组合技:!npm test 跑完测试,紧接着说「按上面的报错修复」,AI 能直接看到完整报错输出,省一轮粘贴。
这是我最推荐开启的机关。启动时加 --checkpointing 参数(或在 settings.json 里配置),Gemini CLI 在每次修改文件前自动做快照。AI 把你的代码改崩了?输入 /restore 直接回滚到改动前,包括文件状态。
对于「让 AI 大刀阔斧重构」的场景,这个功能就是安全气囊。Claude Code 和 Cursor 的类似机制都需要你先 commit,而 checkpoint 是会话内的即时快照,粒度更细。
--yolo 会自动批准所有工具调用,不再逐条询问——多步任务一口气跑完,不用你守着敲确认。但裸奔有风险,正确姿势是和沙箱组合:
gemini --yolo --sandbox
沙箱模式下命令跑在 Docker 容器(或 macOS Seatbelt 隔离)里,AI 执行 rm -rf 也伤不到宿主机。「自动批准 + 隔离执行」这个组合拳,是 Agent 长任务跑批的标配姿势,国内文章很少把两者放在一起讲。
Gemini CLI 原生支持 MCP(Model Context Protocol)协议。在 settings.json 的 mcpServers 字段里配置服务端,比如接 Playwright MCP 让它自己开浏览器点页面、接数据库 MCP 让它直接查表验证代码。会话里用 /mcp 查看已接入的能力状态。
这意味着它可以成为你所有工具的中控台:CLI 本体免费,外围能力按需插拔。国内的 DeepSeek、Kimi 生态目前还没有这么顺手的终端级 MCP 宿主。
/chat save 多会话存档,任务并行不串味长会话最怕上下文串味:一会儿改后端一会儿写文档,模型开始胡说。用 /chat save backend-fix 把当前会话状态存成标签,开新会话做别的,需要时 /chat resume backend-fix 完整恢复。配合 /compress 压缩过长的上下文,既省免费额度又保住关键信息。
/stats 盯额度 + /auth 换认证方式/stats 随时查看本次会话的 token 消耗和剩余额度,免费额度用超会降级到 Flash 档模型,重活前先看一眼。认证方式有三种:个人 Google 账号登录(免费额度)、API key(付费按量)、Vertex AI(企业)。国内用户注意:API key 可在 Google AI Studio(aistudio.google.com/apikey)生成,部分地区需要自备网络环境,账号登录的免费档是性价比最高的入口。
把这 8 个机关拼成一条完整流水线,大概长这样:
flowchart TD
A["启动 gemini"] --> B["载入全局 GEMINI.md"]
B --> C["叠加项目级 GEMINI.md"]
C --> D{"任务需要外部能力吗"}
D -->|操作网页| E["接入 Playwright MCP"]
D -->|查数据| F["接入数据库 MCP"]
D -->|不需要| G["纯本地改码"]
E --> H["开启 yolo 加沙箱自动执行"]
F --> H
G --> H
H --> I["每次改文件前自动 checkpoint"]
I --> J{"结果满意吗"}
J -->|满意| K["/chat save 存档收工"]
J -->|改坏| L["/restore 回滚重来"]
| 维度 | 你知道的 | 别人在用的 |
|---|---|---|
| 定位 | 终端聊天框 | 可编程的 Agent 宿主 |
| 上下文 | 每次手动粘贴 | GEMINI.md 三层自动注入 |
| 重复劳动 | 反复敲同样的 prompt | 自定义 TOML 斜杠命令 |
| 改码安全 | 改崩了手动 git 恢复 | checkpoint + /restore 秒回滚 |
| 自动执行 | 逐条点确认 | yolo + 沙箱隔离全自动 |
| 外围能力 | 只能对话 | MCP 接浏览器/数据库 |
| 成本 | 以为要付费 | 个人账号免费额度每天 1000 次 |
npm install -g @google/gemini-cli,用个人 Google 账号登录,跑通第一次对话;--yolo --sandbox + checkpoint 的安全跑批习惯。注:免费额度(60 次/分钟、1000 次/天)为官方发布时公布的开服政策,具体模型档位和额度可能随版本调整,以官方仓库 README 实时说明为准。
本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵爱卫生(微信ID: gprshome201101)维护。 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。