Appearance
本页是 Gemini CLI 的一站式命令速查表。覆盖所有启动参数（--model、--approval-mode、--sandbox 等）、REPL 内部命令（/memory、/mcp、/settings）、MCP 服务器配置命令和模型别名（pro / flash / flash-lite）。
Gemini CLI 命令速查表
CLI 启动命令
| 命令 | 描述 | 示例 |
|---|---|---|
gemini | 进入交互式 REPL | gemini |
gemini -p "query" | 非交互模式执行后退出 | gemini -p "总结 README.md" |
gemini "query" | 执行 query 并继续交互 | gemini "解释这个项目" |
cat file | gemini | 管道输入内容 | cat logs.txt | gemini |
gemini -i "query" | 执行并继续交互模式 | gemini -i "这个项目是做什么的？" |
gemini -r "latest" | 恢复最近的会话 | gemini -r "latest" |
gemini -r "latest" "query" | 继续会话并追加提问 | gemini -r "latest" "检查类型错误" |
gemini -r "<session-id>" | 通过 ID 恢复会话 | gemini -r "abc123" "继续刚才的任务" |
gemini update | 更新到最新版本 | gemini update |
CLI 参数详解
| 参数 | 缩写 | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
--debug | -d | boolean | false | 启用详细调试日志 |
--version | -v | — | — | 显示版本号并退出 |
--model | -m | string | auto | 指定模型（见下方模型列表） |
--prompt | -p | string | — | 提示文本（强制非交互模式） |
--prompt-interactive | -i | string | — | 执行提示后继续交互 |
--sandbox | -s | boolean | false | 在沙箱环境中运行（更安全） |
--approval-mode | — | string | default | 工具执行审批模式（见下方说明） |
--yolo | -y | boolean | false | ⚠️ 已废弃，改用 --approval-mode=yolo |
--resume | -r | string | — | 恢复会话（"latest" 或 session ID） |
--list-sessions | — | boolean | — | 列出所有可用会话并退出 |
--output-format | -o | string | text | 输出格式：text / json / stream-json |
--worktree | -w | string | — | 在新 git worktree 中启动（需开启实验功能） |
--skip-trust | — | boolean | false | 跳过本次工作区信任确认 |
--include-directories | — | array | — | 额外包含的工作区目录（逗号分隔） |
--screen-reader | — | boolean | — | 启用屏幕阅读器无障碍模式 |
审批模式（--approval-mode）
| 模式 | 描述 |
|---|---|
default | 默认模式：执行工具前询问确认 |
auto_edit | 自动批准编辑类操作，其他操作仍询问 |
plan | 只读规划模式，不执行任何写操作 |
yolo | ⚠️ 自动批准所有操作（危险，谨慎使用） |
交互式 REPL 命令
在 gemini 交互界面中可用的斜杠命令：
| 命令 | 描述 |
|---|---|
/help | 显示帮助信息 |
/settings | 打开设置面板 |
/memory show | 显示当前加载的所有 GEMINI.md 内容 |
/memory reload | 重新扫描并加载所有 GEMINI.md |
/memory add <text> | 追加文本到全局 ~/.gemini/GEMINI.md |
/mcp reload | 重启并重新加载 MCP 服务器 |
/skills reload | 从磁盘重新加载 Skills |
/agents reload | 重新加载 Agent 注册表 |
/commands reload | 重新加载自定义斜杠命令 |
/extensions reload | 重新加载所有 Extensions |
/clear | 清空当前对话上下文 |
/quit | 退出交互会话 |
模型选择（--model）
使用 -m 参数指定模型：
| 别名 | 对应模型 | 适用场景 |
|---|---|---|
auto | 自动选择（默认） | 大部分任务推荐 |
pro | gemini-2.5-pro | 复杂推理、长代码分析 |
flash | gemini-2.5-flash | 快速、日常任务（速度和质量均衡） |
flash-lite | gemini-2.5-flash-lite | 最快速度，简单任务 |
bash
# 指定使用 flash 模型（速度更快）
gemini -m flash -p "快速帮我改这个函数的名字"MCP 服务器管理（gemini mcp）
| 命令 | 描述 |
|---|---|
gemini mcp add <name> <command> | 添加 stdio 类型 MCP 服务器 |
gemini mcp add <name> <url> --transport http | 添加 HTTP 类型 MCP 服务器 |
gemini mcp add <name> <cmd> --env KEY=val | 添加并注入环境变量 |
gemini mcp add <name> <cmd> --scope user | 以用户级别添加（所有项目可用） |
gemini mcp remove <name> | 删除 MCP 服务器 |
gemini mcp list | 列出所有已配置的 MCP 服务器 |
示例：
bash
# 添加 GitHub MCP
gemini mcp add github npx -y @modelcontextprotocol/server-github --env GITHUB_TOKEN=ghp_xxx
# 添加 Postgres MCP
gemini mcp add postgres npx -y @modelcontextprotocol/server-postgres --env DATABASE_URL=postgres://...Extensions 管理（gemini extensions）
| 命令 | 描述 |
|---|---|
gemini extensions install <source> | 从 Git URL 或本地路径安装 |
gemini extensions uninstall <name> | 卸载 Extension |
gemini extensions list | 列出已安装的 Extensions |
gemini extensions update <name> | 更新指定 Extension |
gemini extensions update --all | 更新所有 Extensions |
gemini extensions enable/disable <name> | 启用/禁用 Extension |
gemini extensions new <path> | 从模板创建新 Extension |
常见问题
Q: --yolo 和 auto_edit 有什么区别？
A: auto_edit 只自动批准文件编辑类工具（read/write），对 Shell 命令仍会询问确认。yolo 是完全自动批准所有操作，包括执行任意 Shell 命令，使用前请确认操作安全性。
Q: 如何查看当前会话 ID 以便后续恢复？
A: 用 gemini --list-sessions 列出所有可用会话，每条记录包含 session ID 和时间戳。
Q: stream-json 输出格式有什么用？
A: 适合将 Gemini CLI 接入管道脚本——每次模型输出一个 token 就实时输出一条 JSON 行，适合流式处理场景。