教程

Claude Code 键盘快捷键完全指南:自定义快捷键、全部默认键位速查与 keybindings.json 配置

Claude Code 键盘快捷键完全指南:/keybindings 命令、keybindings.json 配置格式、全部 18 个 Context 说明(Chat/Global/Autocomplete/Confirmation/Task 等)、所有默认键位速查表(全局/历史/聊天/确认/任务),以及解绑键位的 null 配置和 JSON Schema 编辑器自动补全。

2026/3/45分钟 阅读ClaudeEagle

Claude Code 支持完全自定义键盘快捷键。运行 /keybindings 创建或打开 ~/.claude/keybindings.json 配置文件,即可修改任意按键绑定。

配置文件格式

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
      }
    }
  ]
}
字段说明
$schemaJSON Schema URL,提供编辑器自动补全
$docs文档链接
bindings绑定块数组,每个块指定一个 Context
context绑定生效的界面上下文

将某个按键设为 null 即可解绑该快捷键(如上面的 ctrl+u)。

Context 上下文一览

Context说明
Global全局生效,任何界面状态下均有效
Chat主聊天输入区域
Autocomplete自动补全菜单打开时
Settings设置菜单(只允许 Escape 关闭)
Confirmation权限确认和确认对话框
TabsTab 导航组件
Help帮助菜单可见时
Transcript对话记录查看器
HistorySearch历史搜索模式(Ctrl+R)
Task后台任务运行时
ThemePicker主题选择对话框
Attachments图片/附件导航栏
Footer底部指示器(任务、团队、差异)
MessageSelector消息倒回和摘要对话框的消息选择
DiffDialog差异查看器导航
ModelPicker模型选择器努力级别
Select通用选择/列表组件
Plugin插件对话框(浏览、发现、管理)

全部默认键位速查

全局(Global)

动作默认键位说明
app:interruptCtrl+C取消当前操作
app:exitCtrl+D退出 Claude Code
app:toggleTodosCtrl+T切换任务列表显示
app:toggleTranscriptCtrl+O切换详细对话记录

历史记录(History)

动作默认键位说明
history:searchCtrl+R打开历史搜索
history:previous上一条历史
history:next下一条历史

聊天输入(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)粘贴图片

自动补全(Autocomplete)

动作默认键位说明
autocomplete:acceptTab接受建议
autocomplete:dismissEscape关闭菜单
autocomplete:previous上一个建议
autocomplete:next下一个建议

确认对话框(Confirmation)

动作默认键位说明
confirm:yesY / Enter确认操作
confirm:noN / Escape拒绝操作
confirm:previous上一个选项
confirm:next下一个选项
confirm:nextFieldTab下一个字段
confirm:cycleModeShift+Tab循环权限模式
confirm:toggleExplanationCtrl+E切换权限说明
permission:toggleDebugCtrl+D切换权限调试信息

任务与后台(Task)

动作默认键位说明
task:backgroundCtrl+B将当前任务转入后台

历史搜索(HistorySearch)

动作默认键位说明
historySearch:nextCtrl+R下一个匹配
historySearch:acceptEscape / Tab接受选择
historySearch:cancelCtrl+C取消搜索
historySearch:executeEnter执行选中命令

对话记录(Transcript)

| 动作 | 默认键位 | 说明 | |-----------------------------|--------------------|--------------------|| | transcript:toggleShowAll | Ctrl+E | 切换显示全部内容 | | transcript:exit | Ctrl+C / Escape | 退出记录查看 |

自定义示例

示例 1:重新绑定外部编辑器

将打开外部编辑器从 Ctrl+G 改为 Ctrl+E,并解绑 Ctrl+G

json
{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+g": null
      }
    }
  ]
}

示例 2:全局自定义

json
{
  "bindings": [
    {
      "context": "Global",
      "bindings": {
        "ctrl+b": "app:toggleTodos"
      }
    },
    {
      "context": "Chat",
      "bindings": {
        "ctrl+enter": "chat:submit",
        "enter": null
      }
    }
  ]
}

这个配置将提交改为 Ctrl+Enter,让普通 Enter 只换行,非常适合习惯多行编辑的用户。

使用 JSON Schema 获得编辑器补全

添加 $schema 字段后,VS Code 等支持 JSON Schema 的编辑器会提供:

  • 所有可用 Action 的自动补全
  • 按键格式验证
  • 悬停文档提示
json
{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json"
}

原文:Customize keyboard shortcuts - Claude Code Docs | 来源:Anthropic 官方文档

相关文章推荐

教程Claude Code Status Line 完全指南:自定义状态栏显示 Context 用量、Git 状态与费用追踪Claude Code Status Line 完全指南:/statusline 自然语言生成脚本、手动 settings.json 配置、stdin JSON 数据结构详解(model/context_window/git/session 字段)、Context 彩色进度条、Git 状态着色、费用时长追踪、多行状态栏实战脚本,以及缓存优化和故障排查。2026/3/4教程Claude Code Skills 进阶:动态上下文注入、路径限定激活和 Subagent 集成深度指南Claude Code Skills 三个高级特性深度指南:动态上下文注入(!! 命令预处理原理、内联和多行语法、实战健康检查 Skill 含 6 个命令块、安全注意事项);路径限定自动激活(TypeScript 严格模式/SQL 安全/React 组件三个实战示例);context: fork 在 Subagent 运行(适用场景判断、agent 类型选择);以及三种特性组合的完整 PR 审查 Skill 示例。2026/5/10教程Claude Code Skills 官方完整指南:从入门到高级模式的权威教程Claude Code Skills 官方文档完整中文整理:Skills vs CLAUDE.md 核心区别;目录结构;存储位置和优先级;实时变更检测和 Monorepo 自动发现;完整 Frontmatter 字段参考(20+字段);字符串替换(动态参数);内容类型(参考类 vs 任务类);调用控制表;Skill 内容生命周期(压缩保留机制);三个高级模式(动态注入/路径限定/Subagent运行);以及内置 Bundled Skills 和权限控制方法。2026/5/10教程Claude Code Slack 集成完整指南:团队协作、CI 通知和权限管理Claude Code Slack 集成完整指南:5 大核心功能(频道触发任务/代码问答/CI 通知/PR 审查/Routines 结果推送);安装配置步骤;4 个权限等级(read/write/execute/pr)及频道级配置;人工审批工作流;GitHub Actions + Slack 通知自动化;4 个团队协作场景(新人上手/PM 提需求/频道分工规范/结构化请求模板);以及官方 Slack 集成 vs OpenClaw 方案的对比。2026/5/8教程Claude Code 定时任务完整指南:/schedule、Routines 三种触发方式和 /loop 监控/schedule 命令和 Routines 完整指南:/schedule 创建/查看/运行/编辑/删除定时任务;Routines 三种触发方式(Cron 定时/GitHub 事件/Webhook API /fire 端点);4 个实战 Routine 配置(每日健康检查/PR 自动质量门/每周技术债扫描/CI 失败分析);/loop 会话内定期重复(vs /schedule 的区别对比);Routines 访问权限配置(GitHub/Slack/数据库);以及 Routines + ultrareview/Hooks/Subagents 的组合用法。2026/5/8教程Claude Code Sub-agents 官方完整指南:内置 Agent、自定义配置、并行模式和 Fork 会话Claude Code Sub-agents 官方文档完整整理:解决的核心问题(保护上下文/成本控制);三个内置 Sub-agent(Explore/Plan/General-purpose 及各自模型和工具);/agents 创建流程(界面/描述生成/工具选择/持久内存配置);完整 Frontmatter 字段参考;模型选择策略(Haiku 探索→Sonnet 审查→Opus 复杂任务);MCP 服务器限定到 Sub-agent;自动委托 vs 显式调用;前台/后台运行;隔离高容量/并行调研/链式 Sub-agent 三种模式;Fork 会话(与命名 Sub-agent 的区别);以及 4 个官方示例配置。2026/5/8