[BUG] Unknown skill: keybindings / ~/.claude/keybindings.json not picked up

Resolved 💬 2 comments Opened Apr 8, 2026 by torarnv Closed Apr 8, 2026

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

According to https://code.claude.com/docs/en/keybindings it should be possible to define custom keybindings. But typing /keybindings just results in Unknown skill: keybindings. And manually adding

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/en/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null,
        "shift+k": "app:exit"
      }
    }
  ]
}

to ~/.claude/keybindings.json does not have any effect.

What Should Happen?

Keybinding skill working, and keybindings respected.

Error Messages/Logs

Steps to Reproduce

See above

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

v2.1.18 according to https://code.claude.com/docs/en/keybindings

Claude Code Version

v2.1.96

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

iTerm2

Additional Information

_No response_

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗