> 一句话信息差：海外开发者用 `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 次的额度（具体数字以官方最新文档为准）。 **操作步骤：** ```bash # 安装（任选其一） 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` 作为常驻上下文，并且**支持层级**：家目录一份（全局偏好）+ 项目目录一份（项目约定）叠加生效。 **操作步骤：** ```markdown # 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` 交互式添加）： ```json { "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 描述）可以固化成自己的 `/` 命令，团队还能共享。 **操作步骤：** ```bash 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。 **操作步骤：** ```bash # 给一堆日志生成摘要报告 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 个暗门串成一条"从白嫖到自动化"的进阶路径，你可以按阶段逐层解锁： ```mermaid flowchart LR A["第0层
地基"]:::t --> B["第1层
日常提效"] B --> C["第2层
团队复用"] C --> D["第3层
自动化与Agent"] A1["暗门1
登录激活免费层"] -.-> A B1["暗门2 @引用
暗门3 !shell
暗门4 GEMINI.md"] -.-> B C1["暗门7 自定义命令
暗门5 会话存档"] -.-> C D1["暗门6 MCP外挂
暗门8 -p管道/CI"] -.-> D classDef t fill:#e8f0fe,stroke:#1a73e8,stroke-width:2px,color:#1a73e8; ``` 多数人卡在第 0 层（以为只能聊天），少数人摸到第 1 层（会用 `@` 和 `!`），能走到第 3 层的凤毛麟角——而第 3 层才是真正省人月的地方。 ## 信息差总结：你知道的 vs 别人不知道的 | 维度 | 大多数国内开发者的认知 | 真正的暗门 | |---|---|---| | 入口 | Gemini 只能网页版聊天，要排队 | CLI 登录即送旗舰模型免费层，两条配额管道可切换 | | 用法 | 复制代码到对话框 | `@` 引用文件/目录，`!` 原地跑 shell | | 上下文 | 每次重打背景 | `GEMINI.md` 层级记忆 + `/chat` 会话存档 | | 能力边界 | 只是个聊天助手 | MCP 接数据库/浏览器，`/tools` 自动执行 | | 复用 | 手动重写 prompt | 自定义斜杠命令固化、随仓库共享 | | 部署形态 | 只能交互式用 | `-p` 管道模式进 CI，零成本批处理 | ## 行动指南：今晚就能做的三件事 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 等场景全覆盖。