跳到主要内容

VibeKeys Max 遥控模式

在遥控模式下，VibeKeys Max 通过 WiFi 连接到你的电脑，让你可以用语音输入和物理按键来控制 Claude Code 或 OpenAI Codex。

如果你想使用 Whisper 以外的语音转文字方案，请参阅 使用 Vosk 进行语音转文字。

准备工作​

前置要求
  • 已预装固件的 VibeKeys Max
  • 运行 macOS、Windows 或 Linux 的电脑
  • Claude Code 2.1.0 或更新版本，或 OpenAI Codex
  • 电脑和 VibeKeys Max 都能连接的本地 WiFi 网络
  • Rust 和 Cargo（用于从源码编译 vibetty），或已编译的 vibetty 二进制文件

第一步：使用 vibetty 启动编程助手服务器​

vibetty 是 VibeKeys Max 和你的编程助手（Claude Code 或 OpenAI Codex）之间的本地桥梁。在配对设备之前，先在电脑上启动它。

方式 A：从源码编译并运行​

git clone https://github.com/second-state/vibetty.git
cd vibetty

创建 .env 文件用于语音转文字：

ASR_API_KEY=your_api_key_here
ASR_URL=https://api.groq.com/openai/v1/audio/transcriptions
ASR_MODEL=whisper-large-v3
ASR_LANG=en
ASR_PROMPT=

RUST_LOG="info,vibetty=debug"
VIBETTY_EXIT_COMMAND="Bye"

编译并运行服务器：

cargo build --release
./target/release/vibetty -- claude

如果你不想使用 Whisper，请参阅 使用 Vosk 进行语音转文字 了解浏览器端 WebVosk 设置。

下载 vibetty 二进制文件​

从 vibetty releases 页面 获取最新的预编译二进制文件，或使用下面的命令。

macOS（M 芯片）​

curl -LO https://github.com/second-state/vibetty/releases/latest/download/vibetty-macos-arm64
chmod +x vibetty-macos-arm64
sudo mv vibetty-macos-arm64 /usr/local/bin/vibetty

Windows​

Invoke-WebRequest -Uri "https://github.com/second-state/vibetty/releases/latest/download/vibetty-windows-x64.exe" -OutFile "vibetty.exe"
# 添加到 PATH，或移动到 PATH 中的某个目录

Linux​

wget https://github.com/second-state/vibetty/releases/latest/download/vibetty-linux-x64
chmod +x vibetty-linux-x64
sudo mv vibetty-linux-x64 /usr/local/bin/vibetty

方式 B：运行已编译的二进制文件​

如果你已有编译好的 vibetty 二进制文件，创建相同的 .env 文件，然后在 -- 后面指定编程助手 —— claude 对应 Claude Code，codex 对应 OpenAI Codex：

./vibetty -- claude   # Claude Code
./vibetty -- codex    # OpenAI Codex

如果你更喜欢不需要 API 密钥的方案，请参阅 使用 Vosk 进行语音转文字。

你应该会看到一个新的 Claude Code 窗口：

alt text

第二步：将 VibeKeys Max 连接到 vibetty​

  1. 开启 VibeKeys Max - 设备会进入键盘模式
  2. 查找你电脑的本地 IP 地址
  3. 在电脑上打开 VibeKeys 设置页面
  4. 点击 Connect，从列表中选择 "VibeKeys Max"
  5. 输入你的 WiFi 名称和密码 —— 网络必须是 2.4GHz（VibeKeys Max 无法连接 5GHz）
  6. 输入服务器 URL：ws://你的电脑IP:3000/ws
  7. 点击 Save Changes，等待设备连接

在设置页面配置 WiFi 和 VibeKeys Server 的 WebSocket URL

你的电脑和 VibeKeys Max 必须在同一个局域网中，且端口 3000 必须对设备可达。

第三步：开始 Vibe Coding​

当 VibeKeys Max 屏幕显示 VibeKeys Ready 和 Server Connected 时，设备已准备好控制 Claude Code。

  1. 按下 Voice 并说出你的提示词。
  2. 在屏幕上查看语音转写结果。
  3. 按下 Accept 将其发送给 Claude Code。
  4. 按 ← 删除字符来编辑待发送的输入。
  5. 按 ESC 取消待发送的输入。

当 Claude 提供多个选项时，按 Claude 切换选项，按 Accept 选择其中一个。

Claude 回复后，使用旋钮在 VibeKeys Max 屏幕上滚动查看输出，然后重复同样的流程输入下一个提示词。

使用场景

遥控模式适用于远距离编程、演示和代码审查等不需要坐在键盘前的场景。

相关文档​