自訂鍵盤快捷鍵

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

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

配置檔案

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

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

{
  "$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
      }
    }
  ]
}

上下文

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

可用動作

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

應用程式動作

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

歷史記錄動作

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

聊天動作

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

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

自動完成動作

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

確認動作

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

權限動作

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

文字記錄動作

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

歷史記錄搜尋動作

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

工作動作

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

主題動作

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

說明動作

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

Tabs 動作

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

附件動作

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

頁尾動作

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

訊息選擇器動作

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

Diff 動作

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

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

模型選擇器動作

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

選擇動作

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

Plugin 動作

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

設定動作

在 Settings 上下文中可用的動作：

Doctor 動作

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

語音動作

在啟用語音聽寫時，在 Chat 上下文中可用的動作：

滾動動作

在啟用全螢幕渲染時，在 Scroll 上下文中可用的動作：

按鍵組合語法

修飾鍵

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

• 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。

例如：

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

大寫字母

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

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

和弦

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

ctrl+k ctrl+s   按 Ctrl+K，放開，然後按 Ctrl+S

特殊鍵

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

取消繫結預設快捷鍵

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

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null
      }
    }
  ]
}

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

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

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

保留的快捷鍵

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

終端機衝突

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

Vim 模式互動

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

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

驗證

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

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

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