---
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 | 輸入 `!` 後Enter |
| 退出 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="/zh-Hant/docs/gemini-cli/official/01-cli-workflow/13-file-management" />
  <Card title="Shell 命令" description="繼續看 ! shell、命令確認、輸出截斷和高風險命令邊界。" href="/zh-Hant/docs/gemini-cli/official/01-cli-workflow/14-shell-commands" />
  <Card title="會話與歷史" description="需要恢復舊任務、儲存上下文或清理歷史時，繼續看 session 管理。" href="/zh-Hant/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)
