Custom Keybindings Support / Claude Code v2.1.3

What

Configure custom keyboard shortcuts via a JSON file in your Claude config directory.

Usage

Create ~/.claude/keybindings.json with your custom mappings:

[
  {
    "context": "Chat",
    "bindings": {
      "ctrl+k": "chat:submit",
      "ctrl+l": null
    }
  }
]

Details

Supports contexts: Global, Chat, Autocomplete, Confirmation, Transcript, HistorySearch, Task, ThemePicker, Help
Set a binding to null to disable it
File is hot-reloaded on changes—no restart required
Invalid keybindings show warnings via notifications, with details available in /doctor
Reserved keys (ctrl+c, ctrl+d) cannot be remapped
Validation warns about OS-specific conflicts (e.g., cmd+c on macOS)

Evidence

TJ() at line 358886 (KeybindingSetup component, initializes with "[keybindings] KeybindingSetup initialized"), Q_A() at line 213102 (returns keybindings.json path), g_5() at line 358862 (displays "keybinding-config-warning" notifications)

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

How sure we are

One source agreesOne thing we can check says the same as this entry.

Anthropic's release notes agreeAdded detection and warnings for unreachable permission rules, with warnings in /doctor and after saving rules that include the source of…

See this entry in the whole of v2.1.3 →

The build it came inv2.1.3

9 Jan 2026 · 10 entries, this one is #1.

Either side of it

v2.1.2Older
v2.1.4Newer

Open the release →

Names in this entry

toolTask
Tools gain a backgrounding setting controlling whether they can keep running in the background
slash/doctor
Skill. Run a setup checkup that diagnoses issues and can fix them. Checks installation health, including duplicate or leftover installs, PATH problems, and unparseable settings files. Finds unused skills, MCP servers, and plugins versus their context cost, flags slow hooks, and checks for a newer version on your release channel. Deduplicates local CLAUDE.md files against checked-in ones, trims checked-in CLAUDE.md files by cutting content Claude could derive from the codebase, and migrates the always-loaded guidance that remains into skills and nested CLAUDE.md files that load on demand. Also offers to make auto mode your default and to pre-approve frequently denied read-only commands. Reports findings first and asks for confirmation before changing anything. From the terminal, claude doctor prints read-only installation diagnostics without starting a session. Alias: /checkup. Run /doctor prompt-audit to have Claude audit your CLAUDE.md files, skills, and other configuration for outdated or conflicting instructions instead of running the checkup. The prompt-audit subcommand requires Claude Code v2.1.283 or later. The CLAUDE.md trim check requires Claude Code v2.1.206 or later. Before v2.1.205, /doctor opened a read-only diagnostics screen and pressing f sent the report to Claude

Anthropic's note

Upstream's own release notes for v2.1.3 name something this entry names, so the two are probably about the same change. Probably: the pairing is made on a shared name rather than on the words around it.

Added detection and warnings for unreachable permission rules, with warnings in /doctor and after saving rules that include the source of each rule and actionable fix guidance

Is this right?

Other releases about the same thing. Found by shared names or similar wording; neither means one caused the other.

v2.1.20 Keybindings Customization Skill