Claude Code 快捷键自定义：keybindings.json 完整配置、18 个 Context 与 Keystroke 语法

Claude Code 支持全面自定义快捷键，通过 ~/.claude/keybindings.json 配置文件实现，修改后无需重启即时生效。

配置文件#

/keybindings    # 创建或打开配置文件

文件路径：~/.claude/keybindings.json

{
  "$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
      }
    }
  ]
}

添加 $schema 后，VS Code 等编辑器会提供自动补全和验证。

将快捷键设为 null 可解绑该快捷键（覆盖默认绑定）。

18 种 Context#

常用 Action 速查#

Global#

Chat#

Confirmation#

Transcript / DiffDialog / MessageSelector#

ModelPicker#

Keystroke 语法#

修饰键#

特殊键名#

大写字母#

shift+a 和 A（大写字母）不同：shift+a 表示 Shift+A 组合键，A 表示大写字母 A。

Chord（和弦，连续按键）#

两个快捷键顺序触发，用逗号分隔：

{
  "context": "Chat",
  "bindings": {
    "ctrl+x ctrl+s": "chat:submit"
  }
}

注意事项#

不可解绑的保留快捷键#

• Ctrl+C（系统级中断）
• Ctrl+D（EOF 退出）

终端冲突#

某些快捷键由终端应用处理，在 Claude Code 中无法配置：

• Ctrl+Z：终端挂起信号
• Ctrl+Q/Ctrl+S：终端流控制（部分终端）
• Ctrl+\：发送 SIGQUIT

Vim 模式交互#

Vim NORMAL 模式下，大多数快捷键被 Vim 命令占用；只有 app: 前缀的全局 Action 在 Vim NORMAL 模式下有效。

验证#

Claude Code 启动时验证 keybindings.json，配置错误时显示具体错误信息。

原文：Customize keyboard shortcuts - Claude Code Docs | 来源：Anthropic 官方文档