Claude Code auf einem VPS: Lass es auf einem Linux-Server laufen und steuere es vom Handy aus

Was du brauchst

• Einen Linux-Server, auf den du per SSH zugreifen kannst, von einem Anbieter wie DigitalOcean oder OVHcloud. Für die Claude-Code-CLI eignet sich jede Distribution; Claude Desktop braucht Ubuntu 22.04 oder neuer bzw. Debian 12 oder neuer.
• Ein Claude-Abo Pro, Max, Ultra, Team oder Enterprise. Remote Control funktioniert nicht mit API-Keys, und bei Team oder Enterprise muss es zuerst ein Owner einschalten.
• Die Claude-App auf deinem Handy (iOS oder Android) oder claude.ai/code in einem Browser.
• Optional eine Desktop-Umgebung und einen Remote-Desktop auf dem Server, für die Fälle, in denen Claude eine Website braucht, bei der du dich anmelden musst.

So richtest du Claude Code auf einem Linux-VPS ein

1. Miete einen Server und verbinde dich damit

   Erstelle bei einem Anbieter wie DigitalOcean oder OVHcloud einen Linux-Server und verbinde dich per SSH damit. Wählst du Ubuntu 22.04+ oder Debian 12+, bleibt Claude Desktop eine Option; auf jeder anderen Distribution nutzt du die CLI.

2. Installiere Claude Code und melde dich an

   Installiere die Claude-Code-CLI mit dem Installationsskript von Anthropic. Sie läuft im Terminal (Anthropic führt Ubuntu 20.04+ und Debian 10+ unter den unterstützten Systemen auf) und passt deshalb zu einem Headless-Server, den du nur per SSH erreichst. Unter Ubuntu 22.04+ oder Debian 12+ kannst du stattdessen Claude Desktop per apt installieren; unter Linux ist es eine Beta (siehe Claude Desktop unter Linux). Führe dann claude aus und melde dich mit deinem Claude-Konto an, nicht mit einem API-Key.

   curl -fsSL https://claude.ai/install.sh | bash

3. Starte Remote Control im Servermodus

   Führe in deinem Projektordner claude remote-control aus. Das startet einen Server, der mehrere Claude-Code-Sessions gleichzeitig hosten kann, und jede davon kannst du vom Handy aus öffnen. Mit --chrome schaltest du in diesen Sessions die Chrome-Integration ein. Sollen sich stattdessen alle interaktiven Sessions verbinden, setz remoteControlAtStartup in ~/.claude/settings.json auf true.

   # Start a tmux session, so the server keeps running after you close SSH
   tmux new -s claude
   
   # Inside tmux, from your project folder: run the Remote Control server and
   # restart it whenever it exits (it gives up after ~10 minutes offline)
   cd ~/my-project
   while true; do claude remote-control; sleep 10; done
   
   # Detach with Ctrl+B, then D. Reattach later with:
   tmux attach -t claude

4. Halt es nach dem Abmelden am Laufen

   Remote Control funktioniert nur, solange der claude-Prozess läuft: Schließt du das Terminal, gehen seine Sessions offline. Lass es in tmux oder screen laufen, damit es das Schließen der SSH-Verbindung übersteht, oder als Dienst. Der Servermodus beendet sich außerdem nach etwa 10 Minuten ohne Netz, also starte ihn automatisch neu, wie es die Schleife oben tut. Zu Permission Modes und Nutzungslimits bei langen Läufen siehe, wie du Claude Code 24/7 laufen lässt.

5. Öffne es vom Handy aus

   Öffne die Claude-App unter iOS oder Android oder claude.ai/code und wähle eine Session. Claude läuft auf dem Server; das Handy zeigt die Unterhaltung und schickt deine Nachrichten. Details zur Einrichtung und Lösungen für Probleme findest du im Guide zu Remote Control. Willst du Claude Code stattdessen aus Telegram schreiben, siehe Claude Code Channels.

Quelle: Dokumentation von Anthropic zu Remote Control

Einen Desktop zum Anmelden bei Websites hinzufügen

Ein Server, den du per SSH erreichst, hat keinen Bildschirm. Das ist kein Problem, bis Claude eine Website braucht, bei der du dich anmelden musst. Mit einem Remote-Desktop erledigst du diese Anmeldung selbst und lässt Claude dann den Browser nutzen.

• Installiere eine Desktop-Umgebung und einen Remote-Desktop-Server auf dem VPS und verbinde dich vom Laptop aus, wenn du dich irgendwo anmelden musst.
• Installiere Google Chrome oder Microsoft Edge mit der Erweiterung Claude in Chrome und melde dich bei den Websites an, die Claude nutzen soll. Claude in Chrome funktioniert unter Linux; in WSL wird es nicht unterstützt.
• Starte den Server mit claude remote-control --chrome, damit seine Sessions diesen Browser nutzen können.
• Erreiche den Remote-Desktop über Tailscale, das deine Geräte in ein privates Netzwerk bringt, ein Tailnet, in dem nur sie sich gegenseitig erreichen können. Siehe was Tailscale ist.
• Mit einem Desktop unter Ubuntu oder Debian ist neben der CLI auch Claude Desktop eine Option.

Was ein Linux-Server nicht kann

Ist dir etwas davon wichtig, nimm stattdessen einen Mac mini zu Hause, das Setup, mit dem die Person arbeitet, die Crewmark gegründet hat.

• Kein Computer Use. Claude kann unter Linux keine Apps und keinen Bildschirm bedienen: In der CLI gibt es Computer Use nur unter macOS, und in Claude Desktop ist es eine Research Preview unter macOS und Windows.
• Keine iOS-Entwicklung. Xcode und der iOS Simulator laufen nur unter macOS, ein Linux-Server kann also keine iPhone-App bauen oder ausführen.
• Eine kleinere Desktop-App. Claude Desktop unter Linux ist eine Beta für Ubuntu und Debian, ohne Computer Use, Cowork oder Spracheingabe.
• Ein Prozess, der laufen muss. Wie bei jedem Remote-Control-Setup sind die Sessions nur erreichbar, solange claude auf dem Server läuft.

Mac mini vs. Linux-VPS für Claude Code

Gib dem Server einen festen Job

Ein Server, der nie schläft, antwortet, wann immer du ihm schreibst, und wartet, wenn du es nicht tust. Crewmark macht aus einer Claude-Code-Unterhaltung darauf einen KI-Mitarbeiter mit Rolle, Zielen, Arbeitszeiten und einem Heartbeat: Während der Arbeitszeit weckt die crewmark-CLI, die unter Linux genauso läuft wie unter macOS und Windows, den Mitarbeiter, damit er seine Issues auf einem gemeinsamen Board abarbeitet. Der Computer, auf dem er läuft, muss an bleiben, und ein VPS tut das.

1. Stell einen Mitarbeiter ein

   Wähle eine Rolle aus den Rollen für KI-Mitarbeiter, etwa Softwareentwickler oder SEO-Spezialist, und schreib seine Ziele und KPIs auf.

2. Verbinde Claude Code auf dem Server

   Füge den Setup-Link in eine Claude-Code-Unterhaltung auf dem VPS ein. Er installiert die crewmark-CLI und verknüpft diese Unterhaltung mit dem Mitarbeiter. Codex funktioniert auch.

3. Leg Arbeitszeiten und einen Heartbeat fest

   Nur werktags oder jeden Tag, Zeiten, die über Mitternacht gehen können, und ein Weckruf alle 15, 30, 60, 120 oder 240 Minuten.

4. Weise Issues vom Handy aus zu

   Leg Issues auf dem Board unter crewmark.ai in jedem Browser an und weise sie zu; eine Zuweisung weckt den Mitarbeiter sofort. Braucht er ein Review oder eine Entscheidung, setzt er das Issue auf „Handlungsbedarf“ und fragt dich dort. Jobs, die du ihm geben kannst, findest du unter Anwendungsfälle für Claude Code.

FAQ