/keybindings 以在 ~/.claude/keybindings.json 建立或開啟您的配置檔案。
配置檔案
快捷鍵配置檔案是一個包含bindings 陣列的物件。每個區塊指定一個上下文和一個按鍵組合到動作的對應。
快捷鍵檔案的變更會自動偵測並套用，無需重新啟動 Claude Code。
此範例在聊天上下文中將
Ctrl+E 繫結到開啟外部編輯器，並取消繫結 Ctrl+U：
上下文
每個繫結區塊指定一個上下文，其中快捷鍵適用：
在 v2.1.205 之前，
/doctor 診斷螢幕存在 Doctor 上下文和 doctor:fix 動作。
可用動作
動作遵循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 上下文中可用的動作。select:accept 和 confirm:no 動作會從選擇和確認上下文中重複使用，具有設定特定的行為：變更會在您變更時立即套用到每個設定，因此 Escape 會關閉面板並儲存您的變更，而不是拒絕。
語音動作
在啟用語音聽寫時，在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。
例如：
大寫字母
獨立的大寫字母表示 Shift。例如，K 等同於 shift+k。這對於 vim 風格的繫結很有用，其中大寫和小寫鍵有不同的含義。
搭配修飾鍵的大寫字母（例如 ctrl+K）被視為風格上的，不表示 Shift：ctrl+K 與 ctrl+k 相同。
和弦
和弦是由空格分隔的按鍵組合序列：特殊鍵
escape或esc- Escape 鍵enter或return- Enter 鍵tab- Tab 鍵space- 空格鍵up、down、left、right- 方向鍵backspace、delete- 刪除鍵
取消繫結預設快捷鍵
將動作設定為null 以取消繫結預設快捷鍵：
Ctrl+X 系列跨越兩個內容：Chat 中的 ctrl+x ctrl+k 和 ctrl+x ctrl+e，以及 Task 中的 ctrl+x ctrl+b。若要將 ctrl+x 本身回收為單一鍵繫結，請取消繫結所有這些：
保留的快捷鍵
這些快捷鍵無法重新繫結：終端機衝突
某些快捷鍵可能與終端機多工器衝突：Vim 模式互動
啟用 vim 模式時（透過/config → 編輯器模式），快捷鍵和 vim 模式獨立運作：
- Vim 模式在文字輸入層級處理輸入（游標移動、模式、動作）
- 快捷鍵在元件層級處理動作（切換待辦事項、提交等）
- vim 模式中的 Escape 鍵從 INSERT 切換到 NORMAL 模式；它不會觸發
chat:cancel - 大多數 Ctrl+鍵快捷鍵通過 vim 模式傳遞到快捷鍵系統
- Vim 鍵無法透過快捷鍵檔案重新對應。若要對應兩鍵 INSERT 模式序列（例如
jj）至 Escape，請使用vimInsertModeRemaps設定 - 在 vim NORMAL 模式中，
?顯示說明選單（vim 行為） - 在 vim NORMAL 模式中，
/開啟歷史搜尋，與標準模式中的 Ctrl+R 相同
驗證
Claude Code 驗證您的快捷鍵並顯示以下警告：- 解析錯誤（無效的 JSON 或結構）
- 無效的上下文名稱
- 保留快捷鍵衝突
- 終端機多工器衝突
- 同一上下文中的重複繫結
--debug 啟動 Claude Code 以查看詳細資訊。