Gemini CLI 命令速查表 - Google 终端 AI 代理全参数
Gemini CLI 终端 AI 代理命令都在这里了，从安装认证到无头执行、从批准模式到 MCP/扩展，按场景分类整理，复制即用。
返回 AI 命令行安装与认证 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/工具权限）
💡 提示
- 个人 Google 账号免费额度 1000 次/天，且开源可 fork，是长上下文（2M）和自托管场景的默认首选。
- 无头自动化用 `gemini -p -o json`，配合 --approval-mode=yolo（比已弃用的 -y 更规范）做无人值守任务。
- 把构建/测试命令写进 GEMINI.md，Gemini 每次会话自动加载，比反复提示更稳；用 .geminiignore 屏蔽 .env 等。
- 长任务跨 2M 上限时用 /compress 续命，用 /save + /restore 跨天保留会话。
由 LaoHand 维护
公开更新于 2026年8月5日，内容持续校对官方文档。