Appearance
自定义键盘快捷键
需要 Claude Code v2.1.18 或更高版本（
claude --version查看）。
运行 /keybindings 创建或打开配置文件 ~/.claude/keybindings.json，对 Claude Code 的快捷键进行完全自定义。修改后无需重启即时生效。
配置文件格式
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
}
}
]
}bindings 是一个数组，每个元素指定一个上下文和该上下文下的按键映射。值为 null 表示解绑该快捷键。
所有上下文
| 上下文 | 说明 |
|---|---|
Global | 应用全局生效 |
Chat | 主聊天输入区 |
Autocomplete | 自动补全菜单打开时 |
Settings | 设置菜单 |
Confirmation | 权限/确认对话框 |
Tabs | Tab 导航组件 |
Help | 帮助菜单可见时 |
Transcript | 文本记录查看器 |
HistorySearch | 历史搜索模式（Ctrl+R） |
Task | 后台任务运行时 |
ThemePicker | 主题选择对话框 |
Attachments | 图片/附件栏导航 |
Footer | 底部状态导航 |
MessageSelector | 回退/摘要对话框消息选择 |
DiffDialog | Diff 查看器导航 |
ModelPicker | 模型选择器推理力度调整 |
Select | 通用选择/列表组件 |
Plugin | 插件对话框 |
可用 Action 完整列表
全局 App 操作（Global 上下文）
| Action | 默认键 | 说明 |
|---|---|---|
app:interrupt | Ctrl+C | 取消当前操作 |
app:exit | Ctrl+D | 退出 Claude Code |
app:toggleTodos | Ctrl+T | 切换任务列表显示 |
app:toggleTranscript | Ctrl+O | 切换详细记录显示 |
历史记录操作
| Action | 默认键 | 说明 |
|---|---|---|
history:search | Ctrl+R | 打开历史搜索 |
history:previous | ↑ | 上一条历史 |
history:next | ↓ | 下一条历史 |
Chat 操作（Chat 上下文）
| Action | 默认键 | 说明 |
|---|---|---|
chat:cancel | Escape | 取消当前输入 |
chat:cycleMode | Shift+Tab | 循环切换权限模式 |
chat:modelPicker | Cmd+P / Meta+P | 打开模型选择器 |
chat:thinkingToggle | Cmd+T / Meta+T | 切换扩展思考模式 |
chat:submit | Enter | 提交消息 |
chat:undo | Ctrl+_ | 撤销上一步 |
chat:externalEditor | Ctrl+G | 在外部编辑器中打开 |
chat:stash | Ctrl+S | 暂存当前提示词 |
chat:imagePaste | Ctrl+V（Windows 为 Alt+V） | 粘贴图片 |
Windows 不带 VT 模式时（Node < 24.2.0 / < 22.17.0，Bun < 1.2.23），
chat:cycleMode默认为 Meta+M。
语音操作（Chat 上下文，启用语音输入时）
| Action | 默认键 | 说明 |
|---|---|---|
voice:pushToTalk | Space（按住） | 按住说话 |
自动补全操作（Autocomplete 上下文）
| Action | 默认键 | 说明 |
|---|---|---|
autocomplete:accept | Tab | 接受建议 |
autocomplete:dismiss | Escape | 关闭菜单 |
autocomplete:previous | ↑ | 上一个建议 |
autocomplete:next | ↓ | 下一个建议 |
确认对话框操作（Confirmation 上下文）
| Action | 默认键 | 说明 |
|---|---|---|
confirm:yes | Y, Enter | 确认 |
confirm:no | N, Escape | 拒绝 |
confirm:cycleMode | Shift+Tab | 循环切换权限模式 |
confirm:toggleExplanation | Ctrl+E | 切换权限详情说明 |
permission:toggleDebug | Ctrl+D | 切换权限调试信息 |
任务操作（Task 上下文）
| Action | 默认键 | 说明 |
|---|---|---|
task:background | Ctrl+B | 将当前任务放到后台 |
Diff 操作（DiffDialog 上下文）
| Action | 默认键 | 说明 |
|---|---|---|
diff:dismiss | Escape | 关闭 Diff 查看器 |
diff:previousSource | ← | 上一个 diff 来源 |
diff:nextSource | → | 下一个 diff 来源 |
diff:previousFile | ↑ | 上一个文件 |
diff:nextFile | ↓ | 下一个文件 |
按键语法
修饰键
用 + 分隔：
ctrl+k # Control + K
shift+tab # Shift + Tab
meta+p # Command/Meta + P
ctrl+shift+c # 多个修饰键支持的修饰键名称：
ctrl或controlalt、opt或optionshiftmeta、cmd或command
大写字母
单独的大写字母默认等于 Shift + 小写字母，即 K 等同于 shift+k（适合 Vim 风格绑定）。
带修饰键时大写不额外加 Shift：ctrl+K 与 ctrl+k 等效。
和弦（连续按键）
用空格分隔两次按键：
ctrl+k ctrl+s # 先按 Ctrl+K，再按 Ctrl+S特殊键名
escape/esc、enter/return、tab、space、up/down/left/right、backspace、delete
解绑默认快捷键
将值设为 null：
json
{
"bindings": [
{
"context": "Chat",
"bindings": {
"ctrl+s": null
}
}
]
}保留快捷键（不可修改）
| 快捷键 | 原因 |
|---|---|
| Ctrl+C | 硬编码的中断/取消 |
| Ctrl+D | 硬编码的退出 |
终端冲突
| 快捷键 | 冲突 |
|---|---|
| Ctrl+B | tmux 前缀键（按两次发送） |
| Ctrl+A | GNU screen 前缀键 |
| Ctrl+Z | Unix 进程暂停（SIGTSTP） |
Vim 模式兼容说明
开启 Vim 模式（/vim）后，快捷键和 Vim 模式独立工作：
- Vim 模式：在文本输入层处理（光标移动、模式切换、操作命令）
- Keybindings：在组件层处理（切换任务列表、提交等）
- Vim 模式下 Escape 切换 INSERT → NORMAL 模式，不触发
chat:cancel - 大多数 Ctrl+键 快捷键会透传到 keybinding 系统
配置验证
Claude Code 会验证你的 keybindings 并给出警告：
- JSON 解析错误
- 无效上下文名称
- 保留快捷键冲突
- 终端复用器冲突
- 同一上下文内重复绑定
运行 /doctor 查看所有键绑定警告。