/keybindings 来创建或打开位于 ~/.claude/keybindings.json 的配置文件。
配置文件
快捷键配置文件是一个包含bindings 数组的对象。每个块指定一个上下文和一个按键映射到操作的映射。
快捷键文件的更改会自动检测并应用，无需重启 Claude Code。
此示例将
Ctrl+E 绑定到在聊天上下文中打开外部编辑器，并取消绑定 Ctrl+U：
上下文
每个绑定块指定一个上下文，其中绑定适用：可用操作
操作遵循namespace:action 格式，例如 chat:submit 发送消息或 app:toggleTodos 显示任务列表。每个上下文都有特定的可用操作。
应用程序操作
在Global 上下文中可用的操作：
历史操作
用于导航命令历史的操作：聊天操作
在Chat 上下文中可用的操作：
*在没有 VT 模式的 Windows 上（Node <24.2.0/<22.17.0，Bun <1.2.23），默认为 Meta+M。
自动完成操作
在Autocomplete 上下文中可用的操作：
确认操作
在Confirmation 上下文中可用的操作：
权限操作
在Confirmation 上下文中可用于权限对话框的操作：
记录操作
在Transcript 上下文中可用的操作：
历史搜索操作
在HistorySearch 上下文中可用的操作：
任务操作
在Task 上下文中可用的操作：
主题操作
在ThemePicker 上下文中可用的操作：
帮助操作
在Help 上下文中可用的操作：
选项卡操作
在Tabs 上下文中可用的操作：
附件操作
在Attachments 上下文中可用的操作：
页脚操作
在Footer 上下文中可用的操作：
消息选择器操作
在MessageSelector 上下文中可用的操作：
差异操作
在DiffDialog 上下文中可用的操作：
模型选择器操作
在ModelPicker 上下文中可用的操作：
选择操作
在Select 上下文中可用的操作：
插件操作
在Plugin 上下文中可用的操作：
设置操作
在Settings 上下文中可用的操作：
按键语法
修饰符
使用修饰符键与+ 分隔符：
ctrl或control- Control 键alt、opt或option- Alt/Option 键shift- Shift 键meta、cmd或command- Meta/Command 键
大写字母
独立的大写字母意味着 Shift。例如，K 等同于 shift+k。这对于 vim 风格的绑定很有用，其中大写和小写键有不同的含义。
带有修饰符的大写字母（例如 ctrl+K）被视为风格性的，不意味着 Shift — ctrl+K 与 ctrl+k 相同。
和弦
和弦是由空格分隔的按键序列：特殊键
escape或esc- Escape 键enter或return- Enter 键tab- Tab 键space- 空格键up、down、left、right- 箭头键backspace、delete- 删除键
取消绑定默认快捷键
将操作设置为null 以取消绑定默认快捷键：
保留快捷键
这些快捷键无法重新绑定：终端冲突
某些快捷键可能与终端多路复用器冲突：Vim 模式交互
启用 vim 模式（/vim）时，快捷键和 vim 模式独立运行：
- Vim 模式在文本输入级别处理输入（光标移动、模式、动作）
- 快捷键在组件级别处理操作（切换待办事项、提交等）
- vim 模式中的 Escape 键从 INSERT 切换到 NORMAL 模式；它不触发
chat:cancel - 大多数 Ctrl+key 快捷键通过 vim 模式传递到快捷键系统
- 在 vim NORMAL 模式中，
?显示帮助菜单（vim 行为）
验证
Claude Code 验证您的快捷键并显示以下警告：- 解析错误（无效的 JSON 或结构）
- 无效的上下文名称
- 保留快捷键冲突
- 终端多路复用器冲突
- 同一上下文中的重复绑定
/doctor 查看任何快捷键警告。