エージェントが接続できない
- インターネット接続を確認
- リレーに到達可能であることを確認:
curl https://coding.btelo.com/ping - ファイアウォールがアウトバウンドの WebSocket 接続（ポート 443）をブロックしていないか確認
iOS アプリがエージェントを見つけられない
- エージェントが実行中で、Cloud: running と表示されていることを確認
- QR コード / 接続リンクが期限切れの可能性があります — TUI で r を押して QR コードを更新し、再度スキャン
- コネクタを再構成した場合（c を押す）、新しい QR コードをスキャンして再ペアリングする必要があります
AI プロバイダーが見つからない
少なくとも 1 つのプロバイダーをインストールします:
npm install -g @anthropic-ai/claude-code
CLI が PATH にあることを確認 — claude --version を実行して確認してください。
ポートの競合
エージェントはデフォルトでポート 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 ビューポートに表示されます。headless モードでは、ログは stdout に出力されます。ログファイルは ~/.vibe-remote/logs/ に保存されます。
ヘルプを得る
github.com/btelolabs/btelo-coding-release/issues で issue を報告してください。