Gemini CLI 命令速查表 - Google 终端 AI 代理全参数
Gemini CLI 是 Google 开源的终端 AI 代理（Apache 2.0），面向需要超长上下文、希望让 AI 在本地仓库自主改代码并接自有模型的开发者，2M token 上下文尤其适合整仓库级别的重构与分析任务。与其它编码代理相比，它的长上下文、可 fork 自托管以及 GEMINI.md 项目记忆是突出优势；本表帮你掌握安装认证、无头自动化（-p -o json）与 MCP/扩展接入。
典型使用场景
Gemini CLI 最值得派上用场的是超长上下文任务：2M token 窗口让它可以一次读进整仓库的源码/文档做跨文件重构、架构分析或大规模批量修改，这是大多数对话式编码工具做不到的。开发者在日常编码时用交互式终端让它改代码、跑测试，遇到长会话或整仓任务就在 GEMINI.md 里写清构建/测试命令，让每次会话自动加载团队约定；无头场景则用 -p -o json 交给脚本或 CI 做一次性审查、文档生成。它还支持接入自有模型（包括本地与自定义端点）与 MCP/扩展，适合想掌握模型调用、不想被锁定在单一厂商云端的团队。
安装与认证 6
npm install -g @google/gemini-cli通过 npm 全局安装（需 Node 20+）
gemini --version验证安装并显示版本
gemini首次运行触发浏览器 OAuth 登录
gemini --auth-method=api-key切换为 API key 认证方式
export GEMINI_API_KEY="your-key"设置 API key 环境变量（服务器/CI 用）
export GOOGLE_GENAI_USE_VERTEXAI=true企业/Vertex AI 认证方式
运行模式 8
gemini启动交互式 TUI 代理（默认）
gemini "重构 user-auth 模块"带初始提示启动 TUI
gemini -p "解释这个函数"无头模式：打印后退出（--prompt）
gemini -i "先实现缓存"先播种提示再保持交互（--prompt-interactive）
gemini mcp管理 MCP 服务器
gemini extensions管理 Gemini CLI 扩展
gemini skills管理 agent skills（安装/链接/列举）
gemini gemma本地 Gemma 模型路由（setup/start/stop/status）
全局标志位 15
gemini -m gemini-2.5-pro "任务"本次调用覆盖模型（-m/--model）
gemini -y "重构整模块"自动批准所有操作（--yolo，已建议改用 --approval-mode=yolo）
gemini --approval-mode plan "探索架构"只读规划模式（default/auto_edit/yolo/plan）
gemini -w feat/login在独立 git worktree 中运行（--worktree）
gemini -s在配置沙箱（Docker/Podman）中执行工具调用
gemini --skip-trust本次会话信任当前工作区
gemini --checkpointing启用逐次编辑快照，可用 /restore 恢复
gemini -r latest恢复上一个会话（--resume，latest 或索引）
gemini --list-sessions列出当前项目的会话后退出
gemini --delete-session 2按索引删除会话
gemini --include-directories ../backend,../frontend把额外目录加入工作区映射
gemini -o json "任务"输出格式 text/json/stream-json（脚本用 json）
gemini -e context7限制本会话加载的扩展集合（--extensions）
gemini -l列出已安装扩展后退出（--list-extensions）
gemini --debug输出详细调试日志（--debug/-d）
会话斜杠命令 14
/help列出所有可用命令
/model切换激活模型（Pro/Flash 等）
/context显示当前对话 token 用量
/compress总结对话释放上下文（可跨 2M 上限）
/clear重置对话
/save把会话保存为检查点
/restore恢复已保存的会话
/yolo跳过所有确认提示（慎用）
/mcp list列出已配置的 MCP 服务器
/tools列出所有可用工具
/init为项目生成 GEMINI.md
/memory list查看已加载的上下文文件
/memory refresh重新加载 GEMINI.md（无需重启）
/quit退出
MCP 与扩展 7
gemini mcp add <name> <url>添加 MCP 服务器
gemini mcp remove <name>移除 MCP 服务器
gemini mcp list列出 MCP 服务器
gemini mcp enable <name>启用某 MCP 服务器
gemini mcp disable <name>禁用某 MCP 服务器
gemini extensions install <name>安装 Gemini CLI 扩展
gemini mcp add --url https://example.com/mcp添加 HTTP MCP 服务器
GEMINI.md 与配置 5
echo "构建: make build\n测试: go test ./..." > GEMINI.md在项目根写 GEMINI.md，每次会话自动加载
@./docs/architecture.md在提示词中用 @ 注入文件/目录内容
!git status在 Gemini 内用 ! 直接执行 shell 命令
echo ".env\nnode_modules/" > .geminiignore用 .geminiignore 让 agent 远离密钥与大目录
cat ~/.gemini/settings.json查看用户级配置（模型/MCP/工具权限）
命令示例
无头模式输出 JSON 供脚本解析
gemini -p -o json "对比当前代码与最近一次 tag 的 API 差异"-p 非交互即跑即退，-o json 再配 --save 可把结果落盘，是 CI 自动化的常用组合。
输出
（模型只输出结构化 JSON 供下游脚本消费，例如新增/删除的接口清单与风险提示）
一次性快速提问
gemini "帮我解释这个函数的递归逻辑"与 -p 相比，无参数的非交互调用同样即跑即退，无需进入 TUI。
输出
（直接在当前终端返回回答后退出，适合查文档片段与做单次决策）
初始化项目记忆文件
/init
echo "Build: make build\nTest: go test ./..." > GEMINI.md
/memory refreshGEMINI.md 每次会话自动加载，把项目约定沉淀其中可显著减少重复提示；敏感文件用 .geminiignore 排除。
输出
（/init 生成 GEMINI.md 骨架，补充构建/测试命令后 refresh 立刻生效，无需重启会话）
常见坑与注意事项
- 2M 长上下文一旦装进大量文件，首轮处理与响应时延会明显变长——把 GEMINI.md、.geminiignore 配置好，避免把 node_modules、日志等海量文件灌进上下文。
- -p 非交互调用即跑即退，默认没有人在批准文件修改与命令执行，需在配置里明确允许的范围，别默认放开所有写权限。
- GEMINI.md 里的约定会被模型每次自动遵守，改动它或项目依赖会改变后续行为；屏蔽敏感信息用 .geminiignore，别把 .env 之类的清进记忆文件。
- 用自定义模型端点时，第三方实现可能不支持全部原生能力（如工具调用、长上下文）；生产化前先在受控仓库验证行为一致性。
提示
- 个人 Google 账号免费额度 1000 次/天，且开源可 fork，是长上下文（2M）和自托管场景的默认首选。
- 无头自动化用 `gemini -p -o json`，配合 --approval-mode=yolo（比已弃用的 -y 更规范）做无人值守任务。
- 把构建/测试命令写进 GEMINI.md，Gemini 每次会话自动加载，比反复提示更稳；用 .geminiignore 屏蔽 .env 等。
- 长任务跨 2M 上限时用 /compress 续命，用 /save + /restore 跨天保留会话。
由 巧匠 维护
公开更新于 2026年8月5日，内容持续校对官方文档。