CLI 命令

Gemini CLI 支持多个内置命令来帮助你管理会话、自定义界面和控制其行为。这些命令以正斜杠（/）、at 符号（@）或感叹号（!）为前缀。

斜杠命令（/）

斜杠命令提供对 CLI 本身的元级控制。

内置命令

• /bug - 提交关于 Gemini CLI 的问题

• /chat - 保存和恢复对话历史

  • save <tag> - 保存当前对话
  • resume <tag> - 恢复之前的对话
  • list - 列出可用的保存标签
  • delete <tag> - 删除保存的对话
  • share file.md - 将对话导出到文件

• /clear - 清除终端屏幕（快捷键：Ctrl+L）

• /compress - 用摘要替换整个聊天上下文，节省 token

• /copy - 将最后的输出复制到剪贴板

• /directory（或 /dir）- 管理工作区目录

  • add <path> - 添加目录到工作区
  • show - 显示所有添加的目录

• /editor - 打开编辑器选择对话框

• /extensions - 列出当前会话中的所有活动扩展

• /help（或 /?）- 显示帮助信息

• /mcp - 管理 MCP 服务器

  • list - 列出配置的 MCP 服务器和工具
  • desc - 显示带描述的列表
  • schema - 显示带描述和模式的列表
  • auth <server> - 与 OAuth 启用的 MCP 服务器认证
  • refresh - 重启所有 MCP 服务器

• /model - 打开模型选择对话框

• /memory - 管理 AI 的指令上下文

  • add <text> - 添加文本到 AI 的记忆
  • show - 显示当前加载的层级记忆
  • refresh - 从所有 GEMINI.md 文件重新加载记忆
  • list - 列出使用中的 GEMINI.md 文件路径

• /restore [tool_call_id] - 恢复项目文件到工具执行前的状态

• /resume - 浏览和恢复之前的对话会话

• /settings - 打开设置编辑器

• /stats - 显示当前会话的详细统计信息

• /theme - 更改 Gemini CLI 的视觉主题

• /auth - 更改认证方法

• /about - 显示版本信息

• /tools [desc] - 显示可用工具列表

• /privacy - 显示隐私声明

• /quit（或 /exit）- 退出 Gemini CLI

• /vim - 切换 vim 模式

• /init - 分析当前目录并生成 GEMINI.md 文件

自定义命令

自定义命令允许你为最常用的提示创建个性化快捷方式。详细说明请参阅自定义命令文档。

输入提示快捷键

• 撤销： 按 Ctrl+z 撤销输入提示中的最后操作
• 重做： 按 Ctrl+Shift+Z 重做最后撤销的操作

At 命令（@）

At 命令用于将文件或目录的内容作为提示的一部分包含进来。

• @<path_to_file_or_directory> - 将指定文件或目录的内容注入到当前提示中
  • 示例：@path/to/your/file.txt 解释这段文本。
  • 示例：@src/my_project/ 总结这个目录中的代码。
  • 支持 Git 感知过滤，默认排除 git 忽略的文件

Shell 模式和直通命令（!）

! 前缀让你可以直接从 Gemini CLI 内部与系统 shell 交互。

• !<shell_command> - 执行给定的 shell 命令

  • 示例：!ls -la
  • 示例：!git status

• !（单独使用）- 切换 shell 模式

  • 进入 shell 模式时，输入的文本直接作为 shell 命令解释
  • 再次输入 ! 退出 shell 模式

注意： 通过 ! 执行的命令具有与直接在终端运行相同的权限和影响。执行命令时会设置 GEMINI_CLI=1 环境变量。