跳到主要内容

VibeKeys Max 按键说明

本页介绍 VibeKeys Max 的硬件控制、默认按键映射和旋钮功能。

硬件布局​

VibeKeys Max 包括：

  • 电源键，用于开关设备
  • 重启键，用于重启设备
  • USB-C 接口，用于充电或外部供电
  • 两个电源开关，用于选择供电方式

VibeKeys Max 按键布局

侧面和背面控制​

电源键​

使用电源键开关 VibeKeys Max。

  • 按一次开机或唤醒设备
  • 按两次关机
  • 位于设备顶部边缘

重启键​

使用重启键重启 VibeKeys Max。

  • 按一次重启设备
  • 位于设备左侧

USB-C 接口​

使用 USB-C 接口给电池充电或通过线缆供电。

  • 位于设备右侧

电源开关​

使用两个电源开关选择 VibeKeys Max 的供电方式。

有两种供电模式：

  • 电池模式：两个开关都拨到右边
  • USB-C 供电模式：两个开关都拨到左边

默认使用电池模式。如果你想通过线缆直接供电而不使用电池，请切换到 USB-C 供电模式。

默认按键映射​

下表显示了键盘模式和遥控模式共用的默认按键映射。

按键符号默认映射说明
MIC🎙️Option / Alt修饰键，用于快捷键组合
CUSTOM🌟/compact + Enter向 Claude Code 发送 /compact 斜杠命令
ESCESCEscape取消或返回上一步
NEXT⬇️Page Down向下滚动输出内容
BACKSPACE⬅️Delete删除前一个字符
YOLOYOLOShift + Tab允许当前会话中的所有编辑
ACCEPTAcceptEnter确认、接受或发送

按键详情​

🎙️ MIC​

默认：Option / Alt

作为修饰键使用。与其他按键组合触发快捷键。例如，在许多编辑器中，Option + 方向键可以按单词移动光标。

🌟 CUSTOM​

默认：/compact + Enter

向 Claude Code 发送 /compact 斜杠命令并按下 Enter。一键切换 Claude Code 到紧凑模式。

ESC​

默认：Escape

按 ESC 取消或返回：

  • 取消待发送的输入
  • 关闭 Claude Code 中的选择
  • 不确认即离开当前步骤

特殊功能：OTA 固件更新

  • 设备启动时按 ESC 进入 OTA（空中下载）更新模式
  • 设备屏幕会显示 WiFi 更新 URL
  • 参见 更新固件 了解完整说明

⬇️ NEXT​

默认：Page Down

在终端或 Claude Code 响应中向下滚动，特别适合 Claude 生成较长代码或说明时使用。

⬅️ BACKSPACE​

默认：Delete

删除前一个字符。与标准键盘上的 Backspace 键功能相同。

YOLO​

默认：Shift + Tab

在 Claude Code 中，Shift + Tab 允许当前会话中的所有编辑，无需逐一确认。YOLO 标签提醒你正在授予 Claude 完全的编辑权限。

Accept​

默认：Enter

按 Accept 确认或发送：

  • 向 Claude Code 发送提示词
  • 接受建议
  • 确认选中的操作

特殊功能：进入遥控模式

  • 设备启动时按 Accept 进入遥控模式。进入前，请先在 setup 页面 配置好 WiFi 和 vibetty server URL。

旋钮​

旋钮是主要的导航控制器。

  • 上下旋转可滚动输出内容或浏览菜单
  • 按下旋钮选择高亮项目
  • 用于在 OLED 屏幕上滚动较长的 Claude Code 响应

实际使用中，旋钮可以替代大量的方向键和鼠标滚轮操作。

自定义按键（仅键盘模式）​

在键盘模式下，所有 7 个可编程按键都可以使用 vibekeys CLI 重新映射为任意键盘快捷键、修饰键组合或文本宏：

vibekeys keymap <KEY> <BINDING>
备注

使用 vibekeys CLI 自定义按键只影响键盘模式。无论你做了什么自定义，遥控模式始终使用上表所示的默认按键映射。

参见 自定义按键 获取完整指南和示例。

相关文档​