文档索引

在此处获取完整文档索引：https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面，然后再进一步探索。

自定义键盘快捷键

使用按键绑定配置文件自定义 Claude Code 中的键盘快捷键。

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

配置文件

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

此示例将 Ctrl+E 绑定为在聊天上下文中打开外部编辑器，并取消绑定 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
      }
    }
  ]
}

上下文

每个绑定块指定绑定适用的上下文：

可用操作

操作遵循 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 上下文中可用的操作：

差异详细视图还将分页器样式的键绑定到标准滚动操作。这些绑定是 DiffDialog 上下文的一部分，仅在详细视图中适用；滚动操作下列出的 Scroll 上下文默认值不变。

模型选择器操作

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

选择操作

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

插件操作

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

设置操作

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

诊断操作

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

语音操作

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

滚动操作

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

按键语法

修饰键

使用 + 分隔符与修饰键：

• 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          Option + P on macOS, Alt + P elsewhere
ctrl+shift+c    Multiple modifiers

大写字母

单独的大写字母隐含 Shift。例如，K 等同于 shift+k。这对于 vim 风格的绑定很有用，其中大写和小写键具有不同的含义。

带修饰键的大写字母（例如 ctrl+K）被视为风格性的，不隐含 Shift：ctrl+K 与 ctrl+k 相同。

和弦

和弦是用空格分隔的按键序列：

ctrl+k ctrl+s   Press Ctrl+K, release, then 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 → 编辑器模式启用 vim 模式时，按键绑定和 vim 模式独立运行：

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

验证

Claude Code 会验证你的按键绑定并显示以下警告：

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

运行 /doctor 可查看任何按键绑定警告。