Langsung ke konten utama
Pintasan keyboard yang dapat disesuaikan memerlukan Claude Code v2.1.18 atau lebih baru. Periksa versi Anda dengan claude --version.
Claude Code mendukung pintasan keyboard yang dapat disesuaikan. Jalankan /keybindings untuk membuat atau membuka file konfigurasi Anda di ~/.claude/keybindings.json.

File konfigurasi

File konfigurasi keybindings adalah objek dengan array bindings. Setiap blok menentukan konteks dan peta dari keystroke ke tindakan.
Perubahan pada file keybindings secara otomatis terdeteksi dan diterapkan tanpa perlu memulai ulang Claude Code.
FieldDeskripsi
$schemaURL JSON Schema opsional untuk penyelesaian otomatis editor
$docsURL dokumentasi opsional
bindingsArray blok binding berdasarkan konteks
Contoh ini mengikat Ctrl+E untuk membuka editor eksternal dalam konteks chat, dan membatalkan ikatan Ctrl+U:
{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/id/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null
      }
    }
  ]
}

Konteks

Setiap blok binding menentukan konteks di mana binding berlaku:
KonteksDeskripsi
GlobalBerlaku di mana saja dalam aplikasi
ChatArea input chat utama
AutocompleteMenu penyelesaian otomatis terbuka
SettingsMenu pengaturan (dismiss hanya dengan escape)
ConfirmationDialog izin dan konfirmasi
TabsKomponen navigasi tab
HelpMenu bantuan terlihat
TranscriptPenampil transkrip
HistorySearchMode pencarian riwayat (Ctrl+R)
TaskTugas latar belakang sedang berjalan
ThemePickerDialog pemilih tema
AttachmentsNavigasi bilah gambar/lampiran
FooterNavigasi indikator footer (tugas, tim, diff)
MessageSelectorPemilihan pesan dialog rewind dan ringkasan
DiffDialogNavigasi penampil diff
ModelPickerTingkat upaya pemilih model
SelectKomponen select/list generik
PluginDialog plugin (jelajahi, temukan, kelola)

Tindakan yang tersedia

Tindakan mengikuti format namespace:action, seperti chat:submit untuk mengirim pesan atau app:toggleTodos untuk menampilkan daftar tugas. Setiap konteks memiliki tindakan spesifik yang tersedia.

Tindakan aplikasi

Tindakan yang tersedia dalam konteks Global:
TindakanDefaultDeskripsi
app:interruptCtrl+CBatalkan operasi saat ini
app:exitCtrl+DKeluar dari Claude Code
app:toggleTodosCtrl+TAlihkan visibilitas daftar tugas
app:toggleTranscriptCtrl+OAlihkan transkrip verbose

Tindakan riwayat

Tindakan untuk menavigasi riwayat perintah:
TindakanDefaultDeskripsi
history:searchCtrl+RBuka pencarian riwayat
history:previousUpItem riwayat sebelumnya
history:nextDownItem riwayat berikutnya

Tindakan chat

Tindakan yang tersedia dalam konteks Chat:
TindakanDefaultDeskripsi
chat:cancelEscapeBatalkan input saat ini
chat:killAgentsCtrl+X Ctrl+KMatikan semua agen latar belakang
chat:cycleModeShift+Tab*Mode izin siklus
chat:modelPickerCmd+P / Meta+PBuka pemilih model
chat:fastModeMeta+OAlihkan mode cepat
chat:thinkingToggleCmd+T / Meta+TAlihkan pemikiran yang diperluas
chat:submitEnterKirim pesan
chat:undoCtrl+_Batalkan tindakan terakhir
chat:externalEditorCtrl+G, Ctrl+X Ctrl+EBuka di editor eksternal
chat:stashCtrl+SSimpan prompt saat ini
chat:imagePasteCtrl+V (Alt+V di Windows)Tempel gambar
*Di Windows tanpa mode VT (Node <24.2.0/<22.17.0, Bun <1.2.23), default ke Meta+M.

Tindakan penyelesaian otomatis

Tindakan yang tersedia dalam konteks Autocomplete:
TindakanDefaultDeskripsi
autocomplete:acceptTabTerima saran
autocomplete:dismissEscapeTutup menu
autocomplete:previousUpSaran sebelumnya
autocomplete:nextDownSaran berikutnya

Tindakan konfirmasi

Tindakan yang tersedia dalam konteks Confirmation:
TindakanDefaultDeskripsi
confirm:yesY, EnterKonfirmasi tindakan
confirm:noN, EscapeTolak tindakan
confirm:previousUpOpsi sebelumnya
confirm:nextDownOpsi berikutnya
confirm:nextFieldTabBidang berikutnya
confirm:previousField(unbound)Bidang sebelumnya
confirm:cycleModeShift+TabMode izin siklus
confirm:toggleExplanationCtrl+EAlihkan penjelasan izin

Tindakan izin

Tindakan yang tersedia dalam konteks Confirmation untuk dialog izin:
TindakanDefaultDeskripsi
permission:toggleDebugCtrl+DAlihkan info debug izin

Tindakan transkrip

Tindakan yang tersedia dalam konteks Transcript:
TindakanDefaultDeskripsi
transcript:toggleShowAllCtrl+EAlihkan tampilkan semua konten
transcript:exitCtrl+C, EscapeKeluar dari tampilan transkrip

Tindakan pencarian riwayat

Tindakan yang tersedia dalam konteks HistorySearch:
TindakanDefaultDeskripsi
historySearch:nextCtrl+RKecocokan berikutnya
historySearch:acceptEscape, TabTerima pilihan
historySearch:cancelCtrl+CBatalkan pencarian
historySearch:executeEnterJalankan perintah yang dipilih

Tindakan tugas

Tindakan yang tersedia dalam konteks Task:
TindakanDefaultDeskripsi
task:backgroundCtrl+BTugas latar belakang saat ini

Tindakan tema

Tindakan yang tersedia dalam konteks ThemePicker:
TindakanDefaultDeskripsi
theme:toggleSyntaxHighlightingCtrl+TAlihkan penyorotan sintaks

Tindakan bantuan

Tindakan yang tersedia dalam konteks Help:
TindakanDefaultDeskripsi
help:dismissEscapeTutup menu bantuan

Tindakan tab

Tindakan yang tersedia dalam konteks Tabs:
TindakanDefaultDeskripsi
tabs:nextTab, RightTab berikutnya
tabs:previousShift+Tab, LeftTab sebelumnya

Tindakan lampiran

Tindakan yang tersedia dalam konteks Attachments:
TindakanDefaultDeskripsi
attachments:nextRightLampiran berikutnya
attachments:previousLeftLampiran sebelumnya
attachments:removeBackspace, DeleteHapus lampiran yang dipilih
attachments:exitDown, EscapeKeluar dari bilah lampiran
Tindakan yang tersedia dalam konteks Footer:
TindakanDefaultDeskripsi
footer:nextRightItem footer berikutnya
footer:previousLeftItem footer sebelumnya
footer:openSelectedEnterBuka item footer yang dipilih
footer:clearSelectionEscapeHapus pilihan footer

Tindakan pemilih pesan

Tindakan yang tersedia dalam konteks MessageSelector:
TindakanDefaultDeskripsi
messageSelector:upUp, K, Ctrl+PNaik dalam daftar
messageSelector:downDown, J, Ctrl+NTurun dalam daftar
messageSelector:topCtrl+Up, Shift+Up, Meta+Up, Shift+KLompat ke atas
messageSelector:bottomCtrl+Down, Shift+Down, Meta+Down, Shift+JLompat ke bawah
messageSelector:selectEnterPilih pesan

Tindakan diff

Tindakan yang tersedia dalam konteks DiffDialog:
TindakanDefaultDeskripsi
diff:dismissEscapeTutup penampil diff
diff:previousSourceLeftSumber diff sebelumnya
diff:nextSourceRightSumber diff berikutnya
diff:previousFileUpFile sebelumnya dalam diff
diff:nextFileDownFile berikutnya dalam diff
diff:viewDetailsEnterLihat detail diff
diff:back(context-specific)Kembali dalam penampil diff

Tindakan pemilih model

Tindakan yang tersedia dalam konteks ModelPicker:
TindakanDefaultDeskripsi
modelPicker:decreaseEffortLeftKurangi tingkat upaya
modelPicker:increaseEffortRightTingkatkan tingkat upaya

Tindakan pilih

Tindakan yang tersedia dalam konteks Select:
TindakanDefaultDeskripsi
select:nextDown, J, Ctrl+NOpsi berikutnya
select:previousUp, K, Ctrl+POpsi sebelumnya
select:acceptEnterTerima pilihan
select:cancelEscapeBatalkan pilihan

Tindakan plugin

Tindakan yang tersedia dalam konteks Plugin:
TindakanDefaultDeskripsi
plugin:toggleSpaceAlihkan pemilihan plugin
plugin:installIInstal plugin yang dipilih

Tindakan pengaturan

Tindakan yang tersedia dalam konteks Settings:
TindakanDefaultDeskripsi
settings:search/Masuk mode pencarian
settings:retryRCoba muat ulang data penggunaan (saat terjadi kesalahan)

Tindakan suara

Tindakan yang tersedia dalam konteks Chat ketika dikte suara diaktifkan:
TindakanDefaultDeskripsi
voice:pushToTalkSpaceTahan untuk mendikte prompt

Sintaks keystroke

Pengubah

Gunakan tombol pengubah dengan pemisah +:
  • ctrl atau control - Tombol Control
  • alt, opt, atau option - Tombol Alt/Option
  • shift - Tombol Shift
  • meta, cmd, atau command - Tombol Meta/Command
Sebagai contoh:
ctrl+k          Tombol tunggal dengan pengubah
shift+tab       Shift + Tab
meta+p          Command/Meta + P
ctrl+shift+c    Pengubah ganda

Huruf besar

Huruf besar yang berdiri sendiri menyiratkan Shift. Sebagai contoh, K setara dengan shift+k. Ini berguna untuk binding gaya vim di mana kunci huruf besar dan kecil memiliki arti berbeda. Huruf besar dengan pengubah (misalnya, ctrl+K) diperlakukan sebagai gaya dan tidak menyiratkan Shift — ctrl+K sama dengan ctrl+k.

Chord

Chord adalah urutan keystroke yang dipisahkan oleh spasi:
ctrl+k ctrl+s   Tekan Ctrl+K, lepaskan, lalu Ctrl+S

Tombol khusus

  • escape atau esc - Tombol Escape
  • enter atau return - Tombol Enter
  • tab - Tombol Tab
  • space - Bilah spasi
  • up, down, left, right - Tombol panah
  • backspace, delete - Tombol hapus

Batalkan pintasan default

Atur tindakan ke null untuk membatalkan ikatan pintasan default:
{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null
      }
    }
  ]
}

Pintasan yang dicadangkan

Pintasan ini tidak dapat diikat ulang:
PintasanAlasan
Ctrl+CInterrupt/cancel yang dikodekan keras
Ctrl+DExit yang dikodekan keras
Ctrl+MIdentik dengan Enter di terminal (keduanya mengirim CR)

Konflik terminal

Beberapa pintasan mungkin bertentangan dengan multiplexer terminal:
PintasanKonflik
Ctrl+BAwalan tmux (tekan dua kali untuk mengirim)
Ctrl+AAwalan GNU screen
Ctrl+ZSuspend proses Unix (SIGTSTP)

Interaksi mode vim

Ketika mode vim diaktifkan (/vim), keybindings dan mode vim beroperasi secara independen:
  • Mode vim menangani input pada tingkat input teks (gerakan kursor, mode, motions)
  • Keybindings menangani tindakan pada tingkat komponen (alihkan todos, kirim, dll.)
  • Tombol Escape dalam mode vim beralih dari INSERT ke mode NORMAL; itu tidak memicu chat:cancel
  • Sebagian besar pintasan Ctrl+key melewati mode vim ke sistem keybinding
  • Dalam mode NORMAL vim, ? menampilkan menu bantuan (perilaku vim)

Validasi

Claude Code memvalidasi keybindings Anda dan menampilkan peringatan untuk:
  • Parse errors (JSON atau struktur tidak valid)
  • Nama konteks tidak valid
  • Konflik pintasan yang dicadangkan
  • Konflik multiplexer terminal
  • Binding duplikat dalam konteks yang sama
Jalankan /doctor untuk melihat peringatan keybinding apa pun.