Häufige Probleme

Keine Verbindung zum Server

Symptom: Verbindung bricht ab oder schlägt sofort fehl.

Lösungen:

• Prüfe, ob beide Geräte im selben WLAN sind (im lokalen Modus).
• Stelle sicher, dass die Mac-App / der Server tatsächlich läuft.
• Bestätige, dass IP-Adresse und Port korrekt sind. Führe ipconfig getifaddr en0 auf deinem Mac aus.
• Falls die macOS-Firewall aktiv ist, erlaube eingehende Verbindungen für die App.
• Deaktiviere VPN auf beiden Geräten, falls es den Datenverkehr umleitet.
• Firmen-/Hotel-WLAN kann Geräte isolieren. Probiere ein Heimnetzwerk oder den Handy-Hotspot.

Punkt lässt sich nicht in der IP-Adresse eingeben

Symptom: Manche Spracheinstellungen (Deutsch, Französisch) zeigen ein Komma , statt . auf der Zahlentastatur.

Lösung: Wechsle zur normalen Buchstabentastatur, um Punkte einzugeben, oder füge die IP-Adresse aus den Notizen ein.

Verbunden, aber Terminal ist leer

Symptom: Grüne Verbindungsanzeige, aber die Terminal-Ansicht zeigt nichts.

Lösungen:

1. Öffne die Session-Auswahl und wähle deine Session erneut aus.
2. Falls keine Sessions angezeigt werden, erstelle eine neue.
3. Falls eine Session existiert, aber keine Ausgabe hat, tippe auf Start, um Claude Code zu starten.

Start scheint nichts zu tun

Symptom: Du tippst auf Start, aber nichts passiert.

Das ist erwartet, wenn Claude Code bereits läuft. Die App hat einen Doppelstart-Schutz. Prüfe die Statusanzeige -- wenn sie Grün „Läuft" zeigt, ist Claude Code bereits aktiv. Sende einfach deine Prompts.

Benachrichtigungen kommen nicht an

Symptom: Claude Code beendet Aufgaben, aber keine Push-Benachrichtigung erscheint.

Lösungen:

• Prüfe iOS-Einstellungen > Tactic Remote > Mitteilungen -- müssen aktiviert sein.
• Stelle sicher, dass Server und App auf der neuesten Version sind.
• Benachrichtigungen erfordern Claude Code Hook-Events. Diese werden automatisch gesendet, setzen aber eine erreichbare WebSocket-Verbindung voraus.

Verbindung bricht im Hintergrund ab

Symptom: Bei Rückkehr zur App nach einer Weile zeigt sie einen getrennten Zustand.

Das ist normales iOS-Verhalten. iOS unterbricht Hintergrund-Netzwerkverbindungen, um Akku zu sparen. Die App verbindet sich automatisch wieder, wenn du zurückkehrst.

Für lange Aufgaben verlasse dich auf Push-Benachrichtigungen, statt die App offen zu halten.

Server-IP ändert sich ständig

Symptom: Dein Mac bekommt jedes Mal eine andere IP, was die gespeicherte Verbindung unterbricht.

Lösungen:

• Weise deinem Mac eine statische IP in Systemeinstellungen > Netzwerk zu.
• Nutze die Bonjour-Erkennung statt einer manuellen IP.
• Verwende einen Cloudflare Tunnel für eine stabile URL.

Claude Code meldet „API key not set"

Dies ist ein Claude Code-Fehler, kein Tactic Remote-Fehler. Claude Code benötigt einen Anthropic API-Schlüssel zum Funktionieren.

Setze ihn in deinem Terminal:

export ANTHROPIC_API_KEY="your-anthropic-api-key"

Oder führe claude config aus, um ihn dauerhaft zu setzen.

Hinweis: Dies ist getrennt vom Tactic Remote Server-API-Schlüssel. Der Anthropic-Schlüssel ist für den Claude-KI-Dienst. Der Server-API-Schlüssel ist für die Authentifizierung der iPhone-zu-Mac-Verbindung.

Weitere Hilfe

Besuche die Support-Seite oder erstelle ein Issue auf GitHub mit:

• App-Version
• Verbindungsmodus (Lokal oder Cloudflare Tunnel)
• Was du versucht hast und was passiert ist