Claude Code 允许通过 ~/.claude/keybindings.json 完全自定义键盘快捷键，修改后无需重启立即生效。运行 /keybindings 创建或编辑配置文件，使用 bindings 数组按上下文（如 Chat、Global）指定按键映射，通过 action 名称如 chat:submit 绑定功能。支持解绑默认快捷键（设为 null），保留快捷键 Ctrl+C/Ctrl+D 不可修改，Vim 模式下快捷键独立工作。配置自动检测，运行 /doctor 检查错误和冲突。

Claude Code 快捷键怎么配置 - 自定义键盘操作绑定方法 #

运行 /keybindings 创建或打开配置文件 ~/.claude/keybindings.json，对 Claude Code 的快捷键进行完全自定义。修改后无需重启即时生效。 需要 Claude Code v2.1.18 或更高版本，可用 claude --version 确认版本。

配置文件格式 #

配置文件包含一个 bindings 数组，每个元素指定一个上下文和该上下文下的按键映射：

这个示例将 Ctrl+E 绑定为在 Chat 中打开外部编辑器，同时解绑 Ctrl+U：

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

值为 null 表示解绑该快捷键。配置文件改动会自动检测并应用，无需手动重启。

所有上下文 #

每个绑定块指定一个 context（上下文），绑定只在该上下文激活时生效：

可用 Action 完整列表 #

Action 采用 namespace:action 格式，例如 chat:submit 发送消息、app:toggleTodos 显示任务列表。每个上下文有各自可用的 actions。

App 操作（Global 上下文） #

历史记录操作 #

Chat 操作（Chat 上下文） #

*Windows 不带 VT 模式时（Node < 24.2.0 / < 22.17.0，Bun < 1.2.23），默认为 Meta+M。

语音操作（Chat 上下文，启用语音输入时） #

自动补全操作（Autocomplete 上下文） #

确认对话框操作（Confirmation 上下文） #

权限操作（Confirmation 上下文中的权限对话框） #

文本记录操作（Transcript 上下文） #

历史搜索操作（HistorySearch 上下文） #

任务操作（Task 上下文） #

主题操作（ThemePicker 上下文） #

帮助操作（Help 上下文） #

Tabs 操作（Tabs 上下文） #

附件操作（Attachments 上下文） #

Footer 操作（Footer 上下文） #

消息选择操作（MessageSelector 上下文） #

Diff 操作（DiffDialog 上下文） #

模型选择器操作（ModelPicker 上下文） #

选择操作（Select 上下文） #

插件操作（Plugin 上下文） #

设置操作（Settings 上下文） #

Doctor 操作（Doctor 上下文） #

滚动与文本选择操作（Scroll 上下文，启用全屏渲染时） #

按键语法 #

修饰键 #

用 + 分隔：

ctrl+k         Control + K
shift+tab      Shift + Tab
meta+p         Option + P（macOS），Alt + P（其他系统）
ctrl+shift+c   多个修饰键

支持的修饰键名称：

• ctrl 或 control — Control 键
• shift — Shift 键
• alt、opt、option 或 meta — Windows/Linux 上为 Alt，macOS 上为 Option
• cmd、command、super 或 win — macOS 上为 Command，Windows 上为 Windows 键，Linux 上为 Super 键

cmd 组仅在支持 Super 修饰符的终端中生效（如 Kitty 键盘协议或 xterm 的 modifyOtherKeys 模式）。大多数终端不发送此修饰符，因此跨平台绑定时建议使用 ctrl 或 meta。

大写字母 #

单独的大写字母默认等于 Shift + 小写字母，即 K 等同于 shift+k（适合 Vim 风格绑定）。

带修饰键的大写字母不额外加 Shift：ctrl+K 与 ctrl+k 等效。

和弦键（连续按键） #

用空格分隔两次按键：

ctrl+k ctrl+s   先按 Ctrl+K，再按 Ctrl+S

特殊键名 #

• escape 或 esc — Escape 键
• enter 或 return — Enter 键
• tab — Tab 键
• space — 空格键
• up、down、left、right — 方向键
• backspace、delete — 删除键

解绑默认快捷键 #

将值设为 null 即可解绑：

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null
      }
    }
  ]
}

和弦键也可以解绑。解绑所有共享前缀的和弦键后，该前缀可释放为单键绑定：

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": null,
        "ctrl+x": "chat:newline"
      }
    }
  ]
}

如果只解绑部分和弦键，按下前缀仍会进入和弦等待模式。

保留快捷键（不可修改） #

终端冲突 #

Vim 模式交互 #

通过 /config → Editor mode 启用 vim 模式后，快捷键和 vim 模式独立工作：

• Vim 模式：在文本输入层处理（光标移动、模式切换、操作命令）
• Keybindings：在组件层处理（切换任务列表、提交等）
• Vim 模式下 Escape 切换 INSERT → NORMAL 模式，不触发 chat:cancel
• 大多数 Ctrl+键 快捷键会透传 vim 模式到 keybinding 系统
• 在 vim NORMAL 模式下，? 显示帮助菜单（vim 行为）

配置验证 #

Claude Code 会自动验证 keybindings 配置并显示警告：

• JSON 解析错误
• 无效上下文名称
• 保留快捷键冲突
• 终端复用器冲突
• 同一上下文内重复绑定

运行 /doctor 查看所有键绑定警告。

常见问题 #

如何修改 Claude Code 的快捷键绑定？ #

运行 /keybindings 创建或打开 ~/.claude/keybindings.json，在 bindings 数组中按上下文指定按键和 action，修改后立即生效，无需重启。

Ctrl+S 在终端里被暂停了怎么办？ #

Ctrl+S 默认是终端软件流控制（XON/XOFF）的暂停键，可能无法被 Claude Code 捕获。建议在终端配置中取消该功能（例如 stty -ixon），或者将其他快捷键绑定到 chat:stash。

Vim 模式下 Escape 为什么不能取消输入？ #

启用 vim 模式后，Escape 先切换 INSERT → NORMAL 模式，不会被传递到键绑定系统。如需在 vim 模式下取消输入，可以另外绑定 chat:cancel 到其他组合键（如 Ctrl+[ 或 Ctrl+C），或退出 vim 模式后使用默认的 Escape。