一句话信息差：海外开发者用 gemini 一条命令、登录 Google 账号，就能白嫖旗舰模型每天上千次请求——而国内绝大多数人只知道去网页版聊天框排队。

导语：被严重低估的"免费旗舰模型入口"

2026 年 6 月，国内技术圈对 Claude Code、Cursor 这类付费编码工具已经卷到熟透，却几乎没人认真聊 Google Gemini CLI。这个 2025 年中开源、装在终端里的工具，藏着国内开发者最容易错过的两个信息差：一是免费层极其慷慨（个人账号登录即送旗舰模型的日常配额，远不是网页版那种限流能比的）；二是它天生支持 MCP、脚本化、自定义命令，是个能塞进 CI/CD 管道的"工序"而非"聊天框"。

很多国内朋友对 Gemini 的认知还停在"网页版要排队、API 要绑卡"。但 CLI 这条入口走的是另一套配额体系，而且完全开源、可换模型、可接本地代理。下面拆 8 个 90% 用户没摸过的暗门，每一个都附操作步骤和适用场景。

暗门 1：登录 Google 账号，激活"另一套"免费配额

这是整个工具最大的信息差，也是其余 7 个暗门的地基。

很多人装完 gemini 第一反应是去 Google AI Studio 申请一个 GEMINI_API_KEY 填进去。这条路走的是 API 配额（按 token 计费，有免费层但有上限）。但如果你改用个人 Google 账号 OAuth 登录，走的是 CLI 专属的免费层——发布之初官方 README 白纸黑字给了个人账号每天 1000 次请求、每分钟 60 次的额度（具体数字以官方最新文档为准）。

操作步骤：

# 安装（任选其一）
npm install -g @google/gemini-cli
# 或 brew install gemini-cli

gemini            # 启动
# 进入后执行斜杠命令
/auth login       # 选 "Login with Google"，浏览器走 OAuth

• 预期效果：无需绑卡，直接以个人账号的免费层调用旗舰 Gemini 模型。
• 适用场景：个人开发者日常编码、读代码、写脚本、做原型验证。
• 进阶暗门：API key 路径和 OAuth 路径配额互不重叠。你可以把 GEMINI_API_KEY 设为环境变量走 API 免费层，额度吃完后 /auth login 切到账号免费层续命，等于两条免费管道。

暗门 2：@ 万物引用——文件、目录、甚至远程一把梭

国内写 prompt 还在"把代码粘贴到对话框"。Gemini CLI 里一个 @ 符号就能引用本地文件与目录，还会弹文件选择器自动补全。

操作步骤：

> 帮我重构 @src/auth/ 下的登录逻辑，保持 @src/utils/jwt.ts 的接口不变

• @文件路径 引用单文件；@目录/ 引用整个目录（CLI 会自动汇总结构）。
• 输入 @ 后按 Tab，弹出当前目录的可选文件列表。
• 预期效果：上下文精准注入，不再"粘贴一大坨还截断了"。
• 适用场景：大型代码库局部修改、多文件协同重构。

暗门 3：! 原地 shell——把命令输出当场喂回模型

很多人不知道 Gemini CLI 内置了一个 shell 通道。在提示符输入 ! 开头的命令，直接在 CLI 内执行，输出立即可被后续对话引用。

操作步骤：

> !git diff --stat
（CLI 跑出 diff 摘要）
> 根据上面这个 diff，帮我写一段 commit message

• 预期效果：不用退出 CLI、不用复制粘贴，命令的 stdout 自动进入上下文。
• 适用场景：想用 !docker logs、!kubectl describe、!grep -r 的真实输出来驱动模型分析时，效率拉满。
• 进阶：开启 Yolo/auto-approve 后，模型还能自己决定跑哪条 shell 命令（见暗门 6 的工具权限）。

暗门 4：GEMINI.md——给项目留一份"说明书"当长期记忆

类似 Claude 的 CLAUDE.md，Gemini CLI 会自动读取项目根目录的 GEMINI.md 作为常驻上下文，并且支持层级：家目录一份（全局偏好）+ 项目目录一份（项目约定）叠加生效。

操作步骤：

# GEMINI.md（放在仓库根目录）
## 项目约定
- 后端用 Go 1.22，禁止引入新框架
- 所有 HTTP 接口必须返回统一错误码结构
- 测试用 testify，提交前先 `make test`
## 常用路径
- 核心服务：cmd/api/
- 配置：configs/

• /memory 命令可查看当前实际加载了哪些记忆文件。
• 预期效果：团队新成员拉下仓库，Gemini CLI 自动"读懂"项目规范，不用每次重复说明。
• 适用场景：团队协作、多仓库维护、规范一致性强的工程。

暗门 5：/chat save 与 /chat resume——对话存档与复活

终端会话关了就没了？Gemini CLI 支持把整段对话序列化到本地，随时复活，还能跨机器（记忆文件跟着仓库走）。

操作步骤：

/chat save feature-auth-refactor    # 存档当前对话
/chat list                          # 看有哪些存档
/chat resume feature-auth-refactor  # 接着上次的上下文继续

• 预期效果：复杂任务分多天推进、上下文不丢；不同任务各自一条存档，互不污染。
• 适用场景：长周期重构、需要中断后恢复的调研任务。

暗门 6：/mcp + mcp.json——给 CLI 装"外挂器官"

这是 Gemini CLI 真正区别于"高级聊天框"的地方。它原生支持 MCP（Model Context Protocol），一条配置就能让模型直接连数据库、操作浏览器、调内部 API。

操作步骤：

在项目根目录建 mcp.json（或用 /mcp add 交互式添加）：

{
  "mcpServers": {
    "db": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": { "DATABASE_URL": "postgresql://..." }
    }
  }
}

• /mcp 命令查看已加载的 MCP 服务器与工具状态。
• 预期效果：模型可以"自己查表、自己读写文件、自己跑命令"，配合 /tools 调整哪些工具允许自动执行（auto-approve / Yolo 模式），实现半自主 agent。
• 适用场景：本地运维、数据探索、把 CLI 升级成轻量 agent。

暗门 7：自定义斜杠命令——把高频 prompt 存成一键指令

重复写的 prompt（代码审查、生成测试、出 PR 描述）可以固化成自己的 / 命令，团队还能共享。

操作步骤：

mkdir -p ~/.gemini/commands
cat > ~/.gemini/commands/review.toml <<'EOF'
description = "代码审查：聚焦安全与边界"
prompt = "对当前 git diff 做审查，重点关注：1)注入风险 2)边界条件 3)错误处理。输出分级清单。"
EOF

之后在 CLI 里直接 /review 即触发。放 ~/.gemini/commands/ 是全局命令，放仓库 .gemini/commands/ 是项目级、可随 git 共享。

• 预期效果：团队统一的 prompt 规范沉淀成命令，新人零成本复用。
• 适用场景：标准化代码评审、测试生成、文档产出流程。

暗门 8：-p 非交互模式——把 CLI 变成管道里的一道工序

这大概是国内最少人用的暗门。gemini -p "..." 让 CLI 一次性执行并输出，可接管道、可写进脚本、可进 CI。

操作步骤：

# 给一堆日志生成摘要报告
cat deploy.log | gemini -p "总结这次部署失败的根本原因，输出三行"

# 批量给 Python 文件补单测
for f in src/*.py; do
  gemini -p "为 $(cat $f) 补 pytest 单测" > "${f%.py}_test.py"
done

# 接进 CI：PR 里自动生成变更说明
gemini -p "依据这段 diff 写 release notes: $(git diff main...HEAD)"

• 预期效果：CLI 从"交互工具"变成"可编排的命令行组件"，能和 grep/jq/sed 等自由组合。
• 适用场景：批处理、CI/CD 自动化、日志/告警的 AI 后处理。

配合暗门 1 的免费层，这些自动化跑起来几乎零成本——这正是它对国内开发者的核心价值。

进阶路径：8 个暗门不是孤立的

下面这张图把 8 个暗门串成一条"从白嫖到自动化"的进阶路径，你可以按阶段逐层解锁：

flowchart LR
    A["第0层<br/>地基"]:::t --> B["第1层<br/>日常提效"]
    B --> C["第2层<br/>团队复用"]
    C --> D["第3层<br/>自动化与Agent"]

    A1["暗门1<br/>登录激活免费层"] -.-> A
    B1["暗门2 @引用<br/>暗门3 !shell<br/>暗门4 GEMINI.md"] -.-> B
    C1["暗门7 自定义命令<br/>暗门5 会话存档"] -.-> C
    D1["暗门6 MCP外挂<br/>暗门8 -p管道/CI"] -.-> D

    classDef t fill:#e8f0fe,stroke:#1a73e8,stroke-width:2px,color:#1a73e8;

多数人卡在第 0 层（以为只能聊天），少数人摸到第 1 层（会用 @ 和 !），能走到第 3 层的凤毛麟角——而第 3 层才是真正省人月的地方。

信息差总结：你知道的 vs 别人不知道的

行动指南：今晚就能做的三件事

1. 先吃免费层：npm i -g @google/gemini-cli → gemini → /auth login 登录 Google 账号，先用 gemini -p 跑一次日志摘要，感受零成本自动化。
2. 建项目记忆：在主力仓库根目录写一份 GEMINI.md，把编码规范和常用路径塞进去，用 /memory 验证加载。
3. 固化一个高频命令：把"代码审查"或"生成 commit message"存成 ~/.gemini/commands/xxx.toml，团队 commit 进 .gemini/commands/ 共享。

对国内用户的一点务实提醒：Gemini 服务需自备稳定网络出口；CLI 本身开源、配置透明，可配合代理使用。模型可经 /model 在旗舰（重任务）与 Flash（轻任务省额度）间切换。

参考来源

• Gemini CLI 官方仓库（README 含免费层说明、安装与配置）：https://github.com/google-gemini/gemini-cli
• Gemini CLI 文档目录（命令、MCP、GEMINI.md、脚本化等）：https://github.com/google-gemini/gemini-cli/tree/main/docs
• Google AI Studio（申请 GEMINI_API_KEY、查看 API 免费层）：https://aistudio.google.com/
• MCP 官方协议与服务器列表（暗门 6 扩展能力来源）：https://modelcontextprotocol.io/
• Gemini API 模型与定价（/model 切换、配额参考）：https://ai.google.dev/pricing

说明：本轮联网检索与抓取接口本周配额已耗尽（预计 2026-07-18 重置），以上技巧基于 Gemini CLI 公开功能特性整理，涉及免费额度等具体数字请以官方最新文档为准。

本文由「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 等场景全覆盖。