Gemini CLI 的命令分三类：/ 斜杠命令（控制 CLI 本身行为）、@路径 注入文件内容到提示词、!命令 直接执行 Shell 命令。本页完整收录所有 30+ 个斜杠命令的说明和子命令，是日常使用的核心参考手册。

命令速查完整参考

Gemini CLI 支持三类命令前缀：

前缀	用途
`/`	斜杠命令：控制 CLI 本身的元操作
`@`	文件内容注入：将文件或目录内容插入提示词
`!`	Shell 直通：直接执行系统命令

斜杠命令（`/`）

`/about`

显示 Gemini CLI 版本信息。提交 Issue 时附上此输出。

`/agents`

管理本地和远程子代理。

子命令	说明
`list`	列出所有已发现的代理（内置 + 本地 + 远程）
`reload`	重新扫描代理目录并刷新注册表
`enable <name>`	启用指定子代理
`disable <name>`	禁用指定子代理
`config <name>`	打开配置对话框（模型、temperature、轮次限制）

`/auth`

打开认证方式切换对话框，可在 Google 账号和 API Key 之间切换。

`/bug`

提交 Gemini CLI Bug。/bug <描述> 中的文本会成为 Issue 标题。默认提交到 GitHub 仓库，可在 settings.json 的 advanced.bugCommand 自定义。

`/chat`

/resume 的别名，功能完全相同。见 /resume。

`/clear`

清除终端屏幕（包括可见的会话历史和滚动内容）。键盘快捷键：Ctrl+L。

`/commands`

管理自定义斜杠命令（.toml 文件定义的命令）。

子命令	说明
`reload`	重新加载所有来源的自定义命令（用户级、项目级、MCP 提示词、扩展）

`/compress`

将当前对话历史压缩为高层次摘要，替换掉完整历史，节省后续 Token 用量。

`/copy`

将 Gemini CLI 的最后一条输出复制到剪贴板。

本地会话：使用系统剪贴板工具（pbcopy/xclip/clip）
远程会话（SSH/WSL）：使用 OSC 52 序列（需要终端支持）

`/directory`（或 `/dir`）

管理多目录工作区。

子命令	说明
`add <path1>,<path2>`	添加目录到工作区（绝对路径或相对路径，支持 `~` 前缀）
`show`	显示已添加的所有目录

在严格沙箱模式下禁用；改用 --include-directories 启动参数。

`/docs`

在浏览器中打开 Gemini CLI 官方文档。

`/editor`

打开编辑器选择对话框。

`/extensions`

管理扩展。

子命令	说明
`list`	列出已激活的扩展
`install <url/path>`	从 Git 仓库或本地路径安装扩展
`link <path>`	从本地路径链接扩展（开发调试用）
`enable <name>`	启用扩展
`disable <name>`	禁用扩展
`update <name>\|--all`	更新扩展
`uninstall <name>`	卸载扩展
`config`	配置扩展设置
`explore`	在浏览器中打开扩展市场
`restart`	重启所有扩展

`/help`（或 `/?`）

显示 Gemini CLI 的帮助信息，包含所有可用命令及用法说明。

`/hooks`

管理 Hooks（生命周期拦截器）。

子命令	说明
`list`（或 `show`、`panel`）	显示所有已注册的 Hooks 及其状态
`enable <name>`	启用指定 Hook
`disable <name>`	禁用指定 Hook
`enable-all`	启用所有 Hooks
`disable-all`	禁用所有 Hooks

`/ide`

管理 IDE 集成。

子命令	说明
`status`	查看 IDE 集成状态
`enable`	启用 IDE 集成
`disable`	禁用 IDE 集成
`install`	安装 IDE 伴侣组件

`/init`

分析当前目录并生成一份定制的 GEMINI.md 上下文文件，简化项目级指令配置。

`/mcp`

管理 MCP（Model Context Protocol）服务器。

子命令	说明
`list`（或 `ls`）	列出已配置的 MCP 服务器和工具（默认操作）
`desc`	显示服务器和工具（含描述）
`schema`	显示服务器、工具及完整 Schema
`enable <name>`	启用 MCP 服务器
`disable <name>`	禁用 MCP 服务器
`reload`	重新连接所有 MCP 服务器并刷新工具
`auth <name>`	对指定服务器发起 OAuth 认证流程

`/memory`

管理 AI 的指令上下文（从 GEMINI.md 文件加载的分层记忆）。

子命令	说明
`add <text>`	将文本添加到 AI 记忆
`list`	列出当前使用的所有 GEMINI.md 文件路径
`show`	显示已加载的完整层级记忆内容
`refresh`	重新加载所有 GEMINI.md 文件，更新模型上下文

`/model`

管理模型配置。

子命令	说明
`manage`	打开模型配置对话框
`set <model> [--persist]`	切换模型，加 `--persist` 持久化到 settings.json

详见模型切换（/model）。

`/permissions`

管理文件夹信任设置和其他权限。

子命令	说明
`trust [<path>]`	管理指定目录的信任级别

详见可信文件夹。

`/plan`

切换到 Plan Mode（只读模式），查看当前生成的计划。

子命令	说明
`copy`	将当前已批准的计划复制到剪贴板

详见 Plan Mode。

`/policies`

管理策略规则。

子命令	说明
`list`	列出所有按模式分组的活跃策略

`/privacy`

显示隐私声明，允许用户选择是否同意数据收集。

`/quit`（或 `/exit`）

退出 Gemini CLI。

`/restore`

将项目文件恢复到工具执行前的状态（基于 Checkpointing 功能）。

bash

/restore               # 列出可恢复的检查点
/restore <tool_call_id>  # 恢复到指定工具调用前

详见 Checkpointing 检查点。

`/resume`

浏览和恢复历史会话，管理命名检查点。

子命令	说明
`list`	列出所有命名检查点标签
`save <tag>`	将当前会话保存为命名检查点
`resume <tag>`	恢复指定命名检查点
`delete <tag>`	删除命名检查点
`share [filename]`	将当前会话导出为 Markdown 或 JSON
`debug`	以 JSON 格式导出最近一次 API 请求

不带子命令运行 /resume 时，打开交互式会话浏览器（自动保存的所有会话）。键盘操作：/ 搜索，Enter 选择，Esc 退出，x 删除。

详见会话管理。

`/rewind`

回退对话历史并（可选）撤销文件修改。键盘快捷键：连按两次 Esc。

详见 /rewind 命令。

`/settings`

打开设置编辑器，交互式查看和修改 Gemini CLI 配置。

详见配置参考（settings.json）。

`/shells`（或 `/bashes`）

切换后台 Shell 视图，查看和管理长时间运行的后台进程。

`/setup-github`

设置 GitHub Actions 工作流，用 Gemini 自动处理 Issue 和审查 PR。

`/skills`

管理 Agent Skills。

子命令	说明
`list`	列出所有已发现的 Skills 及其状态
`enable <name>`	启用指定 Skill
`disable <name>`	禁用指定 Skill
`reload`	重新扫描并加载所有 Skills

详见 Skills 工作流。

`/stats`

显示当前会话的详细统计信息。

子命令	说明
`session`（默认）	会话统计：时长、工具调用次数、性能指标
`model`	模型统计：Token 用量、配额信息
`tools`	工具统计：各工具使用次数

`/terminal-setup`

配置多行输入的终端键绑定（针对 VS Code、Cursor、Windsurf）。

`/theme`

打开主题选择对话框，切换 CLI 视觉主题。详见主题定制。

`/tools`

显示当前可用的工具列表。

子命令	说明
（无）	只显示工具名称
`desc`（或 `descriptions`）	显示工具名称 + 完整描述
`nodesc`（或 `nodescriptions`）	只显示工具名称

`/upgrade`

在浏览器中打开 Gemini Code Assist 升级页面。仅 Google 账号登录时可用。

`/vim`

切换 Vim 模式开关。开启后，输入区支持 Vim 的 NORMAL/INSERT 模式：

NORMAL 模式：h/j/k/l 移动，w/b/e 按词跳转，0/$ 行首行尾，G/gg 跳行，. 重复上次操作
INSERT 模式：正常输入，Esc 返回 NORMAL 模式
支持数字前缀：3h、5w、10G 等组合键
偏好持久化：设置保存到 ~/.gemini/settings.json

@ 文件注入命令

将文件或目录的内容插入到当前提示词中，一起发送给模型。

bash

@path/to/file.ts 解释这个文件的作用
@src/my_project/ 总结这个目录下的代码结构
这个错误是怎么回事？@error.log

行为说明：

单个文件：读取完整内容
目录：递归读取目录下的文件内容
路径含空格：用反斜杠转义，如 @My\ Documents/file.txt
Git 感知过滤：默认排除 .gitignore 中的文件（node_modules、dist、.env 等）
底层使用 read_many_files 工具，会显示工具调用记录

! Shell 直通命令

直接执行系统命令，结果显示在终端中，然后继续 Gemini CLI。

bash

!ls -la
!git status
!npm run test

! 单独输入：切换"Shell 模式"——此后输入的内容全部被当作 Shell 命令执行，直到再次输入 ! 退出。

! 命令执行的命令拥有与直接在终端运行相同的权限，会设置 GEMINI_CLI=1 环境变量。

常见问题

Q: 如何快速找到某个命令？

A: 在 CLI 中输入 /help 查看所有命令列表，或在 @cli_help 子代理中提问，如 @cli_help /resume 如何列出所有会话。

Q: /compress 和 /clear 有什么区别？

A: /clear 只清除终端显示，对话历史仍然保留在内存中；/compress 则将历史内容替换为摘要，实际缩减了传递给模型的 Token 量，适合长会话中途"清理"上下文。

Q: 如何在 CI/CD 中使用斜杠命令？

A: 斜杠命令是交互式界面的功能，在无头模式（-p 标志）下不可用。CI/CD 场景请通过 --model、--resume 等命令行标志代替，或在脚本中直接在 Prompt 中描述所需操作。

命令速查完整参考 ​

斜杠命令（/） ​

/about ​

/agents ​

/auth ​

/bug ​

/chat ​

/clear ​

/commands ​

/compress ​

/copy ​

/directory（或 /dir） ​

/docs ​

/editor ​

/extensions ​

/help（或 /?） ​

/hooks ​

/ide ​

/init ​

/mcp ​

/memory ​

/model ​

/permissions ​

/plan ​

/policies ​

/privacy ​

/quit（或 /exit） ​

/restore ​

/resume ​

/rewind ​

/settings ​

/shells（或 /bashes） ​

/setup-github ​

/skills ​

/stats ​

/terminal-setup ​

/theme ​

/tools ​

/upgrade ​

/vim ​

@ 文件注入命令 ​

! Shell 直通命令 ​

常见问题 ​

命令速查完整参考

斜杠命令（`/`）

`/about`

`/agents`

`/auth`

`/bug`

`/chat`

`/clear`

`/commands`

`/compress`

`/copy`

`/directory`（或 `/dir`）

`/docs`

`/editor`

`/extensions`

`/help`（或 `/?`）

`/hooks`

`/ide`

`/init`

`/mcp`

`/memory`

`/model`

`/permissions`

`/plan`

`/policies`

`/privacy`

`/quit`（或 `/exit`）

`/restore`

`/resume`

`/rewind`

`/settings`

`/shells`（或 `/bashes`）

`/setup-github`

`/skills`

`/stats`

`/terminal-setup`

`/theme`

`/tools`

`/upgrade`

`/vim`

@ 文件注入命令

! Shell 直通命令

常见问题