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 — l'application de bureau est ouverte, ou l'agent CLI affiche Cloud: running.
  • Le QR code / lien de connexion peut avoir expiré — rafraîchissez-le (rouvrez le panneau Connecter dans l'application de bureau, ou appuyez sur r dans la TUI CLI) et scannez à nouveau.
  • Si vous avez reconfiguré le connecteur, réappairez en scannant le nouveau QR code.

Aucun fournisseur IA trouvé

Installez au moins un fournisseur sur la machine de l'agent :

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

Assurez-vous que la CLI est dans votre PATH — exécutez claude --version pour vérifier. Dans l'application de bureau, utilisez Paramètres → Guide de configuration → Revérifier pour redétecter les fournisseurs. Ou choisissez l'Agent Btelo intégré avec votre propre clé DeepSeek / MiniMax.

Conflit de port

L'agent utilise le port 24385 par défaut. S'il est occupé, il choisit automatiquement un port aléatoire. Pour définir un port personnalisé pour l'agent CLI :

PORT=8080 vibe-remote

Forcer la mise à jour vers la dernière version

Application de bureau : ouvrez Paramètres → Vérifier les mises à jour, puis Redémarrer & mettre à jour. Si elle est toujours bloquée, téléchargez la dernière version depuis la page de téléchargement et réinstallez par-dessus l'application existante.

Agent CLI : s'il 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 :

Linux / macOS

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

Dans l'application de bureau, les logs sont disponibles depuis la fenêtre de l'application. Pour l'agent CLI, les logs apparaissent dans la fenêtre TUI (ou sur stdout en mode sans interface). 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.