Schnellstart

Windows: Windows über Ihr Konto verbinden.

Diese Anleitung führt dich durch die Installation von Tactic Remote und die erste Verbindung. Du brauchst einen Mac (oder Windows-PC) und ein iPhone.

Dauer: Etwa 10 Minuten für die Ersteinrichtung. Späteres Verbinden dauert nur Sekunden.

Voraussetzungen

Auf deinem Mac

• Tactic Remote Mac-App -- enthält den lokalen Server und eine fest gepinnte Node Runtime. Beim ersten Start prüft sie lokale Abhängigkeiten und kann fehlende Grundlagen wie Homebrew und tmux installieren helfen.

• Mindestens eine AI-Coding-Agent-CLI -- Tactic Remote kann Claude Code, OpenAI Codex oder Sourcegraph Amp starten. Installiere den Agenten, den du verwenden möchtest, und melde dich dort an, bevor du deine erste Session startest.

  # Claude Code (nativer Installer, von den Claude-Code-Dokumenten empfohlen)
  curl -fsSL https://claude.ai/install.sh | bash
   
  # OpenAI Codex
  npm install -g @openai/codex
   
  # Sourcegraph Amp
  npm install -g @sourcegraph/amp

  Wenn claude, codex oder amp bereits in deinem Terminal funktioniert, kann Tactic Remote diesen Agenten verwenden.

• tmux -- hält Mac/Linux-Terminal-Sessions über Verbindungsabbrüche hinweg am Leben. Die Mac-App prüft tmux und kann bei der Installation helfen; CLI-Nutzer können unter macOS brew install tmux ausführen.

Wenn du statt der Mac-App den Ein-Befehl-CLI-Start nutzt und Node.js oder Homebrew noch nicht installiert hast:

# Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
# Node.js
brew install node

Auf deinem iPhone

• iOS 16.4 oder neuer.
• Die Tactic Remote iOS-App (verfügbar über App Store).

Schritt 1: Wähle, wie du deinen Mac einrichten möchtest

Tactic Remote unterstützt auf dem Mac zwei Einrichtungswege:

Option A: Mac-App (für die meisten empfohlen)

Lade die Tactic Remote Mac-App von der Download-Seite herunter. Öffne das DMG und ziehe die App in den Programme-Ordner.

Beim ersten Start erscheint die App in deiner Menüleiste. Klicke auf das Icon, um Folgendes zu sehen:

• Server-Status (läuft / gestoppt)
• Deine lokale IP und Port (z. B. 192.168.1.42:8765)
• Einen QR-Code für schnelles iPhone-Pairing

Die Mac-App enthält den Server intern, führt dich durch die Einrichtung und ist für Nutzer ohne Terminal-Fokus meist die einfachste Wahl.

Option B: Terminal-Start mit einem Befehl (CLI)

Führe diesen einen Befehl in deinem Terminal aus:

npx tacticremote

Der Server startet und zeigt einen QR-Code an. Scanne ihn mit deinem iPhone, um dich zu verbinden. Das war's.

Voraussetzungen: Node.js 16+, tmux (brew install tmux unter macOS) und mindestens eine installierte Agent-CLI (claude, codex oder amp).

Funktioniert unter macOS und Linux.

Schritt 2: Vom iPhone verbinden

1. Öffne die Tactic Remote iOS-App.

2. Scanne den QR-Code, der von der Mac-App oder dem CLI angezeigt wird. Dadurch werden Serveradresse und API-Schlüssel automatisch eingetragen.

   Oder verbinde manuell:

   • Gib die IP-Adresse und den Port deines Macs ein (z. B. 192.168.1.42:8765)
   • Gib den API-Schlüssel ein, falls einer gesetzt ist
   • Tippe auf Verbinden

3. Innerhalb weniger Sekunden sollte eine grüne Verbunden-Anzeige erscheinen.

Welche Option sollte ich wählen? Für die meisten ist die Mac-App die beste Standardwahl, weil sie durch die Einrichtung führt und den QR-Code direkt in der Menüleiste anzeigt. Das CLI bleibt ideal, wenn du ohnehin im Terminal arbeitest oder denselben Ablauf auf macOS und Linux willst.

Bonjour-Erkennung: Wenn beide Geräte im selben WLAN sind, kann die iOS-App deinen Mac auch automatisch per Bonjour finden -- schau in der Server-Liste nach.

Schritt 3: Session erstellen

1. Tippe auf die Session-Auswahl (oben links).
2. Tippe auf Neue Session.
3. Wähle ein Projektverzeichnis auf deinem Mac aus -- das ist das Arbeitsverzeichnis für den gewählten Agenten.
4. Gib der Session einen Namen (z. B. mein-projekt).
5. Tippe auf Erstellen.

Schritt 4: Agent auswählen und starten

1. Wähle in den Einstellungen den Agenten aus: Claude Code, Codex oder Amp. Claude Code ist die Standardeinstellung.
2. Tippe auf den Start-Button.
3. Der gewählte Agent startet in einer tmux-Session auf deinem Mac. Die Terminal-Ausgabe wird in Echtzeit auf dein iPhone gestreamt.
4. Sende einen Test-Prompt:

Liste die Dateien im aktuellen Verzeichnis auf.

Wenn du die Antwort des Agenten auf deinem Handy siehst, funktioniert alles.

Schritt 5: Überprüfung

Nächste Schritte

• Der Agent antwortet nicht — Prüfe Warteschlange und Zustellstatus, bevor du die Anfrage erneut sendest.
• Eine kleine Fehlerbehebung ausprobieren — Verfolge ein konkretes Beispiel von der Anfrage bis zur Überprüfung.
• Lokales Netzwerk -- optimiere deine WLAN-Verbindung
• Cloudflare Tunnel -- greife von überall auf deinen Mac zu
• Sessions und Workflow -- verstehe Sessions, Start und Reconnect
• Sicherheit -- API-Schlüsselverwaltung und Zugriffskontrollen