Skip to content
BENIBIX Learn

keybindings.json

AI⌨️ Claude CodeConfiguration

Also known as ~/.claude/keybindings.json, Claude Code keybindings

The file where you change Claude Code's keyboard shortcuts.

Think of it like

It is like moving the buttons on a game pad. You put them where your thumbs like.

Example

Lucy keeps pressing ctrl+s by mistake. She sets it to null in keybindings.json, and now the key does nothing.

Why it matters

It lets you make the keys fit your hands and your other tools.

Definition

keybindings.json is the file in ~/.claude where you change Claude Code's keyboard shortcuts. It holds a list called bindings. Each entry names a context, such as Chat, and maps keys to actions, such as ctrl+e to chat:externalEditor. Setting a key to null takes its binding away. /keybindings opens the file, and changes apply with no restart.

Example code

json
{
  "bindings": [
    {
      "context": "Chat",
      "bindings": { "ctrl+e": "chat:externalEditor", "ctrl+s": null }
    }
  ]
}
Bind ctrl+e to the editor, and free ctrl+s.

Common mistake

Putting a binding in the wrong context. A key set for Chat does nothing in a dialog.

Key takeaways

  1. 1
    In ~/.claude. Just you.
  2. 2
    Context and keys. Mapped to actions.
  3. 3
    null unbinds. The key goes quiet.