自定义键盘快捷键

通过键绑定配置文件自定义 CSC 的键盘快捷键。

注意： 自定义键盘快捷键需要 CSC v2.1.18 或更高版本。使用 claude --version 检查你的版本。

CSC 支持自定义键盘快捷键。运行 /keybindings 可创建或打开配置文件 ~/.costrict/keybindings.json。

配置文件

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

注意： 对键绑定文件的更改会被自动检测并应用，无需重启 CSC。

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

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

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://costrict.ai/docs/en/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`	全屏模式下的对话滚动和文本选择

可用操作

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

应用操作

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

操作	默认	描述
`app:interrupt`	Ctrl+C	取消当前操作
`app:exit`	Ctrl+D	退出 CSC
`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:killAgents`	Ctrl+X Ctrl+K	终止所有后台代理
`chat:cycleMode`	Shift+Tab*	循环切换权限模式
`chat:modelPicker`	Cmd+P / Meta+P	打开模型选择器
`chat:fastMode`	Meta+O	切换快速模式
`chat:thinkingToggle`	Cmd+T / Meta+T	切换扩展思考
`chat:submit`	Enter	提交消息
`chat:newline`	(未绑定)	插入换行符而不提交
`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	执行选中的命令

任务操作

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

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

主题操作

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

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

帮助操作

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

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

标签页操作

在 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	选择消息

差异操作

在 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:toggle`	Space	切换插件选择
`plugin:install`	I	安装选中的插件

设置操作

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

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

语音操作

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

操作	默认	描述
`voice:pushToTalk`	Space	按住以口述提示

滚动操作

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

操作	默认	描述
`scroll:lineUp`	(未绑定)	向上滚动一行。鼠标滚轮滚动会触发此操作
`scroll:lineDown`	(未绑定)	向下滚动一行。鼠标滚轮滚动会触发此操作
`scroll:pageUp`	PageUp	向上滚动半个视口高度
`scroll:pageDown`	PageDown	向下滚动半个视口高度
`scroll:top`	Ctrl+Home	跳到对话开头
`scroll:bottom`	Ctrl+End	跳到最新消息并重新启用自动跟随
`scroll:halfPageUp`	(未绑定)	向上滚动半个视口高度。与 `scroll:pageUp` 行为相同，为 vi 风格重绑定提供
`scroll:halfPageDown`	(未绑定)	向下滚动半个视口高度。与 `scroll:pageDown` 行为相同，为 vi 风格重绑定提供
`scroll:fullPageUp`	(未绑定)	向上滚动整个视口高度
`scroll:fullPageDown`	(未绑定)	向下滚动整个视口高度
`selection:copy`	Ctrl+Shift+C / Cmd+C	将选中的文本复制到剪贴板
`selection:clear`	(未绑定)	清除活动的文本选择

按键语法

修饰键

使用 + 分隔符组合修饰键：

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
      }
    }
  ]
}

这也适用于组合键绑定。取消绑定共享前缀的所有组合键可释放该前缀作为单键绑定使用：

{
  "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）

终端冲突

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

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

Vim 模式交互

通过 /config → 编辑器模式启用 vim 模式时，键绑定和 vim 模式独立运行：

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

验证

CSC 会验证你的键绑定并在以下情况显示警告：

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

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

配置文件​

上下文​

可用操作​

应用操作​

历史操作​

聊天操作​

自动补全操作​

确认操作​

权限操作​

聊天记录操作​

历史搜索操作​

任务操作​

主题操作​

帮助操作​

标签页操作​

附件操作​

底部栏操作​

消息选择器操作​

差异操作​

模型选择器操作​

选择操作​

插件操作​

设置操作​

语音操作​

滚动操作​

按键语法​

修饰键​

大写字母​

组合键​

特殊键​

取消绑定默认快捷键​

保留快捷键​

终端冲突​

Vim 模式交互​

验证​