Fehlerbehebung

Häufige Probleme und wie sie behoben werden.

Agent kann keine Verbindung herstellen

  • Überprüfen Sie Ihre Internetverbindung
  • Überprüfen Sie, ob das Relay erreichbar ist: curl https://coding.btelo.com/ping
  • Überprüfen Sie, ob eine Firewall ausgehende WebSocket-Verbindungen blockiert (Port 443)

iOS-App findet den Agenten nicht

  • Stellen Sie sicher, dass der Agent läuft und Cloud: running anzeigt
  • Der QR-Code / Verbindungslink kann abgelaufen sein — drücken Sie r im TUI, um den QR-Code zu aktualisieren, und scannen Sie erneut
  • Wenn Sie den Connector neu konfiguriert haben (drücken Sie c), müssen Sie durch Scannen des neuen QR-Codes erneut koppeln

Kein AI-Anbieter gefunden

Installieren Sie mindestens einen Anbieter:

npm install -g @anthropic-ai/claude-code

Stellen Sie sicher, dass die CLI in Ihrem PATH ist — führen Sie claude --version aus, um dies zu überprüfen.

Port-Konflikt

Der Agent verwendet standardmäßig Port 24385. Wenn er belegt ist, wählt er automatisch einen zufälligen Port. Einen benutzerdefinierten Port festlegen:

PORT=8080 vibe-remote

Auf die neueste Version zwangsaktualisieren

Wenn der Agent auf einer alten Version feststeckt oder das automatische Update nicht angewendet wurde, führe den Installationsbefehl erneut aus, um die neueste Version zu holen:

macOS / Linux

curl -fsSL https://coding.btelo.com/install.sh | sh

Windows (PowerShell)

irm https://coding.btelo.com/install.ps1 | iex

Nach Abschluss den Agent neu starten, damit die neue Binärdatei geladen wird.

Logs

Logs erscheinen im TUI-Viewport. Im Headless-Modus werden Logs an stdout ausgegeben. Logdateien werden in ~/.vibe-remote/logs/ gespeichert.

Hilfe erhalten

Reichen Sie ein Issue ein unter github.com/btelolabs/btelo-coding-release/issues.