跳到主要内容

VibeKeys Max 键盘模式

键盘模式让 VibeKeys Max 作为蓝牙键盘连接到你的电脑。这是默认模式,只需蓝牙配对即可使用,无需服务器或其他特殊设置。

概述

在键盘模式下,VibeKeys Max 通过蓝牙连接到你的电脑并发送键盘输入。适用于:

  • 在桌面专注编程,使用自定义键盘
  • 触发编辑器快捷键和 IDE 命令
  • 运行重复性宏操作
  • 使用旋钮滚动和导航
  • 在屏幕上查看 Claude Code 实时状态(需安装插件)

与遥控模式不同,键盘模式不需要 WiFi、服务器或语音转文字 API 服务。

开始使用

第一步:蓝牙配对

  1. 按一下电源键 开启 VibeKeys Max,等待设备进入键盘模式
  2. 打开蓝牙设置,查看可用设备
  3. 在设备列表中 找到 "VibeKeys Max"
  4. 点击连接
  5. 配对成功后,VibeKeys Max 即可使用

macOS 用户可能会弹出键盘识别窗口,直接关闭即可。

第二步:使用 VibeKeys Max

在终端中打开 Claude Code,VibeKeys Max 即可作为键盘使用。以下是默认按键映射:

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

第三步:使用 MIC 键进行语音输入

MIC 键发送 Option(macOS)/ Alt(Windows)信号。你可以将语音听写应用的触发快捷键设置为 Option/Alt,这样按下 MIC 键即可开始语音输入——对着麦克风说出你的提示词,文字会直接输入到 Claude Code 中。

Typeless

  1. 打开 Typeless → Settings → Keyboard Shortcuts
  2. 将触发快捷键设置为 Option(macOS)或 Alt(Windows)
  3. 按下 VibeKeys Max 上的 MIC 键即可开始/停止听写

Whispr Flow

  1. 打开 Whispr Flow → Preferences → Shortcuts
  2. 将触发快捷键设置为 Option(macOS)或 Alt(Windows)
  3. 按下 VibeKeys Max 上的 MIC 键即可开始/停止听写

配置完成后,使用流程非常简单:按下 MIC 键,说出提示词,再按一次 MIC 键,语音内容就会出现在终端中。

第四步:启用实时状态显示

如果你想在编程时在 VibeKeys 屏幕上查看 Claude Code 的状态更新:

  1. 安装 vibekeys CLI 和插件(参见 Claude Code 状态集成
  2. 设置完成后,设备屏幕会显示 Claude Code 的实时更新
  3. 无需额外配置——Claude Code 运行时状态会自动显示

此设置需要确保你的 CLI 工具也能访问蓝牙。

相关文档