Gemini CLI 支持多个内置命令来帮助您管理会话、自定义界面和控制其行为。这些命令以正斜杠（/）、at 符号（@）或感叹号（!）为前缀。
斜杠命令（/）
/bug
描述： 提交关于 Gemini CLI 的问题。默认情况下，问题在 Gemini CLI 的 GitHub 仓库中提交。您在 /bug 后输入的字符串将成为所提交错误的标题。
自定义： 可以通过 .gemini/settings.json 文件中的 bugCommand 设置修改默认行为。
/chat
描述： 保存和恢复对话历史记录，用于交互式分支对话状态或从后续会话恢复先前状态。
子命令：
save <tag>- 保存当前对话历史记录resume <tag>- 从先前的保存恢复对话list- 列出可用于聊天状态恢复的标签
/clear
描述： 清除终端屏幕，包括可见的会话历史记录和 CLI 内的回滚。
快捷键： 随时按 Ctrl+L 执行清除操作。
/compress
描述： 用摘要替换整个聊天上下文。这节省了未来任务使用的 token，同时保留已发生事件的高级摘要。
/editor
描述： 打开用于选择支持的编辑器的对话框。
/help 或 /?
描述： 显示关于 Gemini CLI 的帮助信息，包括可用命令及其用法。
/mcp
描述： 列出配置的模型上下文协议 (MCP) 服务器、其连接状态、服务器详细信息和可用工具。
子命令：
desc或descriptions- 显示 MCP 服务器和工具的详细描述nodesc或nodescriptions- 隐藏工具描述，仅显示工具名称schema- 显示工具配置参数的完整 JSON 模式
快捷键： 随时按 Ctrl+T 在显示和隐藏工具描述之间切换。
/memory
描述： 管理 AI 的指导上下文（从 GEMINI.md 文件加载的分层内存）。
子命令：
add <text>- 将文本添加到 AI 的内存中show- 显示当前分层内存的完整、连接内容refresh- 从所有GEMINI.md文件重新加载分层指导内存
/restore
描述： 将项目文件恢复到工具执行前的状态。这对于撤销工具所做的文件编辑特别有用。
用法： /restore [tool_call_id]
注意： 仅在使用 --checkpointing 选项调用 CLI 或通过设置配置时可用。
/stats
描述： 显示当前 Gemini CLI 会话的详细统计信息，包括 token 使用情况、缓存 token 节省（如果可用）和会话持续时间。
注意： 缓存 token 信息仅在使用缓存 token 时显示，这发生在 API 密钥身份验证中，但目前不在 OAuth 身份验证中。
/auth
描述： 打开让您更改身份验证方法的对话框。
/about
描述： 显示版本信息。在提交问题时请分享此信息。
/tools
描述： 显示 Gemini CLI 中当前可用的工具列表。
子命令：
desc或descriptions- 显示每个工具的详细描述nodesc或nodescriptions- 隐藏工具描述，仅显示工具名称
相关： 查看工具文档了解更多详情。
/quit 或 /exit
描述： 退出 Gemini CLI。
@ 命令（@）
@<path_to_file_or_directory>
描述： 将指定文件或文件的内容注入到您当前的提示中。这对于询问有关特定代码、文本或文件集合的问题很有用。
示例：
@path/to/your/file.txt 解释这个文本。
@src/my_project/ 总结这个目录中的代码。
这个文件是关于什么的？ @README.md详细信息：
- 如果提供单个文件的路径，将读取该文件的内容。
- 如果提供目录的路径，命令会尝试读取该目录和任何子目录中文件的内容。
- 路径中的空格应该用反斜杠转义（例如，
@My\ Documents/file.txt）。 - 该命令内部使用
read_many_files工具。 - Git 感知过滤： 默认情况下，git 忽略的文件（如
node_modules/、dist/、.env、.git/）被排除。
@（单独的 @ 符号）
描述： 如果您输入单独的 @ 符号而没有路径，查询将按原样传递给 Gemini 模型。
@ 命令的错误处理
- 如果
@后指定的路径未找到或无效，将显示错误消息。 - 如果
read_many_files工具遇到错误（例如，权限问题），这也将被报告。
Shell 模式和直通命令（!）
! 前缀让您直接从 Gemini CLI 中与系统的 shell 交互。
!<shell_command>
描述： 在系统的默认 shell 中执行给定的 <shell_command>。命令的任何输出或错误都会显示在终端中。
示例：
!ls -la # 执行 ls -la 并返回 Gemini CLI
!git status # 执行 git status 并返回 Gemini CLI!（切换 shell 模式）
描述： 单独输入 ! 切换 shell 模式。
- 进入 shell 模式： 激活时，shell 模式使用不同的颜色和"Shell 模式指示器"。
- 退出 shell 模式： 退出时，UI 恢复到标准外观，正常的 Gemini CLI 行为恢复。
⚠️ 所有 ! 用法的注意事项
您在 shell 模式中执行的命令具有与您直接在终端中运行它们相同的权限和影响。
快速参考
🔧 管理命令
/help- 显示帮助/stats- 会话统计/clear- 清除屏幕/quit- 退出 CLI
⚙️ 配置命令
/theme- 更改主题/auth- 更改认证/tools- 查看工具/mcp- MCP 服务器
💾 会话命令
/chat save- 保存会话/chat resume- 恢复会话/memory- 管理内存/restore- 恢复文件
键盘快捷键
| 快捷键 | 功能 | 等效命令 |
|---|---|---|
| Ctrl+L | 清除屏幕 | /clear |
| Ctrl+T | 切换工具描述 | /mcp descriptions |