Claude Code vom Handy aus

Was es ist und warum es zählt

Du sitzt im Zug und dir fällt ein, was du noch reparieren musst. Das Projekt ist aber auf dem Computer, zu Hause. Remote Control ist die offizielle Funktion von Claude Code genau dafür: Sie verbindet die Claude-App auf dem Handy (iOS oder Android) oder claude.ai/code im Browser mit einer Sitzung von Claude Code, die auf deinem Computer läuft.

Worauf es ankommt: Claude arbeitet auf deinem Computer, nicht in der Cloud. Dateien, Tools, MCP-Server und Projekteinstellungen bleiben dort. Das Handy ist nur ein Fenster zu dieser Sitzung, und das Gespräch ist überall dasselbe: Du kannst im Terminal, im Browser und auf dem Handy schreiben, abwechselnd.

Remote Control hat die Research Preview, die Testphase, verlassen. Keine selbstgebauten Bots und keine offenen Ports auf dem Computer. Der Haken: Der Computer bleibt an, mit offenem Claude Code.

1. Was du brauchst

• Ein Pro-, Max-, Team- oder Enterprise-Abo. Mit einem API-Schlüssel funktioniert es nicht.
• Bei Team und Enterprise schaltet zuerst ein Owner der Organisation den Schalter Remote Control in den Admin-Einstellungen von Claude Code ein: Standardmäßig ist er aus.
• Die Anmeldung mit deinem claude.ai-Konto: Tippe in Claude Code /login.
• Claude Code direkt mit der API von Anthropic verbunden. Mit Amazon Bedrock, Google Cloud oder Microsoft Foundry funktioniert es nicht, und auch nicht, wenn ANTHROPIC_BASE_URL auf eine andere Adresse zeigt, etwa ein Gateway oder einen Proxy.
• Die Claude-App auf dem Handy, mit demselben Konto. Wenn du sie nicht hast, tippe in Claude Code /mobile: Es erscheint ein QR-Code, der den richtigen App Store öffnet.

Wenn etwas nicht startet, tippe im Terminal claude doctor: Es sagt dir, welche Prüfung fehlgeschlagen ist.

2. Auf dem Computer einschalten: drei Wege

Servermodus: claude remote-control

Den nutze ich fürs Handy. Tippe im Projektordner:

claude remote-control

Das Terminal wartet und zeigt dir den Link der Sitzung. Drück die Leertaste und es erscheint ein QR-Code: Scann ihn mit dem Handy und er öffnet sich in der Claude-App. In diesem Modus tippst du nicht im Terminal: Es zeigt den Verbindungsstatus und was Claude gerade tut. Dafür kannst du mehrere Sitzungen gleichzeitig öffnen.

Normale Sitzung: claude --remote-control

Öffnet die gewohnte Sitzung im Terminal, in der du tippen kannst, und sie ist auch vom Handy aus erreichbar. Die Kurzform ist claude --rc, und du kannst ihr einen Namen geben: claude --remote-control "Mein Projekt".

Aus einer schon offenen Sitzung: /remote-control

Du arbeitest schon und musst los? Tippe /remote-control (oder /rc) in der Sitzung: Du machst auf dem Handy mit dem ganzen bisherigen Gespräch weiter. Das geht auch in der Desktop-App von Claude und in der Erweiterung für VS Code.

3. Beim ersten Mal: die Fragen, die du nicht überspringen solltest

Beim ersten Mal erklärt claude remote-control, was es tut, und fragt Enable Remote Control? (y/n). Antworte mit y. Sagst du nein, beendet es sich, ohne zu starten, und fragt beim nächsten Mal wieder.

Wenn du dem Ordner noch nicht vertraust, sagt es dir, was das Vertrauen einschaltet, und fragt Trust <Ordner>? [y/N]. Die Antwort wird gespeichert, außer in deinem Home-Ordner: Dort fragt es bei jedem Start. Deshalb startest du es im Projektordner.

Es kann dich auch fragen, wie Sitzungen angelegt werden. Mit same-dir arbeiten alle im selben Ordner, und wenn zwei dieselbe Datei anfassen, kommen sie sich in die Quere. Mit worktree bekommt jede neue Sitzung ihre eigene Kopie des Projekts (einen Git-Worktree). Öffnest du eine Sitzung nach der anderen, passt same-dir. Während es läuft, wechselst du mit w.

4. Vom Handy aus: die Karte deines Computers

1. Öffne die Claude-App und tippe auf Code.
2. Oben findest du deinen Computer als Gerätekarte. Sie ist da, solange claude remote-control läuft.
3. Tipp sie an, wähl den Projektordner, und dort startet eine Sitzung, auf deinem Computer.
4. Schon offene Sitzungen stehen in der Liste darunter: Die von Remote Control haben ein Computer-Symbol, mit einem grünen Punkt, wenn sie online sind.

Jetzt schreibst du wie am Computer; mit @ ergänzt du die Dateinamen des Projekts. Du kannst ein Foto oder eine Datei anhängen, auch ohne Text: Fotos sieht Claude direkt in der Nachricht, andere Dateien lädt Claude Code auf den Computer und gibt sie Claude weiter. Perfekt für einen Bug, den du auf dem Handy siehst:

Ich hänge dir einen Screenshot von einem Fehler an, den ich auf dem Handy sehe. Finde heraus, woher er im Code kommt, behebe ihn und lass die Tests laufen. Wenn die Tests fertig sind, schick mir eine Benachrichtigung mit dem Ergebnis.

5. Benachrichtigungen auf dem Handy

Claude kann dir eine Benachrichtigung schicken, wenn eine lange Aufgabe fertig ist oder es eine Entscheidung von dir braucht. So schaltest du sie ein:

1. Melde dich in der Claude-App mit demselben Konto und derselben Organisation an, die du in Claude Code nutzt.
2. Erlaube Benachrichtigungen, wenn das Handy danach fragt.
3. Tippe im Terminal /config und schalte Push when Claude decides (Benachrichtigungen, die Claude selbst schickt), Push when actions required (Berechtigungen und Fragen) oder beides ein.

Zeigt /config No mobile registered, öffne die Claude-App auf dem Handy: Sie erneuert die Verbindung für Benachrichtigungen. Und während du im verbundenen Terminal tippst, kommen keine, weil du ja schon dort bist.

6. Computer an, Netz fällt aus

• Geht der Laptop in den Ruhezustand oder fällt das Netz aus, verbindet sich Claude Code von selbst neu, sobald der Computer wieder online ist. Während er schläft, arbeitet Claude aber nicht.
• Ist der Computer an, aber lange ohne Netz, gibt Claude Code im Servermodus nach etwa 10 Minuten auf und claude remote-control beendet sich: Du musst es neu starten. Eine normale Sitzung versucht es weiter, bis das Netz zurück ist.
• Schließt du das Terminal oder stoppst den Server mit Ctrl+C, geht die Sitzung offline. Startest du claude remote-control innerhalb von etwa vier Stunden im selben Ordner neu, holst du die vorherigen Sitzungen zurück.

Um einen Mac wach zu halten, gibt es caffeinate, einen Befehl, der in macOS schon eingebaut ist: So gestartet, verhindert er den Ruhezustand bei Inaktivität, solange der Server offen ist. Den Deckel lässt du aber offen.

caffeinate -i claude remote-control

Häufige Fehler

• ANTHROPIC_API_KEY gesetzt haben: Die Sitzung nutzt den Schlüssel statt des Abos, und Remote Control startet nicht. Entfern ihn aus dem Terminal oder aus dem env-Block der settings.json.
• claude remote-control aus dem Home-Ordner starten: Die Vertrauensfrage kommt bei jedem Start wieder, und die Sitzung startet nicht im Projekt.
• Den Laptop zuklappen und erwarten, dass Claude weitermacht. Es arbeitet nur, solange der Computer wach und der Befehl offen ist.
• Auf Benachrichtigungen warten, ohne sie in /config eingeschaltet zu haben. Auf dem iPhone prüf auch die Fokus-Modi und die Mitteilungszusammenfassung, die sie blockieren oder verzögern können.

Checkliste

• Ich habe einen Pro-, Max-, Team- oder Enterprise-Plan, und bei Team oder Enterprise hat der Owner Remote Control eingeschaltet
• Ich habe mich mit /login über mein claude.ai-Konto angemeldet, ohne gesetzte API-Schlüssel
• claude remote-control läuft im Projektordner
• In der Claude-App sehe ich unter Code meinen Computer ganz oben
• Ich habe ein Foto vom Handy geschickt und Claude hat es gesehen
• Benachrichtigungen sind in /config eingeschaltet
• Der Computer bleibt an und geht nicht in den Ruhezustand

Häufige Fragen