本页是 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 | 最快速度，简单任务 |
# 指定使用 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 服务器 |
示例：
# 添加 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 行，适合流式处理场景。