# keybindings.json

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** ~/.claude/keybindings.json, Claude Code keybindings

## Think of it like

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

## 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

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

## Example code

```json
{
  "bindings": [
    {
      "context": "Chat",
      "bindings": { "ctrl+e": "chat:externalEditor", "ctrl+s": null }
    }
  ]
}
```

Bind ctrl+e to the editor, and free ctrl+s.

## Why it matters

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

## Common mistake

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

## Three principles

- **In ~/.claude.** Just you.
- **Context and keys.** Mapped to actions.
- **null unbinds.** The key goes quiet.

## Related terms

- [/keybindings Command](https://learn.benibix.com/term/ai/keybindings-command)
- [~/.claude Directory](https://learn.benibix.com/term/ai/home-claude-directory)

---

Source: https://learn.benibix.com/term/ai/keybindings-json-file
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
