> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 自訂鍵盤快捷鍵

> 使用快捷鍵配置檔案在 Claude Code 中自訂鍵盤快捷鍵。

<Note>
  可自訂的鍵盤快捷鍵需要 Claude Code v2.1.18 或更新版本。使用 `claude --version` 檢查您的版本。
</Note>

Claude Code 支援可自訂的鍵盤快捷鍵。執行 `/keybindings` 以在 `~/.claude/keybindings.json` 建立或開啟您的配置檔案。

<h2 id="configuration-file">
  配置檔案
</h2>

快捷鍵配置檔案是一個包含 `bindings` 陣列的物件。每個區塊指定一個上下文和一個按鍵組合到動作的對應。

<Note>快捷鍵檔案的變更會自動偵測並套用，無需重新啟動 Claude Code。</Note>

| 欄位         | 說明                            |
| :--------- | :---------------------------- |
| `$schema`  | 選用的 JSON Schema URL，用於編輯器自動完成 |
| `$docs`    | 選用的文件 URL                     |
| `bindings` | 按上下文分組的繫結區塊陣列                 |

此範例在聊天上下文中將 `Ctrl+E` 繫結到開啟外部編輯器，並取消繫結 `Ctrl+U`：

```json theme={null}
{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/zh-TW/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null
      }
    }
  ]
}
```

<h2 id="contexts">
  上下文
</h2>

每個繫結區塊指定一個**上下文**，其中快捷鍵適用：

| 上下文               | 說明                   |
| :---------------- | :------------------- |
| `Global`          | 在應用程式的任何地方適用         |
| `Chat`            | 主聊天輸入區域              |
| `Autocomplete`    | 自動完成選單已開啟            |
| `Settings`        | 設定選單                 |
| `Confirmation`    | 權限和確認對話框             |
| `Tabs`            | 標籤導覽元件               |
| `Help`            | 說明選單可見               |
| `Transcript`      | 文字記錄檢視器              |
| `HistorySearch`   | 歷史記錄搜尋模式 (Ctrl+R)    |
| `Task`            | 背景工作正在執行             |
| `ThemePicker`     | 主題選擇器對話框             |
| `Attachments`     | 影像附件導覽在選擇對話框中        |
| `Footer`          | 頁尾指示器導覽（工作、團隊、差異）    |
| `MessageSelector` | 回溯和摘要對話框訊息選擇         |
| `DiffDialog`      | 差異檢視器導覽              |
| `ModelPicker`     | 模型選擇器努力程度            |
| `Select`          | 通用選擇/清單元件            |
| `Plugin`          | Plugin 對話框（瀏覽、探索、管理） |
| `Scroll`          | 對話滾動和全螢幕模式中的文字選擇     |
| `Doctor`          | `/doctor` 診斷螢幕       |

<h2 id="available-actions">
  可用動作
</h2>

動作遵循 `namespace:action` 格式，例如 `chat:submit` 用於傳送訊息，或 `app:toggleTodos` 用於顯示工作清單。每個上下文都有特定的可用動作。

<h3 id="app-actions">
  應用程式動作
</h3>

在 `Global` 上下文中可用的動作：

| 動作                     | 預設值    | 說明             |
| :--------------------- | :----- | :------------- |
| `app:interrupt`        | Ctrl+C | 取消目前操作         |
| `app:exit`             | Ctrl+D | 結束 Claude Code |
| `app:redraw`           | (未繫結)  | 強制終端機重新繪製      |
| `app:toggleTodos`      | Ctrl+T | 切換工作清單可見性      |
| `app:toggleTranscript` | Ctrl+O | 切換詳細文字記錄       |

<h3 id="history-actions">
  歷史記錄動作
</h3>

用於導覽命令歷史記錄的動作：

| 動作                 | 預設值    | 說明        |
| :----------------- | :----- | :-------- |
| `history:search`   | Ctrl+R | 開啟歷史記錄搜尋  |
| `history:previous` | Up     | 上一個歷史記錄項目 |
| `history:next`     | Down   | 下一個歷史記錄項目 |

<h3 id="chat-actions">
  聊天動作
</h3>

在 `Chat` 上下文中可用的動作：

| 動作                    | 預設值                             | 說明                                                                                        |
| :-------------------- | :------------------------------ | :---------------------------------------------------------------------------------------- |
| `chat:cancel`         | Escape                          | 取消目前輸入                                                                                    |
| `chat:clearInput`     | Ctrl+L                          | 強制進行完整螢幕重新繪製，保留輸入。在[全螢幕渲染](/zh-TW/fullscreen#clear-the-conversation)中，在兩秒內按兩次以執行 `/clear` |
| `chat:clearScreen`    | Cmd+K                           | 在[全螢幕渲染](/zh-TW/fullscreen#clear-the-conversation)中，在兩秒內按兩次以執行 `/clear`                   |
| `chat:killAgents`     | Ctrl+X Ctrl+K                   | 終止此工作階段中所有執行中的[背景子代理](/zh-TW/sub-agents#run-subagents-in-foreground-or-background)        |
| `chat:cycleMode`      | Shift+Tab\*                     | 循環權限模式                                                                                    |
| `chat:modelPicker`    | Meta+P                          | 開啟模型選擇器                                                                                   |
| `chat:fastMode`       | Meta+O                          | 切換快速模式                                                                                    |
| `chat:thinkingToggle` | Meta+T                          | 切換延伸思考                                                                                    |
| `chat:submit`         | Enter                           | 提交訊息                                                                                      |
| `chat:newline`        | Ctrl+J                          | 插入換行符而不提交                                                                                 |
| `chat:undo`           | Ctrl+\_, Ctrl+Shift+-           | 復原上一個動作                                                                                   |
| `chat:externalEditor` | Ctrl+G, Ctrl+X Ctrl+E           | 在外部編輯器中開啟                                                                                 |
| `chat:stash`          | Ctrl+S                          | 暫存目前提示                                                                                    |
| `chat:imagePaste`     | Ctrl+V (Windows 和 WSL 上為 Alt+V) | 從剪貼簿貼上影像。在 WSL 上，預設會繫結兩個快捷鍵                                                               |

\*在沒有 VT 模式的 Windows 上（Node \<24.2.0/\<22.17.0、Bun \<1.2.23），預設為 Meta+M。

<h3 id="autocomplete-actions">
  自動完成動作
</h3>

在 `Autocomplete` 上下文中可用的動作：

| 動作                      | 預設值    | 說明    |
| :---------------------- | :----- | :---- |
| `autocomplete:accept`   | Tab    | 接受建議  |
| `autocomplete:dismiss`  | Escape | 關閉選單  |
| `autocomplete:previous` | Up     | 上一個建議 |
| `autocomplete:next`     | Down   | 下一個建議 |

<h3 id="confirmation-actions">
  確認動作
</h3>

在 `Confirmation` 上下文中可用的動作：

| 動作                          | 預設值       | 說明     |
| :-------------------------- | :-------- | :----- |
| `confirm:yes`               | Y, Enter  | 確認動作   |
| `confirm:no`                | N, Escape | 拒絕動作   |
| `confirm:previous`          | Up        | 上一個選項  |
| `confirm:next`              | Down      | 下一個選項  |
| `confirm:nextField`         | Tab       | 下一個欄位  |
| `confirm:previousField`     | (未繫結)     | 上一個欄位  |
| `confirm:toggle`            | Space     | 切換選擇   |
| `confirm:cycleMode`         | Shift+Tab | 循環權限模式 |
| `confirm:toggleExplanation` | Ctrl+E    | 切換權限說明 |

<h3 id="permission-actions">
  權限動作
</h3>

在 `Confirmation` 上下文中可用於權限對話框的動作：

| 動作                       | 預設值   | 說明                                                      |
| :----------------------- | :---- | :------------------------------------------------------ |
| `permission:toggleDebug` | (未繫結) | 切換權限偵錯資訊。v2.1.146 中移除了先前的 Ctrl+D 預設值，因為它與 `app:exit` 衝突 |

<h3 id="transcript-actions">
  文字記錄動作
</h3>

在 `Transcript` 上下文中可用的動作：

| 動作                         | 預設值               | 說明       |
| :------------------------- | :---------------- | :------- |
| `transcript:toggleShowAll` | Ctrl+E            | 切換顯示所有內容 |
| `transcript:exit`          | q, Ctrl+C, Escape | 結束文字記錄檢視 |

<h3 id="history-search-actions">
  歷史記錄搜尋動作
</h3>

在 `HistorySearch` 上下文中可用的動作：

| 動作                         | 預設值         | 說明                |
| :------------------------- | :---------- | :---------------- |
| `historySearch:next`       | Ctrl+R      | 下一個符合項目           |
| `historySearch:accept`     | Escape, Tab | 接受選擇              |
| `historySearch:cancel`     | Ctrl+C      | 取消搜尋              |
| `historySearch:execute`    | Enter       | 執行選定的命令           |
| `historySearch:cycleScope` | Ctrl+S      | 循環範圍：工作階段、專案、任何地方 |

<h3 id="task-actions">
  工作動作
</h3>

在 `Task` 上下文中可用的動作：

| 動作                | 預設值                   | 說明                                                                                    |
| :---------------- | :-------------------- | :------------------------------------------------------------------------------------ |
| `task:background` | Ctrl+B, Ctrl+X Ctrl+B | 背景執行目前工作。{/* min-version: 2.1.169 */}Ctrl+X Ctrl+B 快捷鍵需要 v2.1.169 或更新版本，並避免 tmux 前綴衝突 |

<h3 id="theme-actions">
  主題動作
</h3>

在 `ThemePicker` 上下文中可用的動作：

| 動作                               | 預設值    | 說明       |
| :------------------------------- | :----- | :------- |
| `theme:toggleSyntaxHighlighting` | Ctrl+T | 切換語法醒目提示 |

<h3 id="help-actions">
  說明動作
</h3>

在 `Help` 上下文中可用的動作：

| 動作             | 預設值    | 說明     |
| :------------- | :----- | :----- |
| `help:dismiss` | Escape | 關閉說明選單 |

<h3 id="tabs-actions">
  Tabs 動作
</h3>

在 `Tabs` 上下文中可用的動作：

| 動作              | 預設值             | 說明    |
| :-------------- | :-------------- | :---- |
| `tabs:next`     | Tab, Right      | 下一個標籤 |
| `tabs:previous` | Shift+Tab, Left | 上一個標籤 |

<h3 id="attachments-actions">
  附件動作
</h3>

在 `Attachments` 上下文中可用的動作：

| 動作                     | 預設值               | 說明      |
| :--------------------- | :---------------- | :------ |
| `attachments:next`     | Right             | 下一個附件   |
| `attachments:previous` | Left              | 上一個附件   |
| `attachments:remove`   | Backspace, Delete | 移除選定的附件 |
| `attachments:exit`     | Down, Escape      | 結束附件導覽  |

<h3 id="footer-actions">
  頁尾動作
</h3>

在 `Footer` 上下文中可用的動作：

| 動作                      | 預設值    | 說明                |
| :---------------------- | :----- | :---------------- |
| `footer:next`           | Right  | 下一個頁尾項目           |
| `footer:previous`       | Left   | 上一個頁尾項目           |
| `footer:up`             | Up     | 在頁尾中向上導覽（在頂部取消選擇） |
| `footer:down`           | Down   | 在頁尾中向下導覽          |
| `footer:openSelected`   | Enter  | 開啟選定的頁尾項目         |
| `footer:clearSelection` | Escape | 清除頁尾選擇            |

<h3 id="message-selector-actions">
  訊息選擇器動作
</h3>

在 `MessageSelector` 上下文中可用的動作：

| 動作                       | 預設值                                       | 說明       |
| :----------------------- | :---------------------------------------- | :------- |
| `messageSelector:up`     | Up, K, Ctrl+P                             | 在清單中向上移動 |
| `messageSelector:down`   | Down, J, Ctrl+N                           | 在清單中向下移動 |
| `messageSelector:top`    | Ctrl+Up, Shift+Up, Meta+Up, Shift+K       | 跳至頂部     |
| `messageSelector:bottom` | Ctrl+Down, Shift+Down, Meta+Down, Shift+J | 跳至底部     |
| `messageSelector:select` | Enter                                     | 選擇訊息     |

<h3 id="diff-actions">
  Diff 動作
</h3>

在 `DiffDialog` 上下文中可用的動作：

| 動作                    | 預設值      | 說明                         |
| :-------------------- | :------- | :------------------------- |
| `diff:dismiss`        | Escape   | 關閉差異檢視器                    |
| `diff:previousSource` | Left     | 上一個差異來源                    |
| `diff:nextSource`     | Right    | 下一個差異來源                    |
| `diff:previousFile`   | Up, K    | 檔案清單中的上一個檔案；在詳細資訊檢視中向上滾動一行 |
| `diff:nextFile`       | Down, J  | 檔案清單中的下一個檔案；在詳細資訊檢視中向下滾動一行 |
| `diff:viewDetails`    | Enter    | 檢視差異詳細資訊                   |
| `diff:back`           | (特定於上下文) | 在差異檢視器中返回                  |

差異詳細資訊檢視也會將分頁器風格的按鍵繫結到標準[滾動動作](#scroll-actions)。這些繫結是 `DiffDialog` 上下文的一部分，僅適用於詳細資訊檢視；[滾動動作](#scroll-actions)下列出的 `Scroll` 上下文預設值保持不變。

| 動作                    | 預設值            | 說明          |
| :-------------------- | :------------- | :---------- |
| `scroll:pageUp`       | PageUp         | 向上滾動視窗高度的一半 |
| `scroll:pageDown`     | PageDown       | 向下滾動視窗高度的一半 |
| `scroll:fullPageUp`   | Shift+Space, B | 向上滾動完整視窗高度  |
| `scroll:fullPageDown` | Space          | 向下滾動完整視窗高度  |
| `scroll:top`          | G, Home        | 跳至頂部        |
| `scroll:bottom`       | Shift+G, End   | 跳至底部        |

<h3 id="model-picker-actions">
  模型選擇器動作
</h3>

在 `ModelPicker` 上下文中可用的動作：

| 動作                            | 預設值   | 說明               |
| :---------------------------- | :---- | :--------------- |
| `modelPicker:decreaseEffort`  | Left  | 降低努力程度           |
| `modelPicker:increaseEffort`  | Right | 提高努力程度           |
| `modelPicker:thisSessionOnly` | s     | 將醒目提示的模型套用至此工作階段 |

<h3 id="select-actions">
  選擇動作
</h3>

在 `Select` 上下文中可用的動作：

| 動作                | 預設值             | 說明    |
| :---------------- | :-------------- | :---- |
| `select:next`     | Down, J, Ctrl+N | 下一個選項 |
| `select:previous` | Up, K, Ctrl+P   | 上一個選項 |
| `select:accept`   | Enter           | 接受選擇  |
| `select:cancel`   | Escape          | 取消選擇  |

<h3 id="plugin-actions">
  Plugin 動作
</h3>

在 `Plugin` 上下文中可用的動作：

| 動作                | 預設值   | 說明                                 |
| :---------------- | :---- | :--------------------------------- |
| `plugin:toggle`   | Space | 切換 plugin 選擇                       |
| `plugin:install`  | I     | 安裝選定的 plugins                      |
| `plugin:favorite` | F     | 將選定的 plugin 標記為最愛，使其在「已安裝」標籤頂部附近排序 |

<h3 id="settings-actions">
  設定動作
</h3>

在 `Settings` 上下文中可用的動作。`select:accept` 和 `confirm:no` 動作會從[選擇](#select-actions)和[確認](#confirmation-actions)上下文中重複使用，具有設定特定的行為：變更會在您變更時立即套用到每個設定，因此 Escape 會關閉面板並儲存您的變更，而不是拒絕。

| 動作                | 預設值          | 說明               |
| :---------------- | :----------- | :--------------- |
| `settings:search` | /            | 進入搜尋模式           |
| `settings:retry`  | R            | 重試載入使用量資料（發生錯誤時） |
| `select:accept`   | Enter, Space | 變更選定的設定或開啟其子選單   |
| `confirm:no`      | Escape       | 關閉面板。變更已儲存       |

<h3 id="doctor-actions">
  Doctor 動作
</h3>

在 `Doctor` 上下文中可用的動作：

| 動作           | 預設值 | 說明                                 |
| :----------- | :-- | :--------------------------------- |
| `doctor:fix` | F   | 將診斷報告傳送給 Claude 以修復報告的問題。僅在發現問題時有效 |

<h3 id="voice-actions">
  語音動作
</h3>

在啟用[語音聽寫](/zh-TW/voice-dictation)時，在 `Chat` 上下文中可用的動作：

| 動作                 | 預設值   | 說明                       |
| :----------------- | :---- | :----------------------- |
| `voice:pushToTalk` | Space | 聽寫提示。根據 `/voice` 模式按住或點選 |

<h3 id="scroll-actions">
  滾動動作
</h3>

在啟用[全螢幕渲染](/zh-TW/fullscreen)時，在 `Scroll` 上下文中可用的動作：

| 動作                          | 預設值                  | 說明                                                   |
| :-------------------------- | :------------------- | :--------------------------------------------------- |
| `scroll:lineUp`             | (未繫結)                | 向上滾動一行。滑鼠滾輪滾動會觸發此動作                                  |
| `scroll:lineDown`           | (未繫結)                | 向下滾動一行。滑鼠滾輪滾動會觸發此動作                                  |
| `scroll:pageUp`             | PageUp               | 向上滾動視窗高度的一半                                          |
| `scroll:pageDown`           | PageDown             | 向下滾動視窗高度的一半                                          |
| `scroll:top`                | Ctrl+Home            | 跳至對話的開始                                              |
| `scroll:bottom`             | Ctrl+End             | 跳至最新訊息並重新啟用自動跟隨                                      |
| `scroll:halfPageUp`         | (未繫結)                | 向上滾動視窗高度的一半。與 `scroll:pageUp` 相同的行為，為 vi 風格的重新繫結提供   |
| `scroll:halfPageDown`       | (未繫結)                | 向下滾動視窗高度的一半。與 `scroll:pageDown` 相同的行為，為 vi 風格的重新繫結提供 |
| `scroll:fullPageUp`         | (未繫結)                | 向上滾動完整視窗高度                                           |
| `scroll:fullPageDown`       | (未繫結)                | 向下滾動完整視窗高度                                           |
| `selection:copy`            | Ctrl+Shift+C / Cmd+C | 將選定的文字複製到剪貼簿                                         |
| `selection:clear`           | (未繫結)                | 清除有效的文字選擇                                            |
| `selection:extendLeft`      | Shift+Left           | 將有效選擇向左延伸一欄                                          |
| `selection:extendRight`     | Shift+Right          | 將有效選擇向右延伸一欄                                          |
| `selection:extendUp`        | Shift+Up             | 將有效選擇向上延伸一列。當選擇到達頂部邊緣時滾動視窗                           |
| `selection:extendDown`      | Shift+Down           | 將有效選擇向下延伸一列。當選擇到達底部邊緣時滾動視窗                           |
| `selection:extendLineStart` | Shift+Home           | 將有效選擇延伸到行的開始                                         |
| `selection:extendLineEnd`   | Shift+End            | 將有效選擇延伸到行的結尾                                         |

<h2 id="keystroke-syntax">
  按鍵組合語法
</h2>

<h3 id="modifiers">
  修飾鍵
</h3>

使用 `+` 分隔符搭配修飾鍵：

* `ctrl` 或 `control` - Control 鍵
* `shift` - Shift 鍵
* `alt`、`opt`、`option` 或 `meta` - Windows 和 Linux 上的 Alt 鍵，macOS 上的 Option 鍵
* `cmd`、`command`、`super` 或 `win` - macOS 上的 Command 鍵，Windows 上的 Windows 鍵，Linux 上的 Super 鍵

`cmd` 群組只在報告 Super 修飾鍵的終端機中被偵測，例如支援 Kitty 鍵盤協議或 xterm 的 `modifyOtherKeys` 模式的終端機。大多數終端機不會發送它，因此對於您想在任何地方都能運作的繫結，請使用 `ctrl` 或 `meta`。

例如：

```text theme={null}
ctrl+k          Ctrl + K
shift+tab       Shift + Tab
meta+p          macOS 上的 Option + P，其他地方為 Alt + P
ctrl+shift+c    多個修飾鍵
```

<h3 id="uppercase-letters">
  大寫字母
</h3>

獨立的大寫字母表示 Shift。例如，`K` 等同於 `shift+k`。這對於 vim 風格的繫結很有用，其中大寫和小寫鍵有不同的含義。

搭配修飾鍵的大寫字母（例如 `ctrl+K`）被視為風格上的，**不**表示 Shift：`ctrl+K` 與 `ctrl+k` 相同。

<h3 id="chords">
  和弦
</h3>

和弦是由空格分隔的按鍵組合序列：

```text theme={null}
ctrl+k ctrl+s   按 Ctrl+K，放開，然後按 Ctrl+S
```

<h3 id="special-keys">
  特殊鍵
</h3>

* `escape` 或 `esc` - Escape 鍵
* `enter` 或 `return` - Enter 鍵
* `tab` - Tab 鍵
* `space` - 空格鍵
* `up`、`down`、`left`、`right` - 方向鍵
* `backspace`、`delete` - 刪除鍵

<h2 id="unbind-default-shortcuts">
  取消繫結預設快捷鍵
</h2>

將動作設定為 `null` 以取消繫結預設快捷鍵：

```json theme={null}
{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null
      }
    }
  ]
}
```

這也適用於和弦繫結。取消繫結共享前綴的每個和弦會釋放該前綴以用作單一鍵繫結：

```json theme={null}
{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": null,
        "ctrl+x": "chat:newline"
      }
    }
  ]
}
```

如果您取消繫結前綴上的某些但不是全部和弦，按下前綴仍會進入和弦等待模式以進行剩餘的繫結。

<h2 id="reserved-shortcuts">
  保留的快捷鍵
</h2>

這些快捷鍵無法重新繫結：

| 快捷鍵       | 原因                        |
| :-------- | :------------------------ |
| Ctrl+C    | 硬編碼的中斷/取消                 |
| Ctrl+D    | 硬編碼的結束                    |
| Ctrl+M    | 與終端機中的 Enter 相同（兩者都傳送 CR） |
| Caps Lock | 未傳遞至終端機應用程式               |

<h2 id="terminal-conflicts">
  終端機衝突
</h2>

某些快捷鍵可能與終端機多工器衝突：

| 快捷鍵    | 衝突                  |
| :----- | :------------------ |
| Ctrl+B | tmux 前綴（按兩次以傳送）     |
| Ctrl+A | GNU screen 前綴       |
| Ctrl+Z | Unix 程序暫停 (SIGTSTP) |

<h2 id="vim-mode-interaction">
  Vim 模式互動
</h2>

啟用 vim 模式時（透過 `/config` → 編輯器模式），快捷鍵和 vim 模式獨立運作：

* **Vim 模式**在文字輸入層級處理輸入（游標移動、模式、動作）
* **快捷鍵**在元件層級處理動作（切換待辦事項、提交等）
* vim 模式中的 Escape 鍵從 INSERT 切換到 NORMAL 模式；它不會觸發 `chat:cancel`
* 大多數 Ctrl+鍵快捷鍵通過 vim 模式傳遞到快捷鍵系統
* 在 vim NORMAL 模式中，`?` 顯示說明選單（vim 行為）
* 在 vim NORMAL 模式中，`/` 開啟歷史搜尋，與標準模式中的 Ctrl+R 相同

<h2 id="validation">
  驗證
</h2>

Claude Code 驗證您的快捷鍵並顯示以下警告：

* 解析錯誤（無效的 JSON 或結構）
* 無效的上下文名稱
* 保留快捷鍵衝突
* 終端機多工器衝突
* 同一上下文中的重複繫結

執行 `/doctor` 以查看任何快捷鍵警告。