---
title: "快捷键"
description: "Gemini CLI 快捷键和交互习惯：清屏、退出 Shell mode、复制输出、恢复会话和降低命令行操作成本。"
verifiedAt: "2026-05-09"
---

Gemini CLI 的快捷键不用背完整列表。入门阶段只需要会清屏、退出、复制输出、处理输入框撤销、进出 shell mode。真正影响结果质量的是上下文、权限和验收，不是快捷键数量。

> [!NOTE]
> **最低限度**：知道怎么清屏、怎么退出 Shell mode、怎么复制输出、怎么回到正常输入，就够开始使用。完整快捷键以官方 keyboard shortcuts reference 为准。

## 1. 高频动作

| 动作 | 方式 |
| --- | --- |
| 清屏 | `Ctrl+L` 或 `/clear` |
| 退出 Gemini CLI | `/quit` |
| 查看帮助 | `/help` |
| 复制最后输出 | `/copy` |
| 进入 Shell mode | 输入 `!` 后回车 |
| 退出 Shell mode | 再次切换 shell mode 或按当前终端提示退出 |
| 输入框撤销 | 官方 commands reference 记录有输入提示区撤销/重做快捷键 |

官方 commands 文档也说明 `/clear` 等价于清屏，`/copy` 复制最后输出，`/quit` 退出当前会话。教程里优先教这些可见命令，因为它们比平台相关快捷键更容易跨终端复现。

## 2. `/copy`

`/copy` 会把最后一次输出复制到系统剪贴板。macOS 使用 `pbcopy`，Windows 使用 `clip`，Linux 通常需要 `xclip` 或 `xsel`。

如果你在 SSH、WSL 或远程终端里，复制行为还会受到终端是否支持 OSC 52 的影响。

> [!WARNING]
> **远程复制要单独验收**：SSH、WSL、tmux、远程 IDE 和浏览器终端可能不支持同一套剪贴板路径。复制失败不是 Gemini CLI 内容失败，先查终端和 OSC 52 支持。

## 3. Shell mode 操作习惯

Shell mode 适合连续跑低风险命令，例如查看目录、运行测试、查看 git 状态。不要在 shell mode 里连续执行 destructive 命令，尤其是删除、迁移、发布、改权限和读取密钥。

一个稳的节奏是：

1. 先用普通 prompt 让 Gemini CLI 说明准备执行什么命令。
2. 再用 `!git status`、`!npm test`、`!pnpm test` 这类可解释命令取事实。
3. 输出太长时，让它总结关键失败点，不要把全部日志继续塞进上下文。

## 4. 学习建议

不要把快捷键当成第一优先级。Gemini CLI 的核心不是“键盘操作更快”，而是让 agent 能稳定地读上下文、执行工具、保留会话和受控修改。

常见误区是把“终端不好用”误判成“模型不好用”。例如复制失败、清屏无效、Shell mode 没退出、远程剪贴板不同步，这些多半是终端、tmux、SSH、WSL 或系统 clipboard 工具问题。先把交互环境验收清楚，再评价 Gemini CLI 的任务能力。

## 4.1 远程环境补充

远程机器、Cloud Shell、浏览器终端、tmux、mosh、SSH 转发都会影响快捷键。尤其是复制、撤销、组合键和 OSC 52，不能假设和本机 Terminal 一样。

写教程时，如果截图来自远程环境，要说明终端入口。否则读者在本机复现时，快捷键表现可能不同，但这不是 Gemini CLI 功能差异。

## 4.2 不要把快捷键写成核心路径

商业教程应把 slash command 作为主路径，快捷键作为补充。比如清屏先写 `/clear`，再写 `Ctrl+L`；退出先写 `/quit`，再补终端习惯。这样移动端终端、远程浏览器 shell、不同键盘布局都能跟上。

快捷键适合提高熟练度，不适合承担安全说明。Shell mode、复制、撤销这些操作，都要说明失败时怎么回到可控状态，而不是继续盲按快捷键。

## 5. 验收方式

第一次装好后，至少测试 `/help`、`/copy`、进入和退出 Shell mode。远程终端或 SSH 场景下，额外测试复制是否真正进了本机剪贴板；如果不行，再查 OSC 52 或终端设置，不要把它当成 Gemini CLI 生成内容失败。

## 6. 接下来去哪

<Cards>
  <Card title="文件管理" description="继续看 @ 文件引用、目录上下文和多目录 workspace。" href="/docs/gemini-cli/official/01-cli-workflow/13-file-management" />
  <Card title="Shell 命令" description="继续看 ! shell、命令确认、输出截断和高风险命令边界。" href="/docs/gemini-cli/official/01-cli-workflow/14-shell-commands" />
  <Card title="会话与历史" description="需要恢复旧任务、保存上下文或清理历史时，继续看 session 管理。" href="/docs/gemini-cli/official/01-cli-workflow/16-session-history" />
</Cards>

## 官方来源

- [Gemini CLI keyboard shortcuts](https://github.com/google-gemini/gemini-cli/blob/main/docs/reference/keyboard-shortcuts.md)
- [Gemini CLI commands reference](https://github.com/google-gemini/gemini-cli/blob/main/docs/reference/commands.md)
