Skip to main content
此功能目前处于预览阶段，并非所有用户都可使用。
Claude Code 支持可自定义的快捷键。运行 /keybindings 来创建或打开位于 ~/.claude/keybindings.json 的配置文件。

​
配置文件

快捷键配置文件是一个包含 bindings 数组的对象。每个块指定一个上下文和一个按键映射到操作的映射。
快捷键文件的更改会自动检测并应用，无需重启 Claude Code。
字段描述
$schema可选的 JSON Schema URL，用于编辑器自动完成
$docs可选的文档 URL
bindings按上下文分组的绑定块数组
此示例将 Ctrl+E 绑定到在聊天上下文中打开外部编辑器，并取消绑定 Ctrl+U： 
{
  "$schema": "https://code.claude.com/docs/schemas/keybindings.json",
  "$docs": "https://code.claude.com/docs/s/claude-code-keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null
      }
    }
  ]
}

​
上下文

每个绑定块指定一个上下文，其中绑定适用：
上下文描述
Global在应用程序中的任何地方应用
Chat主聊天输入区域
Autocomplete自动完成菜单已打开
Settings设置菜单（仅限 Escape 关闭）
Confirmation权限和确认对话框
Tabs选项卡导航组件
Help帮助菜单可见
Transcript记录查看器
HistorySearch历史搜索模式（Ctrl+R）
Task后台任务正在运行
ThemePicker主题选择器对话框
Attachments图像/附件栏导航
Footer页脚指示器导航（任务、团队、差异）
MessageSelector回退对话框消息选择
DiffDialog差异查看器导航
ModelPicker模型选择器工作量级别
Select通用选择/列表组件
Plugin插件对话框（浏览、发现、管理）

​
可用操作

操作遵循 namespace:action 格式，例如 chat:submit 发送消息或 app:toggleTodos 显示任务列表。每个上下文都有特定的可用操作。

​
应用程序操作

在 Global 上下文中可用的操作：
操作默认描述
app:interruptCtrl+C取消当前操作
app:exitCtrl+D退出 Claude Code
app:toggleTodosCtrl+T切换任务列表可见性
app:toggleTranscriptCtrl+O切换详细记录

​
历史操作

用于导航命令历史的操作：
操作默认描述
history:searchCtrl+R打开历史搜索
history:previousUp上一个历史项
history:nextDown下一个历史项

​
聊天操作

在 Chat 上下文中可用的操作：
操作默认描述
chat:cancelEscape取消当前输入
chat:cycleModeShift+Tab*循环权限模式
chat:modelPickerCmd+P / Meta+P打开模型选择器
chat:thinkingToggleCmd+T / Meta+T切换扩展思考
chat:submitEnter提交消息
chat:undoCtrl+_撤销上一个操作
chat:externalEditorCtrl+G在外部编辑器中打开
chat:stashCtrl+S隐藏当前提示
chat:imagePasteCtrl+V（Windows 上为 Alt+V）粘贴图像
*在没有 VT 模式的 Windows 上（Node <24.2.0/<22.17.0，Bun <1.2.23），默认为 Meta+M。

​
自动完成操作

在 Autocomplete 上下文中可用的操作：
操作默认描述
autocomplete:acceptTab接受建议
autocomplete:dismissEscape关闭菜单
autocomplete:previousUp上一个建议
autocomplete:nextDown下一个建议

​
确认操作

在 Confirmation 上下文中可用的操作：
操作默认描述
confirm:yesY, Enter确认操作
confirm:noN, Escape拒绝操作
confirm:previousUp上一个选项
confirm:nextDown下一个选项
confirm:nextFieldTab下一个字段
confirm:previousField（未绑定）上一个字段
confirm:cycleModeShift+Tab循环权限模式
confirm:toggleExplanationCtrl+E切换权限说明

​
权限操作

在 Confirmation 上下文中可用于权限对话框的操作：
操作默认描述
permission:toggleDebugCtrl+D切换权限调试信息

​
记录操作

在 Transcript 上下文中可用的操作：
操作默认描述
transcript:toggleShowAllCtrl+E切换显示所有内容
transcript:exitCtrl+C, Escape退出记录查看

​
历史搜索操作

在 HistorySearch 上下文中可用的操作：
操作默认描述
historySearch:nextCtrl+R下一个匹配项
historySearch:acceptEscape, Tab接受选择
historySearch:cancelCtrl+C取消搜索
historySearch:executeEnter执行选定的命令

​
任务操作

在 Task 上下文中可用的操作：
操作默认描述
task:backgroundCtrl+B后台当前任务

​
主题操作

在 ThemePicker 上下文中可用的操作：
操作默认描述
theme:toggleSyntaxHighlightingCtrl+T切换语法高亮

​
帮助操作

在 Help 上下文中可用的操作：
操作默认描述
help:dismissEscape关闭帮助菜单

​
选项卡操作

在 Tabs 上下文中可用的操作：
操作默认描述
tabs:nextTab, Right下一个选项卡
tabs:previousShift+Tab, Left上一个选项卡

​
附件操作

在 Attachments 上下文中可用的操作：
操作默认描述
attachments:nextRight下一个附件
attachments:previousLeft上一个附件
attachments:removeBackspace, Delete删除选定的附件
attachments:exitDown, Escape退出附件栏

​
页脚操作

在 Footer 上下文中可用的操作：
操作默认描述
footer:nextRight下一个页脚项
footer:previousLeft上一个页脚项
footer:openSelectedEnter打开选定的页脚项
footer:clearSelectionEscape清除页脚选择

​
消息选择器操作

在 MessageSelector 上下文中可用的操作：
操作默认描述
messageSelector:upUp, K在列表中向上移动
messageSelector:downDown, J在列表中向下移动
messageSelector:topCtrl+Up, Shift+Up, Meta+Up, Shift+K跳到顶部
messageSelector:bottomCtrl+Down, Shift+Down, Meta+Down, Shift+J跳到底部
messageSelector:selectEnter选择消息

​
差异操作

在 DiffDialog 上下文中可用的操作：
操作默认描述
diff:dismissEscape关闭差异查看器
diff:previousSourceLeft上一个差异源
diff:nextSourceRight下一个差异源
diff:previousFileUp差异中的上一个文件
diff:nextFileDown差异中的下一个文件
diff:viewDetailsEnter查看差异详情
diff:back（特定于上下文）在差异查看器中返回

​
模型选择器操作

在 ModelPicker 上下文中可用的操作：
操作默认描述
modelPicker:decreaseEffortLeft降低工作量级别
modelPicker:increaseEffortRight提高工作量级别

​
选择操作

在 Select 上下文中可用的操作：
操作默认描述
select:nextDown, J, Ctrl+N下一个选项
select:previousUp, K, Ctrl+P上一个选项
select:acceptEnter接受选择
select:cancelEscape取消选择

​
插件操作

在 Plugin 上下文中可用的操作：
操作默认描述
plugin:toggleSpace切换插件选择
plugin:installI安装选定的插件

​
设置操作

在 Settings 上下文中可用的操作：
操作默认描述
settings:search/进入搜索模式
settings:retryR重试加载使用数据（出错时）

​
按键语法

​
修饰符

使用修饰符键与 + 分隔符：
  • ctrl 或 control - Control 键
  • alt、opt 或 option - Alt/Option 键
  • shift - Shift 键
  • meta、cmd 或 command - Meta/Command 键
例如： 
ctrl+k          单个键与修饰符
shift+tab       Shift + Tab
meta+p          Command/Meta + P
ctrl+shift+c    多个修饰符

​
大写字母

独立的大写字母意味着 Shift。例如，K 等同于 shift+k。这对于 vim 风格的绑定很有用，其中大写和小写键有不同的含义。 带有修饰符的大写字母（例如 ctrl+K）被视为风格性的，不意味着 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
      }
    }
  ]
}

​
保留快捷键

这些快捷键无法重新绑定：
快捷键原因
Ctrl+C硬编码的中断/取消
Ctrl+D硬编码的退出

​
终端冲突

某些快捷键可能与终端多路复用器冲突：
快捷键冲突
Ctrl+Btmux 前缀（按两次发送）
Ctrl+AGNU screen 前缀
Ctrl+ZUnix 进程暂停（SIGTSTP）

​
Vim 模式交互

启用 vim 模式（/vim）时，快捷键和 vim 模式独立运行：
  • Vim 模式在文本输入级别处理输入（光标移动、模式、动作）
  • 快捷键在组件级别处理操作（切换待办事项、提交等）
  • vim 模式中的 Escape 键从 INSERT 切换到 NORMAL 模式；它不触发 chat:cancel
  • 大多数 Ctrl+key 快捷键通过 vim 模式传递到快捷键系统
  • 在 vim NORMAL 模式中，? 显示帮助菜单（vim 行为）

​
验证

Claude Code 验证您的快捷键并显示以下警告：
  • 解析错误（无效的 JSON 或结构）
  • 无效的上下文名称
  • 保留快捷键冲突
  • 终端多路复用器冲突
  • 同一上下文中的重复绑定
运行 /doctor 查看任何快捷键警告。
Last modified on February 11, 2026