Lokale Sitzungen von jedem Gerät aus mit Remote Control fortsetzen
Setzen Sie eine lokale Claude Code-Sitzung von Ihrem Telefon, Tablet oder einem beliebigen Browser aus mit Remote Control fort. Funktioniert mit claude.ai/code und der Claude-Mobile-App.
Remote Control ist in der Forschungsvorschau verfügbar und auf 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.
Remote Control verbindet claude.ai/code oder die Claude-App für iOS und Android mit einer Claude Code-Sitzung, die auf Ihrem Computer ausgeführt wird. Starten Sie eine Aufgabe an Ihrem Schreibtisch und setzen Sie sie dann von Ihrem Telefon auf der Couch oder einem Browser auf einem anderen Computer fort.
Wenn Sie eine Remote Control-Sitzung auf Ihrem Computer starten, wird Claude die ganze Zeit lokal ausgeführt, sodass nichts in die Cloud verschoben wird. Mit Remote Control können Sie:
- Ihre vollständige lokale Umgebung remote nutzen: Ihr Dateisystem, MCP servers, Tools und Projektkonfiguration bleiben verfügbar, und durch Eingabe von
@werden Dateipfade aus Ihrem lokalen Projekt automatisch vervollständigt - 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
Im Gegensatz zu Claude Code im Web, das auf Cloud-Infrastruktur ausgeführt wird, werden Remote Control-Sitzungen direkt auf Ihrem Computer ausgeführt und interagieren mit Ihrem lokalen Dateisystem. Die Web- und Mobile-Schnittstellen sind nur ein Fenster in diese lokale Sitzung.
Remote Control erfordert Claude Code v2.1.51 oder später. Überprüfen Sie Ihre Version mit claude --version.
Diese Seite behandelt die Einrichtung, das Starten und Verbinden mit Sitzungen sowie den Vergleich von Remote Control mit Claude Code im Web.
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.
Navigieren Sie zu Ihrem Projektverzeichnis und führen Sie aus:
claude remote-control
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. |
Um eine normale interaktive Claude Code-Sitzung mit aktiviertem Remote Control zu starten, verwenden Sie das Flag --remote-control (oder --rc):
claude --remote-control
Geben Sie optional einen Namen für die Sitzung an:
claude --remote-control "My Project"
Dies gibt Ihnen eine vollständige interaktive Sitzung in Ihrem Terminal, die Sie auch von claude.ai oder der Claude-App aus steuern können. Im Gegensatz zu claude remote-control (Server-Modus) können Sie lokal Nachrichten eingeben, während die Sitzung auch remote verfügbar ist.
Wenn Sie sich bereits in einer Claude Code-Sitzung befinden und diese remote fortsetzen möchten, verwenden Sie den Befehl /remote-control (oder /rc):
/remote-control
Übergeben Sie einen Namen als Argument, um einen benutzerdefinierten Sitzungstitel festzulegen:
/remote-control My Project
Dies startet eine Remote Control-Sitzung, die Ihren aktuellen Gesprächsverlauf überträgt und eine Sitzungs-URL und einen QR-Code anzeigt, die Sie zum Verbinden von einem anderen Gerät verwenden können. Die Flags --verbose, --sandbox und --no-sandbox sind mit diesem Befehl nicht verfügbar.
In der Claude Code VS Code-Erweiterung geben Sie /remote-control oder /rc in das Eingabefeld ein, oder öffnen Sie das Befehlsmenü mit / und wählen Sie es aus. Erfordert Claude Code v2.1.79 oder später.
/remote-control
Ein Banner wird über dem Eingabefeld angezeigt und zeigt den Verbindungsstatus. Nach der Verbindung klicken Sie auf Im Browser öffnen im Banner, um direkt zur Sitzung zu gehen, oder finden Sie sie in der Sitzungsliste unter claude.ai/code. Die Sitzungs-URL wird auch im Gespräch gepostet.
Um die Verbindung zu trennen, klicken Sie auf das Schließsymbol im Banner oder führen Sie /remote-control erneut aus.
Im Gegensatz zur CLI akzeptiert der VS Code-Befehl kein Namensargument und zeigt keinen QR-Code an. Der Sitzungstitel wird aus Ihrem Gesprächsverlauf oder der ersten Eingabeaufforderung abgeleitet.
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. In der mobilen Claude-App tippen Sie auf Code in der Navigation, um die Sitzungsliste zu erreichen. Remote Control-Sitzungen zeigen ein Computersymbol mit einem grünen Statusindikator an, wenn sie online sind.
Der Titel der Remote-Sitzung wird in dieser Reihenfolge gewählt:
- 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
Wenn Sie keinen expliziten Namen festgelegt haben, wird der Titel aktualisiert, um Ihre Eingabeaufforderung widerzuspiegeln, sobald Sie eine senden.
Wenn die Umgebung bereits eine aktive Sitzung hat, werden Sie gefragt, ob Sie diese fortsetzen oder eine neue starten möchten.
Wenn Sie die Claude-App noch nicht haben, verwenden Sie den Befehl /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 explizit claude 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. In der Desktop-App können Sie dies auch unter Einstellungen → Claude Code → Enable remote control by default umschalten.
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 Beispiel notify 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.
So richten Sie Mobile Push-Benachrichtigungen ein:
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.
Aktivieren Sie Push in Claude Code
Führen Sie in Ihrem Terminal /config aus und aktivieren Sie Push when Claude decides.
Wenn Benachrichtigungen nicht ankommen:
- 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.
- Einige Befehle sind nur lokal verfügbar: Befehle, die eine interaktive Auswahl im Terminal öffnen, wie
/mcp,/pluginoder/resume, funktionieren nur über die lokale CLI. Befehle, die Textausgabe erzeugen, einschließlich/compact,/clear,/context,/usage,/exit,/extra-usage,/recapund/reload-plugins, funktionieren von mobil und Web aus.
Fehlerbehebung
„Remote Control erfordert ein claude.ai-Abonnement"
Sie sind nicht mit einem claude.ai-Konto authentifiziert. Führen Sie claude 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 von claude 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 Sie claude 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.
Wenn keine dieser Variablen festgelegt sind, führen Sie /logout und dann /login aus, um zu aktualisieren.
„Remote Control ist durch die Richtlinie Ihrer Organisation deaktiviert"
Dieser Fehler hat vier 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. Dieser Schalter ist eine serverseitige Organisationseinstellung.
- 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.
- Der Fehler erwähnt
disableRemoteControl: Ihr IT-Administrator hat Remote Control auf diesem Gerät über verwaltete Einstellungen deaktiviert, unabhängig vom organisationsweiten Schalter.
„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:
claude remote-control --verbose
Häufige Ursachen:
- 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 logsehen, 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