跳轉到主要內容
可自訂的鍵盤快捷鍵需要 Claude Code v2.1.18 或更新版本。使用 claude --version 檢查您的版本。
Claude Code 支援可自訂的鍵盤快捷鍵。執行 /keybindings 以在 ~/.claude/keybindings.json 建立或開啟您的配置檔案。

​
配置檔案

快捷鍵配置檔案是一個包含 bindings 陣列的物件。每個區塊指定一個上下文和一個按鍵組合到動作的對應。
快捷鍵檔案的變更會自動偵測並套用，無需重新啟動 Claude Code。
欄位說明
$schema選用的 JSON Schema URL，用於編輯器自動完成
$docs選用的文件 URL
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
      }
    }
  ]
}

​
上下文

每個繫結區塊指定一個上下文，其中快捷鍵適用：
上下文說明
Global在應用程式的任何地方適用
Chat主聊天輸入區域
Autocomplete自動完成選單已開啟
Settings設定選單（僅限 Escape 關閉）
Confirmation權限和確認對話框
Tabs標籤導覽元件
Help說明選單可見
Transcript文字記錄檢視器
HistorySearch歷史記錄搜尋模式 (Ctrl+R)
Task背景工作正在執行
ThemePicker主題選擇器對話框
Attachments影像/附件欄導覽
Footer頁尾指示器導覽（工作、團隊、差異）
MessageSelector回溯和摘要對話框訊息選擇
DiffDialog差異檢視器導覽
ModelPicker模型選擇器努力程度
Select通用選擇/清單元件
PluginPlugin 對話框（瀏覽、探索、管理）

​
可用動作

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

​
應用程式動作

在 Global 上下文中可用的動作：
動作預設值說明
app:interruptCtrl+C取消目前操作
app:exitCtrl+D結束 Claude Code
app:toggleTodosCtrl+T切換工作清單可見性
app:toggleTranscriptCtrl+O切換詳細文字記錄

​
歷史記錄動作

用於導覽命令歷史記錄的動作：
動作預設值說明
history:searchCtrl+R開啟歷史記錄搜尋
history:previousUp上一個歷史記錄項目
history:nextDown下一個歷史記錄項目

​
聊天動作

在 Chat 上下文中可用的動作：
動作預設值說明
chat:cancelEscape取消目前輸入
chat:killAgentsCtrl+X Ctrl+K終止所有背景代理
chat:cycleModeShift+Tab*循環權限模式
chat:modelPickerCmd+P / Meta+P開啟模型選擇器
chat:fastModeMeta+O切換快速模式
chat:thinkingToggleCmd+T / Meta+T切換延伸思考
chat:submitEnter提交訊息
chat:undoCtrl+_復原上一個動作
chat:externalEditorCtrl+G, Ctrl+X Ctrl+E在外部編輯器中開啟
chat:stashCtrl+S暫存目前提示
chat:imagePasteCtrl+V (Windows 上為 Alt+V)貼上影像
*在沒有 VT 模式的 Windows 上（Node <24.2.0/<22.17.0、Bun <1.2.23），預設為 Meta+M。

​
自動完成動作

在 Autocomplete 上下文中可用的動作：
動作預設值說明
autocomplete:acceptTab接受建議
autocomplete:dismissEscape關閉選單
autocomplete:previousUp上一個建議
autocomplete:nextDown下一個建議

​
確認動作

在 Confirmation 上下文中可用的動作：
動作預設值說明
confirm:yesY, Enter確認動作
confirm:noN, Escape拒絕動作
confirm:previousUp上一個選項
confirm:nextDown下一個選項
confirm:nextFieldTab下一個欄位
confirm:previousField(未繫結)上一個欄位
confirm:cycleModeShift+Tab循環權限模式
confirm:toggleExplanationCtrl+E切換權限說明

​
權限動作

在 Confirmation 上下文中可用於權限對話框的動作：
動作預設值說明
permission:toggleDebugCtrl+D切換權限偵錯資訊

​
文字記錄動作

在 Transcript 上下文中可用的動作：
動作預設值說明
transcript:toggleShowAllCtrl+E切換顯示所有內容
transcript:exitCtrl+C, Escape結束文字記錄檢視

​
歷史記錄搜尋動作

在 HistorySearch 上下文中可用的動作：
動作預設值說明
historySearch:nextCtrl+R下一個符合項目
historySearch:acceptEscape, Tab接受選擇
historySearch:cancelCtrl+C取消搜尋
historySearch:executeEnter執行選定的命令

​
工作動作

在 Task 上下文中可用的動作：
動作預設值說明
task:backgroundCtrl+B背景執行目前工作

​
主題動作

在 ThemePicker 上下文中可用的動作：
動作預設值說明
theme:toggleSyntaxHighlightingCtrl+T切換語法醒目提示

​
說明動作

在 Help 上下文中可用的動作：
動作預設值說明
help:dismissEscape關閉說明選單

​
標籤動作

在 Tabs 上下文中可用的動作：
動作預設值說明
tabs:nextTab, Right下一個標籤
tabs:previousShift+Tab, Left上一個標籤

​
附件動作

在 Attachments 上下文中可用的動作：
動作預設值說明
attachments:nextRight下一個附件
attachments:previousLeft上一個附件
attachments:removeBackspace, Delete移除選定的附件
attachments:exitDown, Escape結束附件欄

​
頁尾動作

在 Footer 上下文中可用的動作：
動作預設值說明
footer:nextRight下一個頁尾項目
footer:previousLeft上一個頁尾項目
footer:openSelectedEnter開啟選定的頁尾項目
footer:clearSelectionEscape清除頁尾選擇

​
訊息選擇器動作

在 MessageSelector 上下文中可用的動作：
動作預設值說明
messageSelector:upUp, K, Ctrl+P在清單中向上移動
messageSelector:downDown, J, Ctrl+N在清單中向下移動
messageSelector:topCtrl+Up, Shift+Up, Meta+Up, Shift+K跳至頂部
messageSelector:bottomCtrl+Down, Shift+Down, Meta+Down, Shift+J跳至底部
messageSelector:selectEnter選擇訊息

​
差異動作

在 DiffDialog 上下文中可用的動作：
動作預設值說明
diff:dismissEscape關閉差異檢視器
diff:previousSourceLeft上一個差異來源
diff:nextSourceRight下一個差異來源
diff:previousFileUp差異中的上一個檔案
diff:nextFileDown差異中的下一個檔案
diff:viewDetailsEnter檢視差異詳細資訊
diff:back(特定於上下文)在差異檢視器中返回

​
模型選擇器動作

在 ModelPicker 上下文中可用的動作：
動作預設值說明
modelPicker:decreaseEffortLeft降低努力程度
modelPicker:increaseEffortRight提高努力程度

​
選擇動作

在 Select 上下文中可用的動作：
動作預設值說明
select:nextDown, J, Ctrl+N下一個選項
select:previousUp, K, Ctrl+P上一個選項
select:acceptEnter接受選擇
select:cancelEscape取消選擇

​
Plugin 動作

在 Plugin 上下文中可用的動作：
動作預設值說明
plugin:toggleSpace切換 plugin 選擇
plugin:installI安裝選定的 plugins

​
設定動作

在 Settings 上下文中可用的動作：
動作預設值說明
settings:search/進入搜尋模式
settings:retryR重試載入使用量資料（發生錯誤時）

​
語音動作

在啟用語音聽寫時，在 Chat 上下文中可用的動作：
動作預設值說明
voice:pushToTalkSpace按住以聽寫提示

​
按鍵組合語法

​
修飾鍵

使用 + 分隔符搭配修飾鍵：
  • ctrl 或 control - Control 鍵
  • alt、opt 或 option - Alt/Option 鍵
  • shift - Shift 鍵
  • meta、cmd 或 command - Meta/Command 鍵
例如： 
ctrl+k          單一鍵搭配修飾鍵
shift+tab       Shift + Tab
meta+p          Command/Meta + 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
      }
    }
  ]
}

​
保留的快捷鍵

這些快捷鍵無法重新繫結：
快捷鍵原因
Ctrl+C硬編碼的中斷/取消
Ctrl+D硬編碼的結束
Ctrl+M與終端機中的 Enter 相同（兩者都傳送 CR）

​
終端機衝突

某些快捷鍵可能與終端機多工器衝突：
快捷鍵衝突
Ctrl+Btmux 前綴（按兩次以傳送）
Ctrl+AGNU screen 前綴
Ctrl+ZUnix 程序暫停 (SIGTSTP)

​
Vim 模式互動

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

​
驗證

Claude Code 驗證您的快捷鍵並顯示以下警告：
  • 解析錯誤（無效的 JSON 或結構）
  • 無效的上下文名稱
  • 保留快捷鍵衝突
  • 終端機多工器衝突
  • 同一上下文中的重複繫結
執行 /doctor 以查看任何快捷鍵警告。