VibeKeys Max 键盘模式
键盘模式让 VibeKeys Max 作为蓝牙键盘连接到你的电脑。这是默认模式，只需蓝牙配对即可使用，无需服务器或其他特殊设置。
概述
在键盘模式下，VibeKeys Max 通过蓝牙连接到你的电脑并发送键盘输入。适用于：
- 在桌面专注编程，使用自定义键盘
- 触发编辑器快捷键和 IDE 命令
- 运行重复性宏操作
- 使用旋钮滚动和导航
- 在屏幕上查看 Claude Code 实时状态（需安装插件）
与遥控模式不同，键盘模式不需要 WiFi 或服务器。
开始使用
第一步：蓝牙配对
- 按一下电源键 开启 VibeKeys Max，然后在启动菜单中选择 Keyboard
- 打开蓝牙设置，查看可用设备
- 在设备列表中 找到 "VibeKeys Max"
- 点击连接
- 配对成功后，VibeKeys Max 即可使用
macOS 用户可能会弹出键盘识别窗口，直接关闭即可。
第二步：使用 VibeKeys Max
在终端中打开 Claude Code，VibeKeys Max 即可作为键盘使用。以下是默认按键映射：
| 按键 | 符号 | 默认映射 | 说明 |
|---|---|---|---|
MIC | 🎙️ | Ctrl + Option | 语音听写热键 |
CUSTOM | 🌟 | /compact + Enter | 向 Claude Code 发送 /compact 斜杠命令 |
ESC | ESC | Escape | 取消或返回上一步 |
NEXT | ⬇️ | Page Down | 向下滚动输出内容 |
BACKSPACE | ⬅️ | Delete | 删除前一个字符 |
YOLO | YOLO | Shift + Tab | 允许当前会话中的所有编辑 |
ACCEPT | Accept | Enter | 确认、接受或发送 |
第三步：使用 MIC 键进行语音输入
MIC 键提供两种语音输入方式：
- 内置语音识别——键盘自己录音并识别，再把文字输入出去。在 setup 页面配置一个 Whisper 兼容端点即可，电脑上不用装任何软件。
- 使用电脑上的听写应用——键盘发送一个热键（Ctrl + Option），触发 Typeless、Whispr Flow 等工具。
→ 两种方式的完整配置见键盘模式下的语音输入。
第四步：启用实时状态显示
如果你想在编程时在 VibeKeys 屏幕上查看 Claude Code 的状态更新：
- 安装 vibekeys CLI 和插件（参见 Claude Code 状态集成）
- 设置完成后，设备屏幕会显示 Claude Code 的实时更新
- 无需额外配置——Claude Code 运行时状态会自动显示
此设置需要确保你的 CLI 工具也能访问蓝牙。
相关文档
- 快速入门
- 键盘模式下的语音输入 - 内置语音识别或使用你自己的听写应用
- Claude Code 状态集成
- 按键说明
- 遥控模式