Der Code liegt auf einem Windows-PC, aber das Kursprojekt braucht macOS-Werkzeuge?
Schnellste Lösung: Claude Code Desktop kann unter Windows als Oberfläche eine SSH-Verbindung zu einem Remote Mac nutzen. Claude Code und die Projektwerkzeuge laufen dann auf dem entfernten Mac. SSH zeigt jedoch nicht dessen Schreibtisch an; für Xcode-Fenster oder den Simulator ist zusätzlich ein grafischer Fernzugriff nötig. Die offizielle Anleitung für SSH-Sitzungen beschreibt diesen Unterschied.
Für wen dieser Leitfaden gedacht ist: Windows-Nutzer, die Claude Code an einem macOS-Projekt verwenden möchten, finden hier den Weg von der Verbindung bis zur ersten Prüfung.
Studierende mit Swift- oder iOS-Aufgaben können die Schritte nutzen, um zu testen, ob der Kurs mit Terminalzugriff erledigt werden kann.
Wer nur den Mac-Bildschirm sehen oder Xcode-Fenster bedienen muss, sollte zuerst den Bedarf an grafischem Zugriff klären.
Zuletzt aktualisiert am 13.10.2026; abgeglichen mit der offiziellen Dokumentation zu Claude Code Desktop, den SSH-Hinweisen für Windows und den Apple-Anleitungen zum Remote-Zugriff.
[ SECTION_01 ] Claude Code Desktop mit einem Remote Mac verbinden: erst den passenden Zugriff wählen
Eine SSH-Verbindung ist passend, wenn Claude Code Dateien auf dem Remote Mac lesen und bearbeiten oder dort Befehle ausführen soll. Sie ist kein Fernsteuerungsbildschirm. Die Unterscheidung erspart den häufigsten Fehlstart: Ein geöffnetes Desktop-Fenster auf Windows bedeutet nicht, dass auf dem Windows-PC auch das macOS-Projekt liegt.
Die offizielle Dokumentation nennt Remote-Sitzungen über SSH auf macOS- oder Linux-Systemen. Bei einer unterstützten Verbindung kann Claude Code Desktop die Einrichtung von Claude Code auf dem entfernten Host übernehmen. Maßgeblich sind die jeweils aktuellen Voraussetzungen und SSH-Angaben für Desktop; prüfen Sie diese vor dem ersten Login, statt von einer Anleitung für eine ältere Version auszugehen.
| Aufgabe | SSH zum Remote Mac | Grafischer Fernzugriff |
|---|---|---|
| Projektdateien lesen und bearbeiten | Geeignet, wenn das Projekt auf dem Remote Mac liegt | Ebenfalls möglich, aber nicht zwingend erforderlich |
| Terminalbefehle und unterstützte Build-Werkzeuge ausführen | Ja, auf dem Remote Mac | Ja, über ein Terminalfenster auf dem Mac |
| Xcode-Fenster anklicken oder Einstellungen in der Oberfläche prüfen | Nein | Dafür ist eine Desktop-Ansicht erforderlich |
| Simulatorbild ansehen und mit der Oberfläche interagieren | SSH allein genügt nicht | Erfordert einen geeigneten grafischen Zugriff |
| Bedienoberfläche von Claude Code Desktop | Läuft auf dem Windows-PC | Kann je nach gewähltem Zugriff zusätzlich am Mac sichtbar sein |
Die Tabelle trennt zwei Ebenen: die Oberfläche, über die der Auftrag formuliert wird, und den Rechner, auf dem das Projekt bearbeitet wird. Bei einer Remote-Sitzung bleibt die Claude-Code-Oberfläche lokal. Dateien und Befehle gehören zum ausgewählten Verzeichnis auf dem Remote Mac. Das ist für Studierende wichtig, die zwischen lokalem Unterrichtsordner und entferntem Projektordner unterscheiden müssen.
[ SECTION_02 ] Vor dem Verbindungsaufbau: Host, Konto und Kursordner prüfen
Ein Host ist der entfernte Rechner, ähnlich wie eine Zieladresse auf einem Paket. Der Hostname oder die IP-Adresse sagt dem SSH-Programm, welchen Rechner es ansprechen soll. Dazu gehören ein gültiger Benutzername und gegebenenfalls ein abweichender Port. Fehlt eine dieser Angaben oder ist die Verbindung im Schulnetz gesperrt, hilft eine Neuinstallation von Claude Code nicht weiter.
Klären Sie vorab mit der zuständigen Person, ob der Remote Mac für den Kurs freigegeben ist. Bei einem Mac muss der SSH-Zugang passend eingerichtet sein; Apple beschreibt die Funktion als „Remote Login“ in den Einstellungen für den Fernzugriff auf einen Mac. Eine erfolgreiche Anmeldung setzt außerdem voraus, dass Netzwerkregeln und Kontoberechtigungen den Zugriff zulassen.
Ein Projektordner ist der Arbeitsbereich mit Quellcode und zugehörigen Dateien – vergleichbar mit einem abgegrenzten Schreibtischfach für genau eine Aufgabe. Fragen Sie nach dem vollständigen Pfad, zum Beispiel dem Ordner, den die Kursleitung für das Projekt vorgesehen hat. Öffnen Sie nicht vorsorglich das gesamte Benutzerverzeichnis: Ein enger, freigegebener Projektpfad verringert das Risiko, versehentlich private oder nicht zum Kurs gehörende Dateien zu verändern.
Für Windows kann der OpenSSH-Client verwendet werden. Microsoft dokumentiert Installation und erste Verbindung im Leitfaden zu OpenSSH unter Windows. In einer PowerShell-Sitzung lässt sich eine Verbindung grundsätzlich mit einer Form wie ssh BENUTZER@HOST testen. Wird ein anderer Port vorgegeben, kann die SSH-Option -p verwendet werden; übernehmen Sie dabei ausschließlich die Angaben des Administrators. Der Standardport 22 ist ein technischer Ausgangswert, aber kein Beweis dafür, dass ein konkreter Server darüber erreichbar ist.
[ SECTION_03 ] Erster Verbindungsversuch in Claude Code Desktop
Schritt 1: Desktop und SSH-Zugang getrennt prüfen
Installieren und starten Sie Claude Code Desktop auf dem Windows-Rechner nur dann, wenn Ihre Windows-Version die in der offiziellen Installations- und Systemanforderungsübersicht genannten Voraussetzungen erfüllt. Die Desktop-App und SSH sind zwei getrennte Bausteine: Die App liefert die Arbeitsoberfläche, SSH stellt die Verbindung zum entfernten Host her.
Bevor Sie in Desktop weiterarbeiten, testen Sie den bereitgestellten Zugang bei Bedarf in PowerShell. Kann bereits die einfache SSH-Anmeldung den Host nicht erreichen, sollten zuerst Adresse, Netzwerkzugang und Kontofreigabe geklärt werden. Vermeiden Sie wiederholte Versuche mit geratenen Hostnamen oder Passwörtern. Schulgeräte und Schulnetze können Fernzugriffe einschränken; diese Regeln dürfen nicht umgangen werden.
Schritt 2: Hostdaten in den vorgesehenen Feldern eintragen
Wählen Sie in Claude Code Desktop die Funktion zum Hinzufügen oder Verbinden eines Remote-Hosts. Tragen Sie die Daten so ein, wie sie für den Zugang bereitgestellt wurden:
- Hostname oder Adresse: Name oder IP-Adresse des Remote Mac.
- Benutzername: das Konto, das auf diesem Host zugelassen ist.
- Port: der vorgegebene SSH-Port, falls er vom Standard abweicht.
- Identitätsdatei: der Pfad zum privaten SSH-Schlüssel, wenn die Verbindung Schlüssel statt eines Passworts verwendet.
- SSH-Konfiguration: falls angeboten oder dokumentiert, ein vorhandener SSH-Eintrag, der diese Daten bereits bündelt.
Die genaue Anzeige kann sich mit einer Desktop-Version ändern. Maßgeblich ist der aktuelle Dialog und die offizielle SSH-Anleitung, nicht ein Screenshot aus einem älteren Tutorial. Wenn bereits eine SSH-Konfigurationsdatei mit dem passenden Hosteintrag vorhanden ist, prüfen Sie anhand der Desktop-Hilfe, ob dieser Eintrag direkt verwendet werden kann. Doppelte, abweichende Angaben erschweren später die Fehlersuche.
Ein privater Schlüssel ist wie ein persönlicher Türschlüssel für den Zugang. Er gehört nicht in einen Chat, eine Aufgabenbeschreibung oder ein Eingabefeld für Claude Code. Geben Sie auch das zugehörige Passwort, den Kontoschlüssel oder andere Zugangsdaten nicht an andere Personen weiter. Falls ein Schlüssel verloren geht oder versehentlich offengelegt wird, informieren Sie die zuständige Administration, statt ihn weiterzuverwenden.
Wichtig: Eine Fehlermeldung wegen eines nicht erreichbaren Hosts ist kein Anlass, die Sicherheitsvorgaben zu ändern. Lassen Sie Adresse, Konto, Schlüssel und Netzfreigabe von der zuständigen Stelle prüfen. Auf einem verwalteten Schulcomputer dürfen Sie keine Sperren oder Richtlinien eigenmächtig umgehen.
Schritt 3: Verbindung herstellen und das entfernte Projekt öffnen
Starten Sie die Verbindung und wählen Sie anschließend den freigegebenen Kursordner auf dem Remote Mac. Prüfen Sie den angezeigten Pfad, bevor Sie Dateien bearbeiten lassen. Wenn Desktop eine erstmalige Installation von Claude Code auf dem entfernten Host anbietet oder ausführt, muss dieser Schritt im Rahmen der offiziellen Verbindungsfunktion erfolgen. Ersetzen Sie ihn nicht durch selbst erfundene Installationsbefehle.
Führen Sie zuerst eine harmlose Abfrage aus, etwa die Anzeige des aktuellen Verzeichnisses oder die Auflistung der Dateien. Der Zweck ist nicht, sofort Code zu erzeugen, sondern den Arbeitsort zu bestätigen. Stimmen Pfad und Projektdateien nicht mit den Kursunterlagen überein, brechen Sie ab und lassen Sie den richtigen Ordner nennen.
Das ist auch die Antwort auf die Frage, wo der Code läuft: Die Claude-Code-Oberfläche bleibt auf Windows, aber die Remote-Sitzung arbeitet mit dem Projekt auf dem Mac. Ein lokales Windows-Verzeichnis mit ähnlich benanntem Ordner ist nicht automatisch mit dem Remote-Projekt synchronisiert. Speichern Sie deshalb keine Abgabe in der Annahme, sie sei bereits auf dem anderen Rechner angekommen.
[ SECTION_04 ] Erste Kursübung: Änderungen und Ergebnisse kontrollieren
Schritt 4: Eine kleine, überprüfbare Aufgabe wählen
Beginnen Sie mit einer Änderung, die sich leicht rückgängig machen und beurteilen lässt. Bitten Sie Claude Code beispielsweise, eine kurze Funktion in einer vorhandenen Quelldatei zu erläutern oder eine kleine, klar abgegrenzte Änderung vorzuschlagen. Nennen Sie den Kursordner und die betroffene Datei eindeutig. Vermeiden Sie Anweisungen wie „räum das ganze Projekt auf“, solange die Arbeitsweise noch nicht geprüft ist.
Vor dem Anwenden einer Änderung sollten Sie verstehen, welche Datei betroffen ist und was sich ändern soll. Lassen Sie keine Zugangsdaten, persönlichen Dokumente oder nicht freigegebenen Kursdateien als Kontext verwenden. Eine saubere Projektgrenze hilft sowohl bei der Übersicht als auch beim Datenschutz.
Schritt 5: Den Unterschied vor dem Übernehmen ansehen
Kontrollieren Sie den Änderungsvorschlag Datei für Datei. Git kann Änderungen zwischen Arbeitskopie und Vergleichsstand anzeigen; die Bedeutung des Befehls und der Ausgabedifferenzen erläutert die Dokumentation zu git diff. Eine Diff-Ansicht ist kein Qualitätssiegel: Sie zeigt, was verändert wurde, nicht automatisch, ob die Änderung die Aufgabenstellung erfüllt.
Prüfen Sie insbesondere, ob unerwartete Dateien verändert oder neue Dateien angelegt wurden. Vergleichen Sie die Änderung mit den Vorgaben der Lehrveranstaltung und behalten Sie die Möglichkeit, nicht passende Vorschläge abzulehnen. Wenn das Projekt keine Git-Verwaltung verwendet, erstellen Sie vor Änderungen eine nach den Kursregeln zulässige Sicherung oder bitten Sie die Kursleitung um die vorgesehene Vorgehensweise.
Schritt 6: Das Ergebnis dort ausführen, wo das Projekt liegt
Wenn Sie einen Test oder Build starten, prüfen Sie zuerst, ob das verwendete Werkzeug auf dem Remote Mac verfügbar ist und ob Sie im richtigen Projektordner arbeiten. Ein Befehl, der in der SSH-Sitzung gestartet wird, läuft auf dem Remote Mac und verwendet dessen Dateien und installierte Werkzeuge. Er läuft nicht auf dem Windows-PC, nur weil Claude Code Desktop dort geöffnet ist.
Für Xcode-Aufgaben sind zwei Ergebnisse auseinanderzuhalten: Ein Befehl kann eine Kompilierung oder einen Test im Terminal anstoßen; eine grafische Abnahme kann trotzdem Xcode oder den sichtbaren iOS-Simulator erfordern. Apple dokumentiert die verfügbaren Xcode-Befehlszeilenwerkzeuge. Daraus folgt nicht, dass eine SSH-Sitzung einen Simulatorbildschirm bereitstellt.
Notieren Sie bei einer Kursabgabe, welcher Befehl ausgeführt wurde und welche Ausgabe zurückkam. Stimmen Fehlermeldung, Projektanforderung und erwartetes Ergebnis nicht überein, sollte die Aufgabe nicht einfach als erfolgreich markiert werden. Claude Code kann beim Bearbeiten helfen, ersetzt aber nicht die Prüfung durch die Person, die für die Abgabe verantwortlich ist.
[ SECTION_05 ] Prüfliste für die Entscheidung nach dem ersten Test
Gehen Sie die Punkte nacheinander durch. Wenn ein Punkt nicht erfüllt ist, klären Sie ihn, bevor Sie mit echten Kursdateien oder einer Abgabe fortfahren.
- [ ] Der Remote Mac ist für den Kurs freigegeben und im verwendeten Netzwerk erreichbar.
- [ ] Host, Benutzername und gegebenenfalls Port stammen aus einer verlässlichen, autorisierten Quelle.
- [ ] Der Zugriff funktioniert ohne Umgehung von Schulrichtlinien oder Gerätesperren.
- [ ] Der ausgewählte Pfad zeigt auf den vorgesehenen Remote-Projektordner.
- [ ] Eine harmlose Anzeige oder Abfrage bestätigt, dass die Sitzung auf dem Remote Mac arbeitet.
- [ ] Der private Schlüssel und andere Zugangsdaten bleiben außerhalb von Prompts und geteilten Chats.
- [ ] Vor einer Abgabe wurden Dateiunterschiede und Testergebnisse selbst geprüft.
- [ ] Die Kursanforderung lässt sich mit Terminalzugriff erfüllen oder ein zusätzlicher grafischer Zugriff ist organisiert.
Sind Projektzugriff und Terminalaufgaben ausreichend, kann die SSH-Arbeitsweise für diesen Kurs genügen. Verlangt die Abgabe die Bedienung von Xcode-Fenstern, eine visuelle Kontrolle des Simulators oder einen Screenshot vom Mac-Desktop, planen Sie zusätzlich eine grafische Verbindung ein. Apple beschreibt dafür die Bildschirmfreigabe zwischen Macs in der Anleitung zur Bildschirmfreigabe; die konkrete Verfügbarkeit hängt dennoch von der eingerichteten Umgebung und den Zugriffsrechten ab.
Häufige Fragen
Kann Claude Code Desktop unter Windows eine Verbindung zu einem Mac herstellen?
Ja, sofern die installierte Desktop-Version die offiziellen Voraussetzungen erfüllt und der Remote Mac für SSH-Verbindungen eingerichtet ist. Die Windows-App bleibt dabei die Bedienoberfläche; sie stellt keine lokale macOS-Umgebung bereit. Vor dem ersten Versuch sollten Host, Konto, Netzwerkfreigabe und gegebenenfalls Schlüssel geklärt sein. Bei einem verwalteten Schulgerät entscheidet außerdem die geltende IT-Richtlinie, ob die Verbindung zulässig ist.
Wie wird in Claude Code Desktop ein SSH-Host hinzugefügt?
Öffnen Sie die Remote-Verbindungsfunktion und verwenden Sie die Angaben des Administrators: Hostadresse, Benutzername, gegebenenfalls Port und bei schlüsselbasierter Anmeldung den Pfad zur Identitätsdatei. Ein vorhandener SSH-Konfigurationseintrag kann Arbeit sparen, sofern die aktuelle Desktop-Anleitung dessen Verwendung unterstützt. Nach dem Verbinden ist der Projektpfad zu prüfen, bevor Claude Code Änderungen vornehmen darf.
Wo liegen Projektdateien und Befehle nach der Verbindung?
Bei einer Remote-SSH-Sitzung wird das ausgewählte Projekt auf dem entfernten Mac bearbeitet. Befehle, die in dieser Sitzung gestartet werden, verwenden dessen Umgebung und Werkzeuge. Claude Code Desktop läuft weiterhin auf dem Windows-Rechner. Prüfen Sie deshalb den angezeigten Ordner und führen Sie eine harmlose Abfrage aus; ein gleichnamiges lokales Verzeichnis ist keine automatische Kopie des Remote-Projekts.
Kann SSH Xcode und den Simulator auf dem Mac-Bildschirm anzeigen?
Nein. SSH ermöglicht Kommandozeilenzugriff und Projektarbeit, überträgt aber nicht von sich aus die grafische Oberfläche. Ein Xcode-Werkzeug kann im Terminal nutzbar sein, doch daraus folgt keine sichtbare Xcode-Sitzung und kein Simulatorbild. Wenn die Aufgabe eine grafische Bedienung oder visuelle Abnahme verlangt, muss zusätzlich geprüft werden, ob ein genehmigter Desktop-Zugriff verfügbar ist.
Ein lokaler Windows-Rechner bleibt für viele Lernaufgaben der einfachste Weg, bringt aber macOS-spezifische Werkzeuge nicht auf den eigenen Bildschirm. Eine reine SSH-Verbindung löst den Zugriff auf Projektdateien und Terminal, nicht die fehlende grafische Ansicht; ein unfreigegebener Schulrechner kann außerdem Installation und Netzwerkzugriff begrenzen. Ist für den Kurs tatsächlich ein Mac nötig und steht keiner zur Verfügung, kann ein zeitlich begrenzter Remote Mac bei NOVAKVM eine Möglichkeit sein, statt sofort Hardware zu kaufen. Prüfen Sie vorab die angebotenen Zugangswege und vergleichen Sie sie mit den konkreten Kursanforderungen; Informationen finden Sie auf der NOVAKVM-Übersicht zu Remote Macs sowie bei den Mac-Mini-Angeboten. Braucht die Aufgabe dauerhaft hohe lokale Rechenleistung oder physische Anschlüsse, ist eine eigene geeignete Hardware möglicherweise passender.