Agent 无法连接
- 检查你的网络连接
- 验证 relay 可达：
curl https://coding.btelo.com/ping - 检查防火墙是否阻止出站 WebSocket 连接（443 端口）
iOS App 找不到 Agent
- 确保 agent 在运行，并显示 Cloud: running
- 二维码 / 连接链接可能已过期 — 在 TUI 中按 r 刷新二维码后重新扫描
- 如果你重新配置了连接器（按 c），则需要扫描新的二维码重新配对
未找到 AI 提供商
至少安装一个提供商：
npm install -g @anthropic-ai/claude-code
确保 CLI 已加入 PATH — 运行 claude --version 验证。
端口冲突
Agent 默认使用 24385 端口。若被占用，会自动选择一个随机端口。自定义端口：
PORT=8080 vibe-remote
强制更新到最新版本
如果 agent 卡在旧版本，或自动更新未生效，重新运行安装命令即可拉取最新版本：
macOS / Linux
curl -fsSL https://coding.btelo.com/install.sh | sh
Windows (PowerShell)
irm https://coding.btelo.com/install.ps1 | iex
完成后，重启 agent 以加载新的二进制。
日志
日志会显示在 TUI 的 viewport 中。在 headless 模式下，日志输出到 stdout。日志文件存储在 ~/.vibe-remote/logs/。
获取帮助
在 github.com/btelolabs/btelo-coding-release/issues 提交 issue。