SuperAPI AI 工具集

keybindings-help

办公与效率

查看项目

更新于 10-24 16:19

技能介绍

keybindings-help 是一个面向 Claude Code 的键盘快捷键定制技能,用于创建或修改 ~/.claude/keybindings.json 配置文件,从而自定义终端中的键盘快捷键、快捷映射或按键组合。

用途:当需要调整 Claude Code 终端快捷键时使用该技能,包括重新绑定按键、添加组合键(chord)、以及取消默认快捷键。

主要能力:

  • 管理 ~/.claude/keybindings.json 配置文件,文件中需始终包含 $schema 和 $docs 字段,以及 bindings 数组。
  • 支持按键语法:修饰键 ctrl(别名 control)、alt(别名 opt、option)、shift、meta(别名 cmd、command);特殊键包括 escape/esc、enter/return、tab、space、backspace、delete、方向键等;支持以空格分隔的组合键,例如 ctrl+k ctrl+s,按键之间约有 1 秒超时。
  • 支持解绑默认快捷键:将某个键设为 null 即可移除其默认绑定。
  • 说明用户绑定与默认绑定的关系:用户绑定为追加式,位于默认绑定之后;若要替换默认绑定,需先解绑旧键再添加新绑定。
  • 提供可用上下文清单,如 Global、Chat、Autocomplete、Confirmation、Help、Transcript、HistorySearch、Task、ThemePicker、Settings、Tabs、Attachments、Footer、MessageSelector、DiffDialog、ModelPicker、Select、Plugin、Scroll、Doctor 等。
  • 提供可用动作清单及默认按键,例如 app:interrupt、app:exit、app:toggleTodos、history:search、chat:submit、chat:newline、chat:externalEditor、autocomplete:accept 等。
  • 通过 /doctor 命令中的 Keybinding Configuration Issues 部分校验配置,列出错误(如缺少 bindings 数组、未知上下文、同一上下文重复键、非法按键语法、动作值非字符串或 null)和警告(如与终端或系统保留快捷键冲突)。

使用方式:先读取 ~/.claude/keybindings.json(文件可能尚不存在),将改动与现有绑定合并,绝不整文件替换;修改已有文件用 Edit 工具,仅在文件不存在时用 Write 工具。配置中只包含用户想改动的上下文,保持最小覆盖;新增动作绑定时为追加式,除非显式解绑,否则默认绑定仍然生效。

适用场景:重新绑定某个快捷键、为动作添加组合键、取消不需要的默认快捷键、排查快捷键不生效的配置问题。

限制与注意事项:部分快捷键不可重绑,包括 ctrl+c(中断/退出,硬编码)、ctrl+d(退出,硬编码)、ctrl+m(终端中等同 Enter)、capslock(终端应用收不到);ctrl+z 可能与 Unix 进程挂起冲突,ctrl+\ 为终端退出信号;macOS 上 cmd+c、cmd+v、cmd+x、cmd+q、cmd+w、cmd+tab、cmd+space 为系统保留。选择按键时应主动提示与 tmux(ctrl+b)、screen(ctrl+a)等常见工具或保留快捷键的冲突。错误会导致绑定不生效,必须修复;警告表示潜在冲突,绑定可能仍可用。