自定义按键映射
VibeKeys Max 有 7 个可编程按键，你可以使用 vibekeys CLI 工具将它们重新映射为任意键盘快捷键、修饰键组合或文本宏。
前置要求
- VibeKeys Max 已通过蓝牙配对（参见 键盘模式）
- 已安装
vibekeysCLI（参见 Claude Code 状态集成）
默认可编程按键
| 按键名称 | 符号 | 默认映射 |
|---|---|---|
MIC | 🎙️ | Option/Alt |
CUSTOM | 🌟 | /compact + Enter |
ESC | ESC | Escape |
NEXT | ⬇️ | Page Down |
BACKSPACE | ⬅️ | Delete |
YOLO | YOLO | SHIFT+TAB |
ACCEPT | Accept | Enter |
基本用法
vibekeys keymap <KEY> <BINDING>
CLI 通过蓝牙连接到 VibeKeys Max，发送新的映射，设备会保存该设置。映射是合并式的——你可以逐个设置，它们会在设备上累积。
绑定类型
单个按键
将按键映射为单个击键：
vibekeys keymap ESC A
vibekeys keymap CUSTOM Enter
vibekeys keymap ACCEPT Space
修饰键组合
使用 + 组合修饰键和按键：
vibekeys keymap ESC Ctrl+C
vibekeys keymap MIC Shift+Alt+Delete
vibekeys keymap CUSTOM Ctrl+Shift+T
vibekeys keymap ACCEPT Cmd+S
支持的修饰键：
| 修饰键 | 别名 |
|---|---|
Ctrl | |
Alt | Option |
Shift | |
Meta | Win、Cmd、Command、GUI |
文本宏
用引号括起来发送文本字符串：
vibekeys keymap CUSTOM '"hello world"'
vibekeys keymap MIC '"git status\n"'
文本宏支持转义序列：
\n-- 换行（按 Enter）\t-- 制表符\xNN-- 十六进制字节
相关文档
- 键盘模式 - 键盘模式入门
- Claude Code 状态集成 - 安装 vibekeys CLI
- 按键说明 - 默认按键参考