Verbindungsdiagnose

Wenn etwas nicht funktioniert, verschwenden zufällige Versuche nur Zeit. Nutze diese Reihenfolge, um das Problem einzugrenzen.

Schritt 1: Symptom klassifizieren

Schritt 2: Server prüfen

Überprüfe auf deinem Mac, ob der Server lauscht:

lsof -nP -iTCP:8765 -sTCP:LISTEN

Du solltest einen node-Prozess sehen. Falls nichts erscheint, läuft der Server nicht.

Bei Verwendung von Cloudflare Tunnel prüfe zusätzlich:

ps aux | grep cloudflared

Schritt 3: Netzwerkerreichbarkeit testen

Von einem anderen Gerät im selben Netzwerk (oder deinem Mac selbst):

# Prüfen, ob der Port erreichbar ist
nc -zv <mac-ip> 8765
 
# Bei Verwendung eines Tunnels
curl -I https://your-tunnel-url.trycloudflare.com

Falls der Port nicht erreichbar ist, prüfe:

• Mac-Firewall-Einstellungen
• Die korrekte Netzwerkschnittstelle (en0 für WLAN, en1 für Ethernet)
• Ob die Geräte im selben Subnetz sind

Schritt 4: Mac-Leistung prüfen

Falls die Verbindung funktioniert, aber langsam wirkt:

# CPU und Speicher
top -l 1 -s 0 | head -10
 
# tmux-Sessions prüfen (gibt es viele?)
tmux list-sessions

Ein stark ausgelasteter Mac verzögert die Terminal-Ausgabe, was wie ein Netzwerkproblem aussehen kann.

Schritt 5: Session aktualisieren

Falls die Ausgabe veraltet wirkt oder das Terminal leer ist:

1. Öffne die Session-Auswahl in der iPhone-App.
2. Wähle die Session erneut aus.
3. Dadurch wird die tmux-Session neu verbunden und die Ausgabe aktualisiert.

Falls die Session nicht mehr existiert (gelöscht oder Server neugestartet), erstelle eine neue.

Schritt 6: Benachrichtigungszustellung prüfen

Falls Push-Benachrichtigungen nicht funktionieren:

1. iOS-Berechtigungen: Einstellungen > Tactic Remote > Mitteilungen > Erlauben.
2. Hook-Events: Claude Code feuert Hook-Events, die der Server weiterleitet. Stelle sicher, dass der Server sie empfängt:

   curl -X POST http://localhost:8765/hook -d '{"type":"test"}'

3. App-Version: Stelle sicher, dass Mac-App und iOS-App auf der neuesten Version sind.

Wann ein Support-Issue erstellen

Falls nichts davon das Problem löst, kontaktiere den Support mit:

• App-Version (Mac und iOS)
• Verbindungsmodus (Lokal oder Tunnel)
• Durchgeführte Schritte
• Screenshots oder Fehlermeldungen (API-Schlüssel unkenntlich machen)