一句话信息差:Gemini CLI 每天免费 1000 次、顶着 Gemini 3 的脑子、GitHub 上 106k star——但九成中国开发者只拿它当个"免费聊天框"。真正值钱的是 8 个几乎没人提的隐藏开关:能让 AI 改崩的代码一键回滚、能用 API Key 自动开 token 缓存省钱、能塞进 cron 当免费自动化脚本。今天一次性扒开。
如果你对 Gemini CLI 的印象还停留在"Google 出的免费命令行玩具",那先刷新一下数据:
google-gemini/gemini-cli 仓库 106k star、14.2k fork,截至发稿最新版是 0.51.0-nightly(2026-06-25),主分支几乎每天都有提交,迭代极快。第一帖是事故,第二帖是补救。这两条加起来,恰好点出本文的核心信息差——大多数翻车,不是因为工具不行,是因为没开那几个保命+省钱+自动化的暗开关。下面 8 个,按"先保命、再省钱、最后开挂"的顺序拆。
这是最该第一个打开、却 90% 人不知道的开关。
Gemini CLI 有个 Checkpointing(检查点) 机制:每次 AI 要动你的文件前,它会在一个影子 Git 仓库里自动存一份快照(位于 ~/.gemini/history/<项目哈希>),完整记录"文件状态 + 对话历史 + 即将执行的工具调用",完全不干扰你自己的 git 仓库。出事了,一条 /restore 命令把文件和对话一起拉回改之前。
但关键坑来了:这个功能默认关闭(且 --checkpointing 这个命令行 flag 在 0.11.0 版本就被移除了,只能改配置)。想用必须手动开。
操作步骤:打开 ~/.gemini/settings.json,写入:
{
"general": {
"checkpointing": { "enabled": true }
}
}
预期效果:之后 AI 每改一次文件就有快照,/restore 列出所有检查点(文件名形如 2026-06-22T10-00-00_000Z-主文件.txt-write_file),/restore <检查点名> 直接时光倒流。
适用场景:所有让 AI 大规模改代码的场景。HN 那个"AI 删我文件"的事主,要是早开这个,一条命令就救回来了。这个暗门值整个订阅费。
/rewind和 /restore 配套的还有个更快的手感——双击 Esc,唤出 /rewind。
区别在于:/restore 是"回到某次改文件之前",而 /rewind 是在对话历史里逐步后退,并且让你选择回退力度:
适用场景:AI 跑偏了一两步,你不想从头来,只想撤掉最近这一两次"自由发挥"。双击 Esc 比敲命令快得多,这是 vim 党和老命令行用户才会发现的手感差。
大多数人图省事,直接选"Sign in with Google"(OAuth 登录)。但官方 token-caching.md 文档白纸黑字写着一条认知差:
Token caching 不可用于 OAuth 用户(Google 个人/企业账号)——Code Assist API 目前不支持缓存内容创建。Token caching 仅对 API Key(Gemini API key)和 Vertex AI 用户可用。
什么意思?同样一段系统提示和上下文反复出现时,API Key 登录会把这部分缓存复用,按更低的成本计费;而 OAuth 登录没有这个优化。对免费党来说,这直接关系到你 1000 次/天的额度能撑多久。
操作步骤:
# 去 https://aistudio.google.com/apikey 拿 key
export GEMINI_API_KEY="你的KEY"
gemini
然后跑 /stats,输出里会专门显示 cached token(已缓存 token) 省了多少。API Key 模式同样送 1000 次/天(Gemini 3,flash + pro 混合)。
预期效果:长上下文、重复系统提示的场景下,有效 token 消耗明显下降。同一台机器,换个登录方式就开始省钱。
-p 无头模式,把它当免费 cron 脚本这是"别人拿它写脚本、你拿它聊天"的方法差。
加一个 -p(或 --prompt)flag,Gemini CLI 就进入 headless(无头)非交互模式,直接吃 stdin、吐结构化输出,完美适合塞进 shell 脚本、cron 定时任务、CI 流水线。配合 --output-format json 拿到带 token 用量的 JSON:
# 例:每天凌晨让 AI 扫一遍日志写摘要
gemini -p "分析 /var/log/app.log 今天的 ERROR,写一份中文摘要" \
--output-format json > daily_report.json
进阶用法:
--prompt-interactive(-i):先跑一条 prompt,然后继续留在交互界面。@google-github-actions/run-gemini-cli),在 issue / PR 里 @gemini-cli 就能叫它干活的,HN 上相关帖 252 分。适用场景:日志摘要、定时生成周报、批量改文件、CI 里自动 review。每天 1000 次免费额度,跑定时脚本绰绰有余。这是把"聊天工具"变成"免费员工"的开关。
auto 模型路由 + 本地 Gemma 做决策很多人不知道 Gemini CLI 默认模型是 auto——它不是固定一个模型,而是根据任务自动路由,主模型失败时自动 fallback 到备用模型,全程不用你管。
更狠的是本地路由(实验性):用 gemini gemma setup 一键配置后,路由决策改由你本地跑的 Gemma 模型来做,不再把路由请求发给云端模型,"在保持相似延迟和质量的前提下,降低托管模型成本"。
模型选择的完整优先级链(记下来,排障时有用):
--model 命令行 flag(最高优先级,写死)GEMINI_MODEL 环境变量settings.json 里的 model.nameauto操作步骤:想固定省钱用小模型,export GEMINI_MODEL=gemini-3-pro-flash(具体别名以文档为准);想让 CLI 自己省,保持 auto 并 gemini gemma setup 开本地路由。
适用场景:在意成本和速度的长期使用。一条 setup 命令,路由费就地砍掉。
/compress 压上下文,/stats model 盯配额免费额度再香也会用爆,这两个命令是省 token 的日常开关。
/compress:把当前整个对话上下文替换成一份摘要。官方原话——"在保留高水平摘要的同时,节省后续任务用的 token"。长会话跑久了上下文膨胀,一刀压缩,立省后续每轮的输入成本。/stats(默认 /stats session)看会话级统计;/stats model 看 token 计数和配额信息,免费额度还剩多少一目了然;/stats tools 看哪个工具被调用最多——方便发现"AI 是不是在反复读文件烧 token"。适用场景:连续干几小时的复杂任务、接近 1000 次/天上限时。先 /stats model 看一眼,再决定要不要 /compress,这是高手的肌肉记忆。
@注入、!穿透、/vim——三个手感暗门这是命令行老炮才会念叨的三个小开关,但每个都省一次"退出 CLI 再回来"。
@<路径> 注入:@src/my_project/ 总结下这个目录的代码。它会读文件/目录内容塞进 prompt,而且默认 git-aware 过滤——node_modules/、dist/、.env、.git/ 这些被 git ignore 的文件自动排除。想改过滤行为去 context.fileFiltering 设置。!<命令> shell 穿透:!git status 直接在 CLI 里跑 shell,输出返回后继续聊,不用退出。单独打个 ! 还能切换"shell 模式"。注意:穿透命令的权限和你直接在终端敲一样,沙箱模式下要小心。顺带,穿透执行时子进程会带上 GEMINI_CLI=1 环境变量,你的脚本可以靠它检测"是不是被 Gemini 调用"。/vim:开 vim 模式,NORMAL/INSERT 双模式,支持 dd、cw、3h 这种计数前缀,状态栏显示 [NORMAL]/[INSERT],偏好存进 settings.json。vim 党狂喜。适用场景:天天泡在 CLI 里的人,这三个开关能让你的手不离开键盘。
/skills、/agents、--worktree 三工地并行最后是新版三个高阶开关,适合把单机当团队用。
/skills(Agent Skills):按需加载的"专业技能包"。/skills list 看全部、/skills enable <名字> 启用、/skills reload 重扫。也可命令行 gemini skills enable --all。这是 Gemini CLI 向 Claude Code skills 体系靠拢的新基建(仓库里 2026-05 还专门加了 agent-tui / tui-tester skills)。/agents(子代理):管理本地和远程子代理,/agents list、/agents enable/disable <名>、/agents config <名> 还能调子代理的 model、temperature、执行上限——相当于在 CLI 里编排一支小队。--worktree(-w)多工地:gemini --worktree 直接在一个新 git worktree 里开工,一条命令开一个隔离工地,多个并行不互相踩。需要先在 settings.json 开 experimental.worktrees: true。配合 --approval-mode(default/auto_edit/yolo/plan 四档,老 --yolo 已废弃)控制自主权。适用场景:同时推进多个功能分支、让子代理分头查资料。一台机器跑出三人小组的并行度。
flowchart TD
A[打开 Gemini CLI] --> B{你的目标?}
B -->|保命/防翻车| C[暗门一: 开 checkpointing<br/>settings.json 里 enabled:true]
B -->|改了一半想撤| D[暗门二: 双击 Esc 唤 /rewind]
B -->|想省钱/省 token| E{哪种登录?}
E -->|OAuth 谷歌账号| F[暗门三: 换 API Key 登录<br/>自动开 token 缓存]
E -->|已在 API Key| G[暗门五: gemini gemma setup<br/>本地路由 + auto]
B -->|长会话烧 token| H[暗门六: /compress 压缩<br/>/stats model 盯配额]
B -->|想当自动化脚本| I[暗门四: -p 无头模式<br/>塞 cron / GitHub Action]
B -->|多任务并行| J[暗门八: --worktree + /agents]
C & D --> K[/restore 一键回滚到改文件前/]
F & G & H --> L[日常省 token]
I & J --> M[方法差: 别人当员工用]
| 维度 | 你以为的 Gemini CLI | 别人知道的 Gemini CLI |
|---|---|---|
| 文件安全 | AI 改崩了就完蛋 | 开 checkpointing,/restore 一键回滚(暗门一) |
| 登录方式 | 谷歌账号一键登录最省事 | API Key 才有 token 缓存,更省额度(暗门三) |
| 用法 | 交互式聊天框 | -p 无头模式塞 cron / CI,免费自动化(暗门四) |
| 成本 | 免费就够了 | auto 路由 + 本地 Gemma 决策再砍一刀(暗门五) |
| 上下文 | 越聊越慢越贵 | /compress 压摘要、/stats 盯配额(暗门六) |
| 多任务 | 一次一个活 | --worktree + /agents 并行多工地(暗门八) |
npm install -g @google/gemini-cli@latest(或 brew install gemini-cli),确认 /about 显示 0.50+。~/.gemini/settings.json,写入暗门一的 checkpointing 配置。这是不可逆操作前的安全网。aistudio.google.com/apikey 拿 key,export GEMINI_API_KEY=... 后 gemini 启动,跑 /stats 看缓存生效。-p ... --output-format json 写个真实的小任务(比如日志摘要),验证退出码。gemini gemma setup,长期用再省一笔。/stats model 看配额,膨胀时 /compress,改崩了 /restore 或双击 Esc。一句话:Gemini CLI 的免费额度已经是同档位最慷慨的,但这 8 个暗门才是把它从"聊天框"变成"免费员工+保命工具+省钱机器"的真正钥匙。开一个赚一个。
参考来源(均为可点击一手链接):
/restore、/rewind、/compress、/stats、/skills 等):https://github.com/google-gemini/gemini-cli/blob/main/docs/reference/commands.md本文由「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 等场景全覆盖。
