VibeKeys Max 快速入门
VibeKeys Max 是一款为使用 Claude Code 等 AI 编程助手的开发者打造的编程键盘。
固件 v0.4.0 与 vibetty 0.4.x 是配套的一组:它们使用全新的 MQTT 协议,v0.4.0 与之前的版本不兼容。请确保设备运行 v0.4.0+ 固件,电脑运行 vibetty 0.4.x。
设备还在 0.3.x 固件?请使用旧版 setup 页面 vibekeys.dev/setup03,继续使用 vibetty 0.3.x,并通过页面顶部的版本下拉框切换到 0.3.x 版文档。
选择你的模式
VibeKeys Max 开机后会显示启动菜单,包含三个入口——Keyboard(键盘)、Remote(遥控) 和 Setting(设置)。用 NEXT 键移动、ESC 键返回、ACCEPT 键确认。
键盘模式（默认）
适用场景： 在桌面直接输入、编写代码、实时查看 Claude Code 状态。
在键盘模式下，VibeKeys Max 通过蓝牙连接，充当一个带有自定义快捷键的键盘。在启动菜单中选择 Keyboard,连接后即可在设备屏幕上实时查看 Claude Code 的状态更新。
功能特点：
- 蓝牙连接（无需 WiFi）
- 屏幕实时显示 Claude Code 状态
- 自定义键盘快捷键和宏
- 可选：通过插件集成 Claude Code 状态
- 适合专注的桌面编程
→ 从 键盘模式 开始
遥控模式
适用场景： 远距离编程、演示、代码审查或免提语音控制——只要有 WiFi 就能用。
在启动菜单中选择 Remote。在遥控模式下，VibeKeys Max 通过 MQTT broker 连接到你的电脑——电脑上无需暴露任何端口——可以用语音输入和物理按键控制 Claude Code 或 OpenAI Codex。配套程序 vibetty 负责共享终端会话,你正在运行的每个会话都会出现在设备的会话列表中,转一下旋钮即可切换。
首次使用前，请先在 setup 页面 配置好 WiFi 和 MQTT broker 地址。
功能特点：
- 随处可用——办公室、咖啡馆或手机热点
- 所有 agent 会话同屏显示,带实时 working/waiting 状态
- 内置语音识别(音频流式发送到你配置的 Whisper 端点)
- 完全遥控 Claude Code 或 OpenAI Codex
→ 查看 遥控模式 了解更多
识别你的版本
VibeKeys Max 有两个硬件版本。它们共享相同的软件和功能——唯一的区别是屏幕尺寸和固件文件。
V1——更宽、接近方形的屏幕
V2——更窄、更高的屏幕
| V1 | V2 | |
|---|---|---|
| 屏幕 | 1.69 英寸（240×280） | 1.47 英寸（172×320） |
| 完整固件镜像 | vibekeys.bin | vibekeys_max2.bin |
| OTA 镜像（已在 0.4.x 的设备） | vibekeys_ota.bin | vibekeys_max2_ota.bin |
V1 和 V2 之间除屏幕和固件文件外，其他硬件、软件和功能完全相同。
开始之前
如果你还没有组装设备，请先查看 组装你的 VibeKeys Max。
演示
观看演示视频，了解 VibeKeys Max 遥控模式的实际使用效果：