首页 › tips-tricks › Gemini CLI压箱底的七手绝活

Gemini CLI压箱底的七手绝活：免费额度这么用才不亏

Claude Code 订阅每月 20 美元，Codex 要绑 API 计费，而 Google 的 Gemini CLI 从发布那天起就挂着开源和免费两块招牌——用个人 Google 账号登录即可使用，发布时官方公布的免费额度是每分钟 60 次、每天 1000 次请求，附带当时最强的 1M token 上下文窗口（额度以官方文档实时为准）。但对多数中文用户来说，它只被当成“终端里的聊天框”，真正的生产力开关几乎没人扒过。这篇文章把 Gemini CLI 压箱底的七手绝活一次讲透，每一手都给出可直接复制的操作步骤。先装好它：npm install -g @google/gemini-cli，项目目录里敲 gemini，用个人 Google 账号 OAuth 登录就能开跑。

绝活一：三层 GEMINI.md，让 AI 永远“记得”你的规矩

大多数人在提示词里反复交代“我们用 pnpm 不用 npm”“接口返回包一层 code 字段”，每开一个新会话都要重讲一遍。Gemini CLI 的解法是 GEMINI.md 分层记忆体系，它像配置文件一样自动加载：

全局层：~/.gemini/GEMINI.md —— 放你的个人偏好，比如“回复用中文”“提交信息遵循 Conventional Commits”，对所有项目生效；
项目层：项目根目录的 GEMINI.md —— 放架构说明、技术栈约定、禁改清单；
子目录层：任意子目录里再放一个 —— 只在 AI 触碰该目录内容时叠加生效，比如 legacy/ 目录里写“此目录代码禁止重构，只允许最小改动”。

操作步骤：进入项目后执行 /init，Gemini CLI 会自动扫描代码库并生成一份初版 GEMINI.md；之后随时用 /memory add "所有新代码必须补充单元测试" 追加规则，用 /memory show 查看当前生效的完整记忆。

适用场景：多项目切换的 freelance 开发者、带历史包袱的老项目维护。这一手是 Claude Code 的 CLAUDE.md 同款思路，但免费版就有，而且三层叠加的粒度更细。

绝活二：TOML 自定义斜杠命令，把重复工作流做成按钮

每 code review 都要打一大段提示词？Gemini CLI 支持把提示词做成自定义斜杠命令——这是中文社区几乎没人写过的功能。

操作步骤：创建 ~/.gemini/commands/review.toml，内容：

prompt = "请审查当前改动：先运行 git diff，再按安全、性能、可读性三类输出问题清单，每条附修复建议。额外要求：{{args}}"

回到会话里输入 /review 关注SQL注入，{{args}} 会被自动替换成你尾巴上接的参数。命令文件放在 ~/.gemini/commands/ 是全局生效，放在项目 .gemini/commands/ 里只对本项目生效，还能随 git 提交分享给全组——把团队 code review 标准固化成仓库里的一个 TOML 文件，新人 clone 下来就自带同款工作流。放进子目录还能得到带命名空间的命令，例如 commands/git/ship.toml 对应 /git:ship（命名规则以官方文档为准）。

适用场景：团队协作、需要固化 prompt 资产的人。这是把“提示词工程”落地成“配置工程”的关键一步。

绝活三：`!` shell 模式与 `!{}` 注入，终端和 AI 无缝互操作

在 Gemini CLI 会话里，行首敲 ! 直接进入 shell 模式：!git status、!docker ps -a 原地执行，不用退出会话。更值钱的是 !{命令} 注入语法——把 shell 命令的输出结果直接塞进提示词：

对比 !{git diff HEAD~1} 里的改动，找出可能的内存泄漏点，只列结论。

AI 拿到的是真实的 diff 内容而不是文件名，省去“你先读文件 A、再读文件 B”的多轮拉扯。

预期效果：排查类任务从“来回十几轮”压到一轮搞定，token 消耗同步下降。适用场景：查日志、审 diff、核对环境变量等“先跑命令再分析”的高频动作。

绝活四：`@` 引用一切——整目录、截图、PDF 直接喂

@ 键触发文件自动补全，但它远不止选个文件这么简单：

@src/api/ —— 引用整个目录，AI 批量读入后做跨文件分析；
@报错截图.png —— 多模态读图，UI 还原、报错截图转 issue 都能干；
@采购合同.pdf —— 直接读 PDF 提取条款，不用先转文本。

操作步骤：输入 总结 @docs/design/ 的设计约定，再对照 @src/ 实现找出不一致的地方，一条指令完成“读文档+读代码+交叉比对”。适用场景：接手无文档老项目、按设计图写页面、批量处理合同或论文。免费额度同样可以用多模态输入，这一点比很多按量计费的工具友好得多。

绝活五：/chat 存档 + /restore 回滚，给 AI 改动上双保险

两个鲜为人知的保险机制：

会话存档：动手前执行 /chat save before-refactor，AI 的完整上下文被存档；第二天 /chat resume before-refactor 恢复现场继续干，/chat list 查看所有存档。适合“改到一半下班”和“同一上下文反复问不同问题”的场景。

文件快照：在 ~/.gemini/settings.json 里打开：

{
  "checkpointing": { "enabled": true }
}

之后 AI 每次动你的文件前都会自动打快照，改砸了执行 /restore 一键回到改动前——不用手工翻 git stash，也不用担心未提交的实验性改动被污染。

绝活六：挂载 MCP，把外部世界接进来

Gemini CLI 是完整的 MCP（Model Context Protocol）客户端，能像 Claude Code 一样挂外部工具。操作步骤：

gemini mcp add fetch -- npx -y mcp-server-fetch

会话内执行 /mcp list 确认加载，之后 AI 就能调用该工具抓取网页。数据库、设计稿、内部 API 都可以通过对应 MCP server 接入；持久化配置写进 settings.json 的 mcpServers 字段即可（具体参数名以官方文档为准）。适用场景：想让 AI 直接查数据库、调内部接口的运维和后端。海外 MCP 生态已经长出几百个 server，Gemini CLI 是免费侧接入成本最低的入口之一。

绝活七：无头模式进 CI，把 Gemini 塞进流水线

-p 参数让 Gemini CLI 脱离交互界面单发指令，配合管道就是一行式生产力：

git diff --staged | gemini -p "为这次改动写一条符合 Conventional Commits 的提交信息"

加上 --output-format json 可以拿到结构化输出，直接给脚本消费。代码评审机器人、每日 changelog 生成、日志异常摘要，都能以 cron + 一行命令的方式跑起来——而且是免费额度覆盖的范围（额度规则以官方文档为准）。/stats 命令可随时查看当前会话的 token 消耗，/auth 可在 Google 账号、Gemini API Key、Vertex AI 三种认证间切换，团队规模化使用时再迁到 Vertex 计费。

flowchart TD
    A["开工：全局GEMINI.md自动生效"] --> B["gemini进入项目"]
    B --> C{"今天干什么"}
    C -->|重构代码| D["/chat save存档再动手"]
    C -->|排查报错| E["提示词里注入!{git log}输出"]
    C -->|读长文档| F["@目录和@PDF直接引用"]
    D --> G["改动不满意"]
    G -->|/restore一键回滚| D
    E --> H["一轮定位根因修复"]
    F --> I["生成对照实现"]
    H --> J["/stats看消耗收工"]
    I --> J

信息差总结

你以为的	实际情况
终端 AI 都要 20 美元/月订阅	Gemini CLI 个人 Google 账号免费，发布时公布每天 1000 次请求额度
AI 记性差，规矩每次重讲	GEMINI.md 三层记忆，写一次全局自动生效
提示词只能存在备忘录里	TOML 自定义命令，可入库分享给全团队
AI 改坏了只能手工 git 补救	checkpointing + /restore，改动前自动快照
它只是个聊天框	MCP 挂载 + shell 注入 + 无头模式，是可编程的 Agent

与国内工具怎么选

国内主流方案（通义灵码、文心快码、腾讯 CodeBuddy）以 IDE 插件形态为主，强项是补全体验和中文场景适配，日常写码延续性好；Gemini CLI 的差异化在终端 Agent 能力——自主执行 shell、读写文件、挂 MCP、进 CI，且免费额度远高于国内工具的免费档。务实的组合拳：IDE 里留国内插件做补全，终端里跑 Gemini CLI 做跨文件重构和自动化，两不耽误。一个必要的提醒：Gemini CLI 会把代码上下文发送至 Google 服务端处理，涉密与合规敏感项目务必走本地模型或内部部署方案。

行动指南

今晚就能做：npm install -g @google/gemini-cli，进主力项目跑 /init 生成 GEMINI.md，再花 10 分钟手工补上你的团队规矩；
本周内做：挑一个每天重复三次以上的提示词（code review、写单测、查日志），做成 TOML 斜杠命令，并打开 checkpointing；
本月内做：试一条 gemini -p 管道命令挂进 git hook 或 CI，让免费额度替你值夜班。

参考来源

Gemini CLI 开源仓库（GitHub）：https://github.com/google-gemini/gemini-cli
官方文档站（CLI 使用与配置）：https://google-gemini.github.io/gemini-cli/docs/
Google 官方发布博客《Introducing Gemini CLI》：https://blog.google/technology/developers/introducing-gemini-cli-open-source-ai-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 等场景全覆盖。

51学通信知识星球海报-扫码加入