Diagnostic de connexion

Guide étape par étape pour diagnostiquer les problèmes de connexion et de latence.

Quand les choses ne fonctionnent pas, les tentatives aléatoires font perdre du temps. Utilisez cette séquence pour isoler le problème.

Étape 1 : Classifier le symptôme

Symptôme	Cause probable
Impossible de se connecter	Réseau ou mauvaise configuration de l'endpoint
Connecté mais terminal lent	Latence réseau ou Mac surchargé
Connecté mais sortie périmée	Problème d'état de session
Notifications manquantes	Livraison des hooks ou permissions iOS

Sur votre Mac, vérifiez que le serveur écoute :

lsof -nP -iTCP:8765 -sTCP:LISTEN

Vous devriez voir un processus node. Si rien n'apparaît, le serveur ne tourne pas.

Si vous utilisez Cloudflare Tunnel, vérifiez aussi :

ps aux | grep cloudflared

Depuis un autre appareil sur le même réseau (ou votre Mac lui-même) :

# Tester si le port est accessible
nc -zv <mac-ip> 8765
 
# Si vous utilisez un tunnel
curl -I https://your-tunnel-url.trycloudflare.com

Si le port n'est pas accessible, vérifiez :

Si la connexion fonctionne mais semble lente :

# CPU et mémoire
top -l 1 -s 0 | head -10
 
# Vérifier les sessions tmux (y en a-t-il beaucoup ?)
tmux list-sessions

Un Mac sous forte charge retardera la sortie terminal, donnant l'impression d'un problème réseau.

Si la sortie semble périmée ou le terminal est vide :

Si la session n'existe plus (supprimée ou serveur redémarré), créez-en une nouvelle.

Si les notifications push ne fonctionnent pas :

Permissions iOS : Réglages > Tactic Remote > Notifications > Autoriser.
Événements de hook : Claude Code déclenche des événements de hook que le serveur relaie. Assurez-vous que le serveur les reçoit :
curl -X POST http://localhost:8765/hook -d '{"type":"test"}'
Version de l'app : Assurez-vous que l'app Mac et l'app iOS sont à la dernière version.

Si rien de ce qui précède ne résout le problème, contactez le support avec :