Remote Control ist in allen Plänen verfügbar. Bei Team und Enterprise ist es standardmäßig deaktiviert, bis ein Administrator den Remote Control-Schalter in den Claude Code-Admin-Einstellungen aktiviert.
- Ihre vollständige lokale Umgebung remote nutzen: Ihr Dateisystem, MCP servers, Tools und Projektkonfiguration bleiben verfügbar
- Von beiden Oberflächen gleichzeitig arbeiten: Das Gespräch bleibt auf allen verbundenen Geräten synchronisiert, sodass Sie Nachrichten von Ihrem Terminal, Browser und Telefon austauschbar senden können
- Unterbrechungen überstehen: Wenn Ihr Laptop in den Ruhezustand wechselt oder Ihr Netzwerk ausfällt, wird die Sitzung automatisch wiederhergestellt, wenn Ihr Computer wieder online ist
Remote Control erfordert Claude Code v2.1.51 oder später. Überprüfen Sie Ihre Version mit
claude --version.Anforderungen
Bevor Sie Remote Control verwenden, bestätigen Sie, dass Ihre Umgebung diese Bedingungen erfüllt:- Abonnement: verfügbar in Pro-, Max-, Team- und Enterprise-Plänen. API-Schlüssel werden nicht unterstützt. Bei Team und Enterprise muss ein Administrator zunächst den Remote Control-Schalter in den Claude Code-Admin-Einstellungen aktivieren.
- Authentifizierung: Führen Sie
claudeaus und verwenden Sie/login, um sich über claude.ai anzumelden, falls Sie dies noch nicht getan haben. - Workspace-Vertrauen: Führen Sie
claudemindestens einmal in Ihrem Projektverzeichnis aus, um den Workspace-Vertrauensdialog zu akzeptieren.
Starten Sie eine Remote Control-Sitzung
Sie können eine Remote Control-Sitzung über die CLI oder die VS Code-Erweiterung starten. Die CLI bietet drei Aufrufmodi; VS Code verwendet den Befehl/remote-control.
- Server-Modus
- Interaktive Sitzung
- Aus einer bestehenden Sitzung
- VS Code
Navigieren Sie zu Ihrem Projektverzeichnis und führen Sie aus:Der Prozess läuft weiterhin in Ihrem Terminal im Server-Modus und wartet auf Remote-Verbindungen. Er zeigt eine Sitzungs-URL an, die Sie zum Verbinden von einem anderen Gerät verwenden können, und Sie können die Leertaste drücken, um einen QR-Code für schnellen Zugriff von Ihrem Telefon anzuzeigen. Während eine Remote-Sitzung aktiv ist, zeigt das Terminal den Verbindungsstatus und die Tool-Aktivität an.Verfügbare Flags:
| Flag | Beschreibung |
|---|---|
--name "My Project" | Legen Sie einen benutzerdefinierten Sitzungstitel fest, der in der Sitzungsliste unter claude.ai/code sichtbar ist. |
--remote-control-session-name-prefix <prefix> | Präfix für automatisch generierte Sitzungsnamen, wenn kein expliziter Name festgelegt ist. Standardmäßig der Hostname Ihres Computers, was Namen wie myhost-graceful-unicorn erzeugt. Setzen Sie CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX für denselben Effekt. |
--spawn <mode> | Wie der Server Sitzungen erstellt. • same-dir (Standard): Alle Sitzungen teilen sich das aktuelle Arbeitsverzeichnis, sodass sie in Konflikt geraten können, wenn dieselben Dateien bearbeitet werden.• worktree: Jede On-Demand-Sitzung erhält ihren eigenen git worktree. Erfordert ein Git-Repository.• session: Single-Session-Modus. Bedient genau eine Sitzung und lehnt zusätzliche Verbindungen ab. Wird nur beim Start festgelegt.Drücken Sie w zur Laufzeit, um zwischen same-dir und worktree umzuschalten. |
--capacity <N> | Maximale Anzahl gleichzeitiger Sitzungen. Standard ist 32. Kann nicht mit --spawn=session verwendet werden. |
--verbose | Zeigen Sie detaillierte Verbindungs- und Sitzungsprotokolle an. |
--sandbox / --no-sandbox | Aktivieren oder deaktivieren Sie sandboxing für Dateisystem- und Netzwerkisolation. Standardmäßig deaktiviert. |
Verbinden Sie sich von einem anderen Gerät
Sobald eine Remote Control-Sitzung aktiv ist, haben Sie mehrere Möglichkeiten, sich von einem anderen Gerät aus zu verbinden:- Öffnen Sie die Sitzungs-URL in einem beliebigen Browser, um direkt zur Sitzung auf claude.ai/code zu gehen.
- Scannen Sie den QR-Code, der neben der Sitzungs-URL angezeigt wird, um ihn direkt in der Claude-App zu öffnen. Mit
claude remote-controldrücken Sie die Leertaste, um die QR-Code-Anzeige umzuschalten. - Öffnen Sie claude.ai/code oder die Claude-App und finden Sie die Sitzung nach Name in der Sitzungsliste. Remote Control-Sitzungen zeigen ein Computersymbol mit einem grünen Statusindikator an, wenn sie online sind.
- Der Name, den Sie an
--name,--remote-controloder/remote-controlübergeben haben - Der Titel, den Sie mit
/renamefestgelegt haben - Die letzte aussagekräftige Nachricht im vorhandenen Gesprächsverlauf
- Ein automatisch generierter Name wie
myhost-graceful-unicorn, wobeimyhostder Hostname Ihres Computers oder das Präfix ist, das Sie mit--remote-control-session-name-prefixfestgelegt haben
/mobile in Claude Code, um einen Download-QR-Code für iOS oder Android anzuzeigen.
Aktivieren Sie Remote Control für alle Sitzungen
Standardmäßig wird Remote Control nur aktiviert, wenn Sie explizitclaude remote-control, claude --remote-control oder /remote-control ausführen. Um es automatisch für jede interaktive Sitzung zu aktivieren, führen Sie /config in Claude Code aus und setzen Sie Enable Remote Control for all sessions auf true. Setzen Sie es auf false zurück, um es zu deaktivieren.
Mit dieser Einstellung registriert jeder interaktive Claude Code-Prozess eine Remote-Sitzung. Wenn Sie mehrere Instanzen ausführen, erhält jede ihre eigene Umgebung und Sitzung. Um mehrere gleichzeitige Sitzungen aus einem einzelnen Prozess auszuführen, verwenden Sie stattdessen den Server-Modus.
Verbindung und Sicherheit
Ihre lokale Claude Code-Sitzung stellt nur ausgehende HTTPS-Anfragen und öffnet niemals eingehende Ports auf Ihrem Computer. Wenn Sie Remote Control starten, registriert es sich bei der Anthropic-API und fragt nach Arbeit ab. Wenn Sie sich von einem anderen Gerät aus verbinden, leitet der Server Nachrichten zwischen dem Web- oder Mobile-Client und Ihrer lokalen Sitzung über eine Streaming-Verbindung weiter. Der gesamte Datenverkehr verläuft über die Anthropic-API über TLS, die gleiche Transportsicherheit wie jede Claude Code-Sitzung. Die Verbindung verwendet mehrere kurzlebige Anmeldeinformationen, die jeweils auf einen einzelnen Zweck beschränkt sind und unabhängig ablaufen.Remote Control vs. Claude Code im Web
Remote Control und Claude Code im Web verwenden beide die Schnittstelle claude.ai/code. Der Hauptunterschied liegt darin, wo die Sitzung ausgeführt wird: Remote Control wird auf Ihrem Computer ausgeführt, sodass Ihre lokalen MCP servers, Tools und Projektkonfiguration verfügbar bleiben. Claude Code im Web wird in von Anthropic verwalteter Cloud-Infrastruktur ausgeführt. Verwenden Sie Remote Control, wenn Sie sich mitten in lokaler Arbeit befinden und von einem anderen Gerät aus weitermachen möchten. Verwenden Sie Claude Code im Web, wenn Sie eine Aufgabe ohne lokale Einrichtung starten möchten, an einem Repository arbeiten, das Sie nicht geklont haben, oder mehrere Aufgaben parallel ausführen möchten.Mobile Push-Benachrichtigungen
Wenn Remote Control aktiv ist, kann Claude Push-Benachrichtigungen an Ihr Telefon senden. Claude entscheidet, wann eine Push-Benachrichtigung gesendet wird. Sie wird normalerweise gesendet, wenn eine lange laufende Aufgabe abgeschlossen ist oder wenn Claude eine Entscheidung von Ihnen benötigt, um fortzufahren. Sie können auch eine Push-Benachrichtigung in Ihrer Eingabeaufforderung anfordern, zum Beispielnotify me when the tests finish. Über den Ein-/Aus-Schalter unten gibt es keine Pro-Event-Konfiguration.
Mobile Push-Benachrichtigungen erfordern Claude Code v2.1.110 oder später.
Melden Sie sich mit Ihrem Claude Code-Konto an
Verwenden Sie dasselbe Konto und die gleiche Organisation, die Sie für Claude Code im Terminal verwenden.
Benachrichtigungen zulassen
Akzeptieren Sie die Benachrichtigungsberechtigungsaufforderung des Betriebssystems.
- Wenn
/configNo mobile registered anzeigt, öffnen Sie die Claude-App auf Ihrem Telefon, damit sie ihr Push-Token aktualisieren kann. Die Warnung wird beim nächsten Verbinden von Remote Control gelöscht. - Auf iOS können Focus-Modi und Benachrichtigungszusammenfassungen Push-Benachrichtigungen unterdrücken oder verzögern. Überprüfen Sie Einstellungen → Benachrichtigungen → Claude.
- Auf Android kann aggressive Batterieoptimierung die Zustellung verzögern. Befreien Sie die Claude-App von der Batterieoptimierung in den Systemeinstellungen.
Einschränkungen
- Eine Remote-Sitzung pro interaktivem Prozess: Außerhalb des Server-Modus unterstützt jede Claude Code-Instanz jeweils eine Remote-Sitzung. Verwenden Sie den Server-Modus, um mehrere gleichzeitige Sitzungen aus einem einzelnen Prozess auszuführen.
- Lokaler Prozess muss weiterhin ausgeführt werden: Remote Control wird als lokaler Prozess ausgeführt. Wenn Sie das Terminal schließen, VS Code beenden oder den
claude-Prozess anderweitig beenden, endet die Sitzung. - Längerer Netzwerkausfall: Wenn Ihr Computer aktiv ist, aber länger als etwa 10 Minuten das Netzwerk nicht erreichen kann, läuft die Sitzung ab und der Prozess wird beendet. Führen Sie
claude remote-controlerneut aus, um eine neue Sitzung zu starten. - Ultraplan trennt Remote Control: Das Starten einer ultraplan-Sitzung trennt jede aktive Remote Control-Sitzung, da beide Funktionen die Schnittstelle claude.ai/code belegen und nur eine gleichzeitig verbunden sein kann.
Fehlerbehebung
„Remote Control erfordert ein claude.ai-Abonnement”
Sie sind nicht mit einem claude.ai-Konto authentifiziert. Führen Sieclaude auth login aus und wählen Sie die claude.ai-Option. Wenn ANTHROPIC_API_KEY in Ihrer Umgebung festgelegt ist, heben Sie die Festlegung zuerst auf.
„Remote Control erfordert ein Token mit vollständigem Umfang”
Sie sind mit einem langlebigen Token vonclaude setup-token oder der Umgebungsvariable CLAUDE_CODE_OAUTH_TOKEN authentifiziert. Diese Token sind auf Inferenz-only beschränkt und können keine Remote Control-Sitzungen einrichten. Führen Sie claude auth login aus, um sich stattdessen mit einem Token mit vollständigem Umfang zu authentifizieren.
„Ihre Organisation für die Remote Control-Berechtigung konnte nicht bestimmt werden”
Ihre zwischengespeicherten Kontoinformationen sind veraltet oder unvollständig. Führen Sieclaude auth login aus, um sie zu aktualisieren.
„Remote Control ist für Ihr Konto noch nicht aktiviert”
Die Berechtigungsprüfung kann mit bestimmten Umgebungsvariablen fehlschlagen:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICoderDISABLE_TELEMETRY: Heben Sie die Festlegung auf und versuchen Sie es erneut.CLAUDE_CODE_USE_BEDROCK,CLAUDE_CODE_USE_VERTEXoderCLAUDE_CODE_USE_FOUNDRY: Remote Control erfordert claude.ai-Authentifizierung und funktioniert nicht mit Drittanbieter-Providern.
/logout und dann /login aus, um zu aktualisieren.
„Remote Control ist durch die Richtlinie Ihrer Organisation deaktiviert”
Dieser Fehler hat drei unterschiedliche Ursachen. Führen Sie zunächst/status aus, um zu sehen, welche Anmeldemethode und welches Abonnement Sie verwenden.
- Sie sind mit einem API-Schlüssel oder Console-Konto authentifiziert: Remote Control erfordert claude.ai OAuth. Führen Sie
/loginaus und wählen Sie die claude.ai-Option. WennANTHROPIC_API_KEYin Ihrer Umgebung festgelegt ist, heben Sie die Festlegung auf. - Ihr Team- oder Enterprise-Administrator hat es nicht aktiviert: Remote Control ist standardmäßig in diesen Plänen deaktiviert. Ein Administrator kann es unter claude.ai/admin-settings/claude-code aktivieren, indem er den Schalter Remote Control einschaltet. Dies ist eine serverseitige Organisationseinstellung, keine verwaltete Einstellung.
- Der Admin-Schalter ist ausgegraut: Ihre Organisation hat eine Datenspeicherungs- oder Compliance-Konfiguration, die mit Remote Control nicht kompatibel ist. Dies kann nicht über das Admin-Panel geändert werden. Kontaktieren Sie den Anthropic-Support, um Optionen zu besprechen.
„Remote credentials fetch failed”
Claude Code konnte keine kurzlebige Anmeldeinformation von der Anthropic-API abrufen, um die Verbindung herzustellen. Führen Sie erneut mit--verbose aus, um den vollständigen Fehler zu sehen:
- Nicht angemeldet: Führen Sie
claudeaus und verwenden Sie/login, um sich mit Ihrem claude.ai-Konto zu authentifizieren. API-Schlüssel-Authentifizierung wird für Remote Control nicht unterstützt. - Netzwerk- oder Proxy-Problem: Eine Firewall oder ein Proxy blockiert möglicherweise die ausgehende HTTPS-Anfrage. Remote Control erfordert Zugriff auf die Anthropic-API auf Port 443.
- Sitzungserstellung fehlgeschlagen: Wenn Sie auch „Session creation failed — see debug log” sehen, ist der Fehler früher in der Einrichtung aufgetreten. Überprüfen Sie, dass Ihr Abonnement aktiv ist.
Wählen Sie den richtigen Ansatz
Claude Code offers several ways to work when you’re not at your terminal. They differ in what triggers the work, where Claude runs, and how much you need to set up.| Trigger | Claude runs on | Setup | Best for | |
|---|---|---|---|---|
| Dispatch | Message a task from the Claude mobile app | Your machine (Desktop) | Pair the mobile app with Desktop | Delegating work while you’re away, minimal setup |
| Remote Control | Drive a running session from claude.ai/code or the Claude mobile app | Your machine (CLI or VS Code) | Run claude remote-control | Steering in-progress work from another device |
| Channels | Push events from a chat app like Telegram or Discord, or your own server | Your machine (CLI) | Install a channel plugin or build your own | Reacting to external events like CI failures or chat messages |
| Slack | Mention @Claude in a team channel | Anthropic cloud | Install the Slack app with Claude Code on the web enabled | PRs and reviews from team chat |
| Scheduled tasks | Set a schedule | CLI, Desktop, or cloud | Pick a frequency | Recurring automation like daily reviews |
Verwandte Ressourcen
- Claude Code im Web: Führen Sie Sitzungen in von Anthropic verwalteten Cloud-Umgebungen aus, anstatt auf Ihrem Computer
- Ultraplan: Starten Sie eine Cloud-Planungssitzung von Ihrem Terminal aus und überprüfen Sie den Plan in Ihrem Browser
- Kanäle: Leiten Sie Telegram, Discord oder iMessage in eine Sitzung weiter, damit Claude auf Nachrichten reagiert, während Sie weg sind
- Dispatch: Senden Sie eine Aufgabe von Ihrem Telefon aus, und sie kann eine Desktop-Sitzung spawnen, um sie zu bearbeiten
- Authentifizierung: Richten Sie
/loginein und verwalten Sie Anmeldeinformationen für claude.ai - CLI-Referenz: Vollständige Liste von Flags und Befehlen einschließlich
claude remote-control - Sicherheit: Wie Remote Control-Sitzungen in das Claude Code-Sicherheitsmodell passen
- Datennutzung: Welche Daten während lokaler und Remote-Sitzungen durch die Anthropic-API fließen