
Gemini CLI 的命令主要分为三类：
1. **终端启动/CLI 参数**（shell 中直接运行 `gemini` + flags）
2. **常用全局 Flags**（适用于大多数模式）
3. **交互模式内的 Slash 命令**（进入 `gemini` 后输入 `/` 触发的内置指令）

### 1. 终端 CLI 命令与 Flags（gemini [flags]）

| 命令示例                        | 主要作用                                   | 典型用法示例                                      | 备注                  |
|--------------------------------|--------------------------------------------|---------------------------------------------------|-----------------------|
| `gemini`                       | 启动交互式会话（TUI / REPL）               | `gemini`                                          | 最常用入口            |
| `gemini "你的任务"`             | 带初始提示启动交互会话                     | `gemini "分析这个项目架构"`                       | 快速开始              |
| `gemini -p "查询"`             | 非交互式单次查询（pipe 友好，执行后退出）   | `cat log.txt \| gemini -p "总结错误"`              | 脚本/CI 常用          |
| `gemini -m gemini-3-pro`       | 指定模型启动                               | `gemini -m gemini-3-pro`                          | 支持 gemini-3 等      |
| `gemini --help`                | 显示完整帮助                               | `gemini --help`                                   | 查看所有 flags        |
| `gemini update` / `npm update` | 更新到最新版本                             | `npm install -g @google/gemini-cli@latest`        | 保持最新特性          |

**常用全局 Flags**（可加在 gemini 后）

| Flag                           | 缩写 | 作用                                          | 示例                                           |
|--------------------------------|------|-----------------------------------------------|------------------------------------------------|
| `--model <model>`              | -m   | 指定模型（gemini-3-pro / gemini-2.5-flash 等） | `-m gemini-3-pro`                              |
| `--prompt <text>`              | -p   | 非交互模式，直接给出提示                      | `-p "写 README"`                               |
| `--output-format json`         | —    | 输出 JSON 格式（脚本友好）                    | `--output-format json`                         |
| `--include-directories <dirs>` | —    | 额外包含目录到上下文                           | `--include-directories ../shared`              |
| `--yolo`                       | —    | 启用 Yolo 模式（自动批准所有工具调用，危险）   | `--yolo`                                       |
| `--preview-features`           | —    | 开启预览功能（Gemini 3 等）                    | 通过 /settings 切换更方便                      |

### 2. 交互模式内 Slash 命令（输入 / 后出现，可模糊搜索）

| Slash 命令              | 主要作用                                      | 常用场景 / 备注                              |
|-------------------------|-----------------------------------------------|----------------------------------------------|
| `/help`                 | 显示所有 slash 命令 + 快捷键                  | 随时查看帮助，必备                           |
| `/model`                | 切换模型（Auto / gemini-3-pro / flash 等）    | 切换性能/速度/成本                           |
| `/settings`             | 打开设置界面（主题、预览功能、工具等）        | 启用 Preview features 获取 Gemini 3          |
| `/memory`               | 管理记忆（add / list / clear / edit）         | 添加项目持久知识（类似 CLAUDE.md）           |
| `/clear`                | 清空当前对话 + 上下文，从零开始               | 切换新任务时                                 |
| `/stats` / `/cost`      | 显示 token 使用、费用估算、会话统计           | 监控大上下文消耗                             |
| `/tools`                | 列出当前可用工具（shell、file read/write 等） | 查看/调试 agent 能力                         |
| `/mcp`                  | 管理 MCP（Model Context Protocol）服务器      | 高级：连接外部知识源                         |
| `/commands`             | 管理自定义 slash 命令（reload / list）        | 自定义命令后 reload                          |
| `/chat`                 | 会话管理（save / resume / list / branch）     | 保存/恢复/分支对话历史                       |
| `/setup-github`         | 一键设置 GitHub Actions + Gemini 集成         | 仓库自动 review/PR triage                    |
| `/bug`                  | 直接从 CLI 提交 bug 到 Gemini CLI GitHub      | 报告问题                                     |
| `/extensions`           | 管理扩展（explore / install / list）          | 安装社区扩展（如 Dynatrace、Shopify 等）     |
| `/rewind`               | 撤销上一步（类似 git revert）                 | 改坏了快速回滚                               |
| `/compact`              | 压缩对话历史，节省 token                      | 长会话优化                                   |

**补充说明**（2026 年 3 月最新动态）：
- 官方最权威文档：https://geminicli.com/docs/reference/commands （slash 命令完整列表）
- 自定义 slash 命令：放在 `~/.gemini/commands/` 或项目 `.gemini/commands/` 目录下，用 .toml 文件定义（超级强大，可复用提示词）
- 工具权限：默认会逐个确认（file edit / shell exec 等），熟练后可用 `--yolo` 或配置自动批准
- Gemini 3 Pro/Flash 支持：通过 `/settings` 开启 Preview features，或 `-m gemini-3-pro`
- 安装/更新：`npm install -g @google/gemini-cli@latest`（Node.js 环境）

快速查看本地帮助：
```bash
gemini --help          # 终端 flags
# 进入交互后
/help                  # slash 命令列表
```

