前置条件
- 一台运行 macOS、Linux 或 Windows 的电脑
- 一款 AI 编码工具 — Claude Code（推荐）、Codex、Gemini CLI 或 OpenCode
- 一台运行 iOS 26+ 的 iPhone
安装
macOS / Linux：
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows（PowerShell）：
irm https://coding.btelo.com/install.ps1 | iex
启动 Agent
vibe-remote
TUI 界面会出现。按 c 设置连接器名称和密码。Agent 会自动连接到云端 relay，并在 Dashboard 上显示一个二维码。
TUI 快捷键（Dashboard 标签页）：
| 按键 | 操作 |
|---|---|
| c | 配置 — 设置连接器名称和密码 |
| w | 切换 relay 服务器 |
| d | 管理已连接设备 |
| r | 刷新二维码 |
| h | 显示 / 隐藏二维码 |
| m | 切换二维码角色（管理员 / 成员） |
| y | 复制二维码链接到剪贴板 |
| t | 桌面帮助 |
| i | 安装二维码（App Store 链接） |
| u | 更新后重启 |
| s | 停止服务 |
| q | 退出 TUI |
| 1/2/3 | 切换标签页（Dashboard / Logs / Install） |
Logs 标签页： g 跳到顶部，G 跳到底部，x 清空日志。
Devices 弹窗： k 踢出所选设备，r 刷新列表。
Windows 说明： TUI 在 Windows 上不可用，请使用 headless 模式：
vibe-remote --headless --connector myconnector --password mypassword
从 iPhone 连接
- 从 App Store 下载 Btelo Coding
- Agent TUI 会在 Dashboard 标签页显示一个连接二维码
- 在 iOS app 中点击 +（添加连接器）并扫描该二维码
- 开始与你机器上的 AI 对话
提示： 如果二维码过期或连接失败，在 TUI 中按 r 刷新二维码，然后重新扫描。
更新
vibe-remote update
更新下载完成后，在 TUI 中按 u 即可在新版本上重启，并保持连接不中断。
CLI 参考
vibe-remote 启动 TUI（默认）
vibe-remote --headless 无 TUI 启动
vibe-remote client 连接到远程 agent（反向模式）
vibe-remote relay 作为 relay 服务器运行
vibe-remote delete-connector 删除已保存的连接器
vibe-remote update 更新到最新版本
vibe-remote version 显示版本
vibe-remote help 显示帮助