Claude Code官方文档快捷键keybindings

Claude Code 快捷键自定义教程 - keybindings.json 完整配置

使用快捷键配置文件在 Claude Code 中自定义快捷键。

发布于 2025年5月1日 · 阅读约 17 分钟

ℹ️ 可自定义的快捷键需要 Claude Code v2.1.18 或更高版本。使用 claude --version 检查您的版本。

Claude Code 支持可自定义的快捷键。运行 /keybindings 来创建或打开位于 ~/.claude/keybindings.json 的配置文件。

配置文件

快捷键配置文件是一个包含 bindings 数组的对象。每个块指定一个上下文和一个按键映射到操作的映射。

ℹ️ 快捷键文件的更改会自动检测并应用，无需重启 Claude Code。

字段	描述
`$schema`	可选的 JSON Schema URL，用于编辑器自动完成
`$docs`	可选的文档 URL
`bindings`	按上下文分组的绑定块数组

此示例将 Ctrl+E 绑定到在聊天上下文中打开外部编辑器，并取消绑定 Ctrl+U：

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/zh-CN/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null
      }
    }
  ]
}

上下文

每个绑定块指定一个上下文，其中绑定适用：

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

可用操作

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

应用程序操作

在 Global 上下文中可用的操作：

操作	默认	描述
`app:interrupt`	Ctrl+C	取消当前操作
`app:exit`	Ctrl+D	退出 Claude Code
`app:redraw`	（未绑定）	强制终端重绘
`app:toggleTodos`	Ctrl+T	切换任务列表可见性
`app:toggleTranscript`	Ctrl+O	切换详细记录

历史操作

用于导航命令历史的操作：

操作	默认	描述
`history:search`	Ctrl+R	打开历史搜索
`history:previous`	Up	上一个历史项
`history:next`	Down	下一个历史项

聊天操作

在 Chat 上下文中可用的操作：

操作	默认	描述
`chat:cancel`	Escape	取消当前输入
`chat:clearInput`	Ctrl+L	强制全屏重绘，保留输入
`chat:clearScreen`	Cmd+K	在全屏渲染中，在两秒内按两次以运行 `/clear`
`chat:killAgents`	Ctrl+X Ctrl+K	终止所有后台代理
`chat:cycleMode`	Shift+Tab*	循环权限模式
`chat:modelPicker`	Meta+P	打开模型选择器
`chat:fastMode`	Meta+O	切换快速模式
`chat:thinkingToggle`	Meta+T	切换扩展思考
`chat:submit`	Enter	提交消息
`chat:newline`	Ctrl+J	插入换行符而不提交
`chat:undo`	Ctrl+_, Ctrl+Shift+-	撤销上一个操作
`chat:externalEditor`	Ctrl+G, Ctrl+X Ctrl+E	在外部编辑器中打开
`chat:stash`	Ctrl+S	隐藏当前提示
`chat:imagePaste`	Ctrl+V（Windows 上为 Alt+V）	粘贴图像

*在没有 VT 模式的 Windows 上（Node <24.2.0/<22.17.0，Bun <1.2.23），默认为 Meta+M。

自动完成操作

在 Autocomplete 上下文中可用的操作：

操作	默认	描述
`autocomplete:accept`	Tab	接受建议
`autocomplete:dismiss`	Escape	关闭菜单
`autocomplete:previous`	Up	上一个建议
`autocomplete:next`	Down	下一个建议

确认操作

在 Confirmation 上下文中可用的操作：

操作	默认	描述
`confirm:yes`	Y, Enter	确认操作
`confirm:no`	N, Escape	拒绝操作
`confirm:previous`	Up	上一个选项
`confirm:next`	Down	下一个选项
`confirm:nextField`	Tab	下一个字段
`confirm:previousField`	（未绑定）	上一个字段
`confirm:toggle`	Space	切换选择
`confirm:cycleMode`	Shift+Tab	循环权限模式
`confirm:toggleExplanation`	Ctrl+E	切换权限说明

权限操作

在 Confirmation 上下文中可用的权限对话框操作：

操作	默认	描述
`permission:toggleDebug`	Ctrl+D	切换权限调试信息

记录操作

在 Transcript 上下文中可用的操作：

操作	默认	描述
`transcript:toggleShowAll`	Ctrl+E	切换显示所有内容
`transcript:exit`	q, Ctrl+C, Escape	退出记录查看

历史搜索操作

在 HistorySearch 上下文中可用的操作：

操作	默认	描述
`historySearch:next`	Ctrl+R	下一个匹配项
`historySearch:accept`	Escape, Tab	接受选择
`historySearch:cancel`	Ctrl+C	取消搜索
`historySearch:execute`	Enter	执行选定的命令
`historySearch:cycleScope`	Ctrl+S	循环范围：会话、项目、任何地方

任务操作

在 Task 上下文中可用的操作：

操作	默认	描述
`task:background`	Ctrl+B	后台当前任务

主题操作

在 ThemePicker 上下文中可用的操作：

操作	默认	描述
`theme:toggleSyntaxHighlighting`	Ctrl+T	切换语法高亮

帮助操作

在 Help 上下文中可用的操作：

操作	默认	描述
`help:dismiss`	Escape	关闭帮助菜单

Tabs 操作

在 Tabs 上下文中可用的操作：

操作	默认	描述
`tabs:next`	Tab, Right	下一个选项卡
`tabs:previous`	Shift+Tab, Left	上一个选项卡

附件操作

在 Attachments 上下文中可用的操作：

操作	默认	描述
`attachments:next`	Right	下一个附件
`attachments:previous`	Left	上一个附件
`attachments:remove`	Backspace, Delete	删除选定的附件
`attachments:exit`	Down, Escape	退出附件导航

页脚操作

在 Footer 上下文中可用的操作：

操作	默认	描述
`footer:next`	Right	下一个页脚项
`footer:previous`	Left	上一个页脚项
`footer:up`	Up	在页脚中向上导航（在顶部取消选择）
`footer:down`	Down	在页脚中向下导航
`footer:openSelected`	Enter	打开选定的页脚项
`footer:clearSelection`	Escape	清除页脚选择

消息选择器操作

在 MessageSelector 上下文中可用的操作：

操作	默认	描述
`messageSelector:up`	Up, K, Ctrl+P	在列表中向上移动
`messageSelector:down`	Down, J, Ctrl+N	在列表中向下移动
`messageSelector:top`	Ctrl+Up, Shift+Up, Meta+Up, Shift+K	跳到顶部
`messageSelector:bottom`	Ctrl+Down, Shift+Down, Meta+Down, Shift+J	跳到底部
`messageSelector:select`	Enter	选择消息

Diff 操作

在 DiffDialog 上下文中可用的操作：

操作	默认	描述
`diff:dismiss`	Escape	关闭差异查看器
`diff:previousSource`	Left	上一个差异源
`diff:nextSource`	Right	下一个差异源
`diff:previousFile`	Up	差异中的上一个文件
`diff:nextFile`	Down	差异中的下一个文件
`diff:viewDetails`	Enter	查看差异详情
`diff:back`	（特定于上下文）	在差异查看器中返回

模型选择器操作

在 ModelPicker 上下文中可用的操作：

操作	默认	描述
`modelPicker:decreaseEffort`	Left	降低工作量级别
`modelPicker:increaseEffort`	Right	提高工作量级别

选择操作

在 Select 上下文中可用的操作：

操作	默认	描述
`select:next`	Down, J, Ctrl+N	下一个选项
`select:previous`	Up, K, Ctrl+P	上一个选项
`select:accept`	Enter	接受选择
`select:cancel`	Escape	取消选择

Plugin 操作

在 Plugin 上下文中可用的操作：

操作	默认	描述
`plugin:toggle`	Space	切换插件选择
`plugin:install`	I	安装选定的插件
`plugin:favorite`	F	将选定的插件标记为收藏，使其在”已安装”选项卡顶部附近排序

设置操作

在 Settings 上下文中可用的操作：

操作	默认	描述
`settings:search`	/	进入搜索模式
`settings:retry`	R	重试加载使用数据（出错时）
`settings:close`	Enter	保存更改并关闭配置面板。Escape 放弃更改并关闭

Doctor 操作

在 Doctor 上下文中可用的操作：

操作	默认	描述
`doctor:fix`	F	将诊断报告发送给 Claude 以修复报告的问题。仅在发现问题时活跃

语音操作

在启用语音听写时，在 Chat 上下文中可用的操作：

操作	默认	描述
`voice:pushToTalk`	Space	听写提示。根据 `/voice` 模式按住或点击

滚动操作

在启用全屏渲染时，在 Scroll 上下文中可用的操作：

操作	默认	描述
`scroll:lineUp`	（未绑定）	向上滚动一行。鼠标滚轮滚动触发此操作
`scroll:lineDown`	（未绑定）	向下滚动一行。鼠标滚轮滚动触发此操作
`scroll:pageUp`	PageUp	向上滚动视口高度的一半
`scroll:pageDown`	PageDown	向下滚动视口高度的一半
`scroll:top`	Ctrl+Home	跳到对话的开始
`scroll:bottom`	Ctrl+End	跳到最新消息并重新启用自动跟随
`scroll:halfPageUp`	（未绑定）	向上滚动视口高度的一半
`scroll:halfPageDown`	（未绑定）	向下滚动视口高度的一半
`scroll:fullPageUp`	（未绑定）	向上滚动整个视口高度
`scroll:fullPageDown`	（未绑定）	向下滚动整个视口高度
`selection:copy`	Ctrl+Shift+C / Cmd+C	将选定的文本复制到剪贴板
`selection:clear`	（未绑定）	清除活动的文本选择
`selection:extendLeft`	Shift+Left	将活动选择向左扩展一列
`selection:extendRight`	Shift+Right	将活动选择向右扩展一列
`selection:extendUp`	Shift+Up	将活动选择向上扩展一行
`selection:extendDown`	Shift+Down	将活动选择向下扩展一行
`selection:extendLineStart`	Shift+Home	将活动选择扩展到行的开始
`selection:extendLineEnd`	Shift+End	将活动选择扩展到行的结束

按键语法

修饰符

使用修饰符键和 + 分隔符：

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。

例如：

ctrl+k          Ctrl + K
shift+tab       Shift + Tab
meta+p          macOS 上的 Option + P，其他地方的 Alt + 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
      }
    }
  ]
}

这也适用于和弦绑定。取消绑定共享前缀的每个和弦会释放该前缀以用作单键绑定：

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

如果您取消绑定前缀上的某些但不是全部和弦，按下前缀仍会进入和弦等待模式以处理剩余的绑定。

保留的快捷键

这些快捷键无法重新绑定：

快捷键	原因
Ctrl+C	硬编码的中断/取消
Ctrl+D	硬编码的退出
Ctrl+M	与终端中的 Enter 相同（都发送 CR）
Caps Lock	不传递到终端应用程序

终端冲突

某些快捷键可能与终端多路复用器冲突：

快捷键	冲突
Ctrl+B	tmux 前缀（按两次发送）
Ctrl+A	GNU screen 前缀
Ctrl+Z	Unix 进程暂停（SIGTSTP）

Vim 模式交互

启用 vim 模式（通过 /config → 编辑器模式）时，快捷键和 vim 模式独立运行：

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

验证

Claude Code 验证您的快捷键并显示以下警告：

解析错误（无效的 JSON 或结构）
无效的上下文名称
保留快捷键冲突
终端多路复用器冲突
同一上下文中的重复绑定

运行 /doctor 查看任何快捷键警告。

本文翻译自 Anthropic Claude Code 官方文档，最近一次同步：2025-05-01。