首页 › tips-tricks › Gemini CLI的8个隐藏机关,免费额度别浪费

Gemini CLI的8个隐藏机关,免费额度别浪费

用惯 Claude Code 和 Cursor 的国内开发者,十有八九忽略了 Google 那个开源的 Gemini CLI。多数人拿它就当个终端里的聊天框,问两句就关了——但这个项目在 GitHub 上开源(google-gemini/gemini-cli)以来,真正值钱的不是模型本身,而是藏在文档里的一整套工程化机关:分层记忆、自定义命令、检查点回滚、沙箱隔离、MCP 外接。更关键的是它的免费额度:官方公布的开服政策是个人 Google 账号登录后,每分钟 60 次请求、每天 1000 次请求(以 Gemini 2.5 Pro 档位),这个量级足够一个人全天的编码工作。本文带你把这 8 个机关一个个挖出来,全部可复制操作。

机关一:分层 GEMINI.md,一次调教处处生效

Claude Code 有 CLAUDE.md,Gemini CLI 对应的是 GEMINI.md,而且是三层合并的:

会话里用 /memory show 可以查看当前生效的完整记忆,/memory add 直接往里追加规则,/memory refresh 重新加载文件。国内教程几乎没人讲「三层合并」这个特性——大多数人只会在根目录放一个文件。

适用场景:接手老项目时,把「哪些目录不能动、构建命令是什么」写进项目级 GEMINI.md,之后每次会话都不用重复交代。

机关二:自定义斜杠命令,把常用 prompt 固化成指令

这是被严重低估的功能。在 ~/.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 和 @ 文件注入

两个单字符前缀,效率天差地别:

组合技:!npm test 跑完测试,紧接着说「按上面的报错修复」,AI 能直接看到完整报错输出,省一轮粘贴。

机关四:checkpointing,AI 改码的后悔药

这是我最推荐开启的机关。启动时加 --checkpointing 参数(或在 settings.json 里配置),Gemini CLI 在每次修改文件前自动做快照。AI 把你的代码改崩了?输入 /restore 直接回滚到改动前,包括文件状态。

对于「让 AI 大刀阔斧重构」的场景,这个功能就是安全气囊。Claude Code 和 Cursor 的类似机制都需要你先 commit,而 checkpoint 是会话内的即时快照,粒度更细。

机关五:YOLO 模式 + 沙箱,胆子和安全都要有

--yolo 会自动批准所有工具调用,不再逐条询问——多步任务一口气跑完,不用你守着敲确认。但裸奔有风险,正确姿势是和沙箱组合:

gemini --yolo --sandbox

沙箱模式下命令跑在 Docker 容器(或 macOS Seatbelt 隔离)里,AI 执行 rm -rf 也伤不到宿主机。「自动批准 + 隔离执行」这个组合拳,是 Agent 长任务跑批的标配姿势,国内文章很少把两者放在一起讲。

机关六:MCP 外接,让它操作浏览器和数据库

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 次

行动指南

  1. 今天:npm install -g @google/gemini-cli,用个人 Google 账号登录,跑通第一次对话;
  2. 本周:在主力项目根目录写一份 GEMINI.md(技术栈 + 禁改区 + 构建命令),把最常用的 3 个 prompt 固化成 TOML 命令;
  3. 本月:接入一个 MCP 服务(推荐 Playwright),并养成 --yolo --sandbox + checkpoint 的安全跑批习惯。

参考来源

  1. Gemini CLI 官方开源仓库(含全部功能文档):https://github.com/google-gemini/gemini-cli
  2. 仓库 docs 目录(GEMINI.md、自定义命令、checkpointing 等专题文档):https://github.com/google-gemini/gemini-cli/tree/main/docs
  3. 免费 API key 生成入口:https://aistudio.google.com/apikey

注:免费额度(60 次/分钟、1000 次/天)为官方发布时公布的开服政策,具体模型档位和额度可能随版本调整,以官方仓库 README 实时说明为准。


本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵爱卫生(微信ID: gprshome201101)维护。 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。