首页 › tips-tricks › Gemini CLI八大狠活，国内教程没讲透

Gemini CLI八大狠活，国内教程没讲透

国内终端AI工具圈，讨论度最高的永远是 Claude Code 和 Cursor，但很多人漏掉了一个摆在明面上的选项：谷歌去年开源的 Gemini CLI。这个装在终端里的开源 Agent（GitHub 仓库 google-gemini/gemini-cli，Apache 2.0 协议）最狠的不是功能，而是价格——用个人 Google 账号登录，官方公布的免费额度是每分钟 60 次请求、每天 1000 次请求，直接用 Gemini 2.5 Pro、100 万 token 上下文。对比 Claude Code 每月 20 美元起步、Cursor 按用量小心翼翼计算，这是目前主流终端 Agent 里最慷慨的免费档。

但绝大多数教程只教到 npm install 和第一句对话就结束了。这篇文章把海外社区里流通、国内还很少有人系统写过的 8 个进阶玩法一次讲完。每个都附操作步骤，今天装好就能用。

先说清楚它是什么

flowchart LR
    A[gemini 命令启动] --> B{加载分层记忆}
    B --> C[全局 ~/.gemini/GEMINI.md]
    B --> D[项目根目录 GEMINI.md]
    B --> E[子目录 GEMINI.md]
    C & D & E --> F[ReAct 循环<br/>读文件/改代码/跑Shell]
    F --> G{需要外部能力?}
    G -->|是| H[MCP 服务器 / Extensions]
    G -->|否| I[内置工具:<br/>grep/read/edit/shell]
    H --> F
    F --> J[Google Search 联网兜底]

一句话概括：它是装在终端里的 Agent，能读你的代码库、改文件、跑 Shell 命令，还能联网搜资料。和 Claude Code 的核心差异有三点：开源（可以自己审代码、改代码、提 PR）、免费额度大、和 Google 生态打通（Search 联网、后续可接 Vertex AI）。

狠活一：/init 一键生成项目记忆，而且是分层的

用 Claude Code 的同学都知道 CLAUDE.md，Gemini CLI 有对等的 GEMINI.md，但玩得比大部分人想象的更细——它是三层叠加的：

全局层：~/.gemini/GEMINI.md —— 写你的个人偏好，比如“回答用中文”“commit message 用 Conventional Commits”，对所有项目生效
项目层：仓库根目录的 GEMINI.md —— 写架构约定、构建命令、代码风格
子目录层：前端目录、后端目录各放一份，进去干活时自动加载

懒人做法：在项目根目录直接敲 /init，Gemini CLI 会扫描你的代码库，自动生成一份初版 GEMINI.md（技术栈、目录结构、常用命令都有）。生成后花两分钟手工修剪一下，效果立竿见影——它对“这个项目用 pnpm 不用 npm”这类约定的遵守度会明显提升。

临时补充记忆不用改文件：对话中直接 /memory add 记住：测试永远跑 make test-unit，立即生效。

狠活二：TOML 自定义斜杠命令，把重复劳动做成快捷键

这是被低估最狠的功能。在 ~/.gemini/commands/ 下建 TOML 文件，就能注册自己的斜杠命令。比如建 ~/.gemini/commands/review.toml：

description = "对当前 diff 做一次严格 Code Review"
prompt = """
请 review 我当前的改动，重点检查：
1. 安全漏洞（注入、越权、密钥泄露）
2. 错误处理是否完整
3. 是否偏离项目已有约定（参考 GEMINI.md）
输出按严重程度排序。
"""

以后每次敲 /review 就是一套完整流程。更妙的是支持命名空间：放进 ~/.gemini/commands/git/ 子目录的文件，会变成 /git:xxx。团队协作时把 commands/ 目录提交进仓库，全组的 slash 命令就统一了——这是把团队工程规范固化进 AI 交互的最轻方案。

狠活三：`!` 进 Shell、`@` 引文件，输入框是个万金油

两个前缀符号，把聊天框变成混合终端：

! 开头：直接执行 Shell 命令，不经过模型。比如 !git status、!pnpm test。先跑个命令看看结果，再让 AI 基于结果继续干活，不用切窗口
@ 开头：把文件或整个目录塞进上下文。@src/api/ 这个目录的接口风格总结一下，@README.md 按这个格式补个 CONTRIBUTING

组合拳示例：!cat package.json 看一眼依赖版本，紧接着 @src/ 帮我把所有用到 request 库的地方迁移到内置 fetch。这种“人机交替操作”的节奏，比一股脑把任务丢给 Agent 可控得多。

狠活四：/chat 存档，长会话不再一锤子买卖

长会话跑崩过的人都懂这个痛。Gemini CLI 内置会话快照：

/chat save fix-auth —— 给当前对话打标签存档
/chat list —— 列出所有存档
/chat resume fix-auth —— 回到那个时间点继续聊

实战建议：每次让 Agent 大规模重构前先 /chat save 一次。改废了直接 resume 回去重来，上下文原样保留，比 Ctrl+C 中断后救场体面得多。

狠活五：--checkpointing 文件时光机，AI 改崩代码一键回滚

比 /chat 更底层的一道保险。启动时加参数：

gemini --checkpointing

之后每次 Agent 改动文件前都会自动打快照，万一它把你的代码改出花来，敲 /restore 直接回滚到改动前的状态。~/.gemini/tmp/ 下会存快照文件。注意这和 git 不冲突——它救的是那些“还没 commit 就被改乱”的中间态，对不熟的新仓库尤其重要。

狠活六：沙箱模式，敢放心开 YOLO

Agent 自动批文件（--yolo 模式，跳过逐条确认）效率翻倍，但直接跑总觉得心里没底。Gemini CLI 官方给了沙箱：

gemini -s --yolo

-s 会把整个会话隔离起来跑——macOS 上用系统自带的 Seatbelt 沙箱策略，Linux 上用 Docker 容器。文件写入、网络访问都限制在隔离环境里，Agent 想删你的家目录也删不着。想长期开启，在 ~/.gemini/settings.json 里配 "sandbox": true 即可，不用每次敲参数。

狠活七：MCP + Extensions，把外部世界接进来

Gemini CLI 支持 MCP（Model Context Protocol）标准，在 ~/.gemini/settings.json 里配好 MCP 服务器后，数据库、浏览器、设计工具都能直接调用。更省事的路径是它的扩展机制：

gemini extensions list
gemini extensions install <github仓库链接>

扩展本质是打包好的 MCP 配置 + 上下文规则，官方维护着一个扩展列表（Google 官方博客 2025 年 9 月起陆续介绍过数据库、Flutter、Firebase 等扩展）。装完后在对话里用 @扩展名 直接唤起对应的提示词和工具。

一个实用对比：国内用惯了文心/通义插件的注意，MCP 是跨客户端的开放协议——你今天给 Gemini CLI 配的 MCP 服务器，明天换 Claude Code 或 Cline 也能接着用，这套资产不会锁死在单一工具里。

狠活八：非交互模式，把 1000 次/天免费额度跑成自动化流水线

这是把 Gemini CLI 从“聊天工具”变成“免费 API 网关”的玩法。-p 参数进入非交互模式：

# 批量给文档生成摘要
for f in docs/*.md; do
  gemini -p "把 @$f 翻译成英文，保留代码块" >> output.md
done

# 输出 JSON，供脚本消费
gemini -p "分析 @error.log 的报错根因" --output-format json

配合 CI/CD： nightly 任务自动审查昨天的新增代码、自动给 issue 打标签、自动生成 changelog——全部走免费额度。官方在发布时给出的数字是个人账号每天 1000 次请求、每分钟 60 次（注：免费额度政策谷歌保留调整权利，重度使用前以 /stats 命令显示的实时用量为准）。对话里随时敲 /stats 能看到本次会话的 token 消耗和缓存命中情况。

合规提醒：这个玩法适合个人自动化和内部工具，别拿它做对外商业服务的套壳后端——官方条款对转售和滥用有明确限制，别把免费额度玩成封号现场。

国内用户的三个现实问题

网络：登录和调用都需要能直连 Google 的网络环境，这是最硬的门槛
中文能力：Gemini 2.5 Pro 中文理解和输出完全够用，写中文文档、中文注释没有明显短板
和国内工具怎么选：通义灵码、Trae、CodeBuddy 胜在网络无忧和 IDE 集成；Gemini CLI 胜在开源、免费额度、MCP 生态。理性策略是双轨：日常 IDE 内补全用国内工具，终端里的重构/自动化/批处理任务给 Gemini CLI

信息差总结

维度	你以为的	实际情况
价格	又一个要订阅的 AI 工具	个人 Google 账号免费，官方发布时公布 1000 次/天
定位	简单的终端聊天壳	开源 Agent，支持 MCP/Extensions/沙箱/快照
记忆	每次对话从零开始	GEMINI.md 三层叠加 + /memory 动态注入
自动化	只能交互式使用	`-p` 非交互模式可接入脚本和 CI
安全	开 YOLO 等于裸奔	`-s` 沙箱模式（Seatbelt/Docker）官方支持
团队协作	配置各自为政	commands 目录提交仓库，全组共享 slash 命令

行动指南

今天：npm install -g @google/gemini-cli，用个人 Google 账号登录，跑 /init 生成你主力项目的 GEMINI.md
本周：把三个最高频的重复操作写成 TOML 命令（code review、commit message 生成、单测补全），存进 ~/.gemini/commands/
本月：挑一个 nightly 任务（依赖升级检查 / 文档同步）用 -p 模式接入 CI，用 /stats 观察一周额度消耗，验证免费档是否够用
顺手：把 commands/ 目录提交进团队仓库，下个迭代全组统一交互规范

参考来源

Gemini CLI 官方开源仓库：https://github.com/google-gemini/gemini-cli
Google 官方发布博客《Introducing Gemini CLI》：https://blog.google/technology/developers/introducing-gemini-cli-open-source-ai-agent/
官方文档（含 CLI 配置、自定义命令、扩展）：https://developers.google.com/gemini-code-assist/docs/gemini-cli
Gemini API 定价与额度说明：https://ai.google.dev/gemini-api/docs/pricing

注：本文基于官方发布时的公开资料整理，免费额度数字以官方最新政策为准；文中功能开关名称可在官方文档的 Settings 章节核对。

本文由「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学通信知识星球海报-扫码加入