Dépannage

Problèmes courants et comment les résoudre.

L'agent ne peut pas se connecter

  • Vérifiez votre connexion internet
  • Vérifiez que le relais est accessible : curl https://coding.btelo.com/ping
  • Vérifiez si un pare-feu bloque les connexions WebSocket sortantes (port 443)

L'application iOS ne trouve pas l'agent

  • Assurez-vous que l'agent est en cours d'exécution et affiche Cloud: running
  • Le QR code / lien de connexion peut avoir expiré — appuyez sur r dans la TUI pour rafraîchir le QR code et scannez à nouveau
  • Si vous avez reconfiguré le connecteur (appuyez sur c), vous devez réappairer en scannant le nouveau QR code

Aucun fournisseur IA trouvé

Installez au moins un fournisseur :

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

Assurez-vous que la CLI est dans votre PATH — exécutez claude --version pour vérifier.

Conflit de port

L'agent utilise le port 24385 par défaut. S'il est occupé, il choisit automatiquement un port aléatoire. Définissez un port personnalisé :

PORT=8080 vibe-remote

Forcer la mise à jour vers la dernière version

Si l'agent est bloqué sur une ancienne version ou que la mise à jour automatique n'a pas été appliquée, relancez la commande d'installation pour récupérer la dernière version :

macOS / Linux

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

Windows (PowerShell)

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

Une fois terminé, redémarrez l'agent pour charger le nouveau binaire.

Logs

Les logs apparaissent dans la fenêtre TUI. En mode sans interface, les logs vont vers stdout. Les fichiers de logs sont stockés dans ~/.vibe-remote/logs/.

Obtenir de l'aide

Signalez un problème sur github.com/btelolabs/btelo-coding-release/issues.