Kurze Zusammenfassung: Die Installation von Claude Code unter Windows erfordert die Einrichtung von WSL2 (Windows Subsystem for Linux), die Installation von Ubuntu und die Ausführung eines einfachen Installationsskripts. Der Prozess ermöglicht Windows-Benutzern den Zugriff auf den KI-Codierungsassistenten von Anthropic über ihr Terminal. Native Windows-Binärdateien sind verfügbar, dennoch ist WSL2 für die Installation unter Windows weiterhin die beste Vorgehensweise.
Claude Code ist ein KI-gestützter Codierungsassistent, der direkt im Terminal läuft und Entwicklern hilft, Features zu erstellen, Fehler zu beheben und Entwicklungsaufgaben zu automatisieren. Für Windows-Benutzer gibt es jedoch einen Haken.
Claude Code ist als native Windows-Executable verfügbar und kann über npm oder einen direkten Binärdownload ohne WSL2 installiert werden. Es erfordert jedoch das Windows Subsystem for Linux (WSL2), und die offizielle Installationsmethode basiert immer noch auf WSL2.
Hier erfahren Sie, wie Sie es unter Windows 11 oder Windows 10 zum Laufen bringen.
Systemanforderungen
Bevor Sie mit der Installation beginnen, überprüfen Sie, ob der Windows-Computer die folgenden Anforderungen erfüllt:
- Windows 10 1809+ oder Windows Server 2019+
- Windows 11 (beliebige Version)
- Mindestens 4 GB verfügbarer RAM
- Administratorrechte auf dem System
- Internetverbindung zum Herunterladen von WSL2 und Ubuntu
Die Installation erfordert Speicherplatz für WSL2, Ubuntu und Claude Code.
Schritt 1: Windows Subsystem for Linux aktivieren
WSL2 bietet eine Linux-Umgebung direkt unter Windows. Es ist die Grundlage, die es Claude Code ermöglicht, zu funktionieren.
Öffnen Sie PowerShell als Administrator. Klicken Sie mit der rechten Maustaste auf die Schaltfläche Start und wählen Sie „Windows PowerShell (Admin)“ oder „Terminal (Admin)“ unter Windows 11.
Führen Sie diesen Befehl aus:
wsl –install
Dieser Befehl aktiviert die notwendigen Windows-Funktionen und installiert Ubuntu als Standard-Linux-Distribution. Das System fordert wahrscheinlich einen Neustart an.
Nach dem Neustart schließt WSL2 die Einrichtung automatisch ab. Ubuntu startet und fragt nach einem Benutzernamen und einem Passwort. Diese Anmeldedaten gelten nur für die Linux-Umgebung – sie müssen nicht mit den Windows-Anmeldedaten übereinstimmen.
Schritt 2: WSL2-Installation überprüfen
Nachdem das System neu gestartet wurde und Ubuntu die anfängliche Einrichtung abgeschlossen hat, überprüfen Sie, ob WSL2 korrekt ausgeführt wird.
Öffnen Sie das Ubuntu-Terminal (suchen Sie nach „Ubuntu“ im Startmenü) und führen Sie aus:
wsl –version
Dies zeigt die WSL-Versionsinformationen an. Achten Sie im Ausgabe auf „WSL version: 2.x.x“.
Wenn der Befehl stattdessen WSL1 anzeigt, aktualisieren Sie auf WSL2 mit:
wsl –set-default-version 2
Schritt 3: Claude Code installieren
Nun zur eigentlichen Installation von Claude Code. Die offizielle Dokumentation bietet ein einzeiliges Installationsskript.
Führen Sie im Ubuntu-Terminal aus:
curl -fsSL claude.ai/install.sh | bash
Das Skript lädt die Claude Code-Binärdatei herunter, richtet die notwendigen Berechtigungen ein und fügt sie dem System-PATH hinzu. Die Installationsdauer hängt von der Internetgeschwindigkeit und den Systempezifikationen ab.
Laut der offiziellen Claude Code-Dokumentation erkennt der Installer automatisch die Systemarchitektur und lädt die entsprechende Binärversion herunter.
Häufige Installationsprobleme
Einige Windows-Benutzer berichten von der Meldung „command not found: claude“ nach der Installation. Dies geschieht normalerweise, weil die PATH-Variable noch nicht aktualisiert wurde.
Schließen und öffnen Sie das Ubuntu-Terminal erneut und versuchen Sie es dann noch einmal. Wenn das Problem weiterhin besteht, kann diese Pfadkonfiguration als inoffizieller Workaround helfen:
echo ‘export PATH=”$HOME/.claude/bin:$PATH”‘ >> ~/.bashrc
source ~/.bashrc
Schritt 4: Claude Code authentifizieren
Claude Code erfordert vor der Verwendung eine Authentifizierung mit einem Anthropic-Konto.
Führen Sie diesen Befehl aus:
claude
Das Terminal zeigt eine URL an und fordert zur Authentifizierung auf. Der Prozess variiert geringfügig für Einzelbenutzer im Vergleich zu Teamkonten:
| Kontotyp | Authentifizierungsmethode | Was ist erforderlich |
|---|---|---|
| Einzelperson | Persönlicher API-Schlüssel | Anthropic-Konto mit API-Zugriff |
| Team/Organisation | Organisationstoken | Vom Administrator bereitgestelltes Authentifizierungstoken |
Öffnen Sie die angezeigte URL in einem Browser, melden Sie sich beim Anthropic-Konto an und autorisieren Sie Claude Code. Das Terminal bestätigt die erfolgreiche Authentifizierung.
Arbeiten mit Windows-Projekten in WSL2
Hier wird es knifflig. Windows-Dateisysteme und WSL2-Dateisysteme sind getrennt.
Windows-Dateien sind von WSL2 unter /mnt/c/ (für Laufwerk C:), /mnt/d/ (für Laufwerk D:) und so weiter zugänglich. Es gibt jedoch einen Performance-Nachteil. Community-Diskussionen deuten auf Performance-Unterschiede zwischen auf Windows gemounteten und nativen WSL2-Verzeichnissen hin.
Für beste Leistung kopieren Sie Projektdateien in das WSL2-Home-Verzeichnis:
cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project
Der Kompromiss? Die IDE-Integration wird komplexer. Visual Studio Code bewältigt dies gut mit seiner Remote-WSL-Erweiterung, aber andere IDEs haben möglicherweise Schwierigkeiten.
Testen der Installation
Überprüfen Sie mit einem einfachen Test, ob Claude Code korrekt funktioniert.
Navigieren Sie zu einem Projektverzeichnis (oder erstellen Sie einen Testordner):
mkdir ~/claude-test
cd ~/claude-test
claude “create a simple hello world Python script”
Claude Code sollte antworten, die Datei erstellen und den Code anzeigen. Dies bestätigt, dass die Installation erfolgreich war.
Überzahlen stoppen, zuerst verfügbare KI-Gutschriften beanspruchen
Die Installation von Claude Code unter Windows ist normalerweise schnell. Die tatsächlichen Kosten erscheinen später, wenn Entwickler mit dem Testen von Prompts, dem Ausführen von Skripten und der Integration des Modells in Anwendungen beginnen. Diese Experimentierphase kann viele API-Aufrufe generieren, und viele Teams erkennen die Kosten erst, nachdem sie mit dem Erstellen beginnen.
Bevor Sie Geld für die Nutzung ausgeben, lohnt es sich zu prüfen, ob Sie Anspruch auf KI-Guthaben oder Partnerprogramme haben. Get AI Perks sammelt diese Möglichkeiten an einem Ort und listet Gutschriften und Rabatte von KI-Anbietern, Cloud-Plattformen und Entwicklertools sowie einfache Anweisungen zur Beanspruchung auf.
Bevor Sie Ihr erstes Claude Code-Projekt ausführen, besuchen Sie Get AI Perks und beanspruchen Sie die KI-Guthaben, die Ihre Entwicklungskosten decken können.
Häufig gestellte Fragen
Kann Claude Code nativ unter Windows ohne WSL2 ausgeführt werden?
Ja, aber WSL2 bleibt weiterhin die beste Installationsmethode für Windows.
Funktioniert Claude Code mit dem Windows Terminal?
Ja. Das Windows Terminal kann Ubuntu-Tabs öffnen, was den Zugriff auf Claude Code ermöglicht, ohne zu einem separaten Ubuntu-Fenster wechseln zu müssen. Klicken Sie im Windows Terminal auf den Dropdown-Pfeil und wählen Sie Ubuntu aus der Profiliste.
Funktionieren meine vorhandenen Windows-Entwicklungstools mit Claude Code?
Das hängt vom Tool ab. Visual Studio Code lässt sich gut über die Remote-WSL-Erweiterung integrieren. JetBrains IDEs und andere Tools erfordern möglicherweise zusätzliche Konfiguration. Die offizielle Dokumentation nennt VS Code und JetBrains als unterstützte Plattformen.
Wie aktualisiere ich Claude Code unter Windows?
Claude Code wird standardmäßig automatisch aktualisiert. Um manuell zu aktualisieren, führen Sie `claude update` im Ubuntu-Terminal aus. Die automatische Update-Funktion kann bei Bedarf für Enterprise-Umgebungen über Konfigurationsdateien deaktiviert werden.
Was ist der Unterschied zwischen Claude Code und der Claude API?
Claude Code ist ein terminalbasierter Codierungsassistent, der Befehle ausführt und Dateien bearbeitet. Die Claude API bietet programmatischen Zugriff auf das Sprachmodell von Claude zum Erstellen benutzerdefinierter Anwendungen. Sie dienen unterschiedlichen Zwecken und erfordern unterschiedliche Einrichtungsprozesse.
Kann ich Claude Code mit .NET-Projekten unter Windows verwenden?
Ja, aber mit Vorbehalten. Community-Diskussionen deuten darauf hin, dass die .NET SDK-Unterstützung in WSL2 funktioniert, aber die Installation der Linux-Version des .NET SDK innerhalb von Ubuntu erfordert. Unter Windows installiertes .NET ist von WSL2 aus nicht zugänglich.
Wie viel kostet Claude Code?
Die Preise hängen von der Nutzung und dem Kontotyp ab. Informieren Sie sich auf der offiziellen Anthropic-Website über die aktuellen Preismodelle und Teampläne, da die Kosten je nach API-Verbrauch und organisatorischen Anforderungen variieren.
Nächste Schritte nach der Installation
Nachdem Claude Code installiert ist, beginnen Sie mit der Erkundung seiner Möglichkeiten. Die Quickstart-Dokumentation empfiehlt, mit einfachen Aufgaben wie Codeerklärungen zu beginnen, bevor Sie zu komplexeren Operationen übergehen.
Versuchen Sie diese Befehle, um sich vertraut zu machen:
- claude “explain this function” – Codeerklärungen erhalten
- claude commit – Git-Commit-Nachrichten generieren
- claude -c – Die letzte Konversation fortsetzen
Die offizielle Dokumentation bietet detaillierte Anleitungen zur IDE-Integration, zur Plugin-Installation und zu erweiterten Konfigurationsoptionen. Für Teams bieten serverseitig verwaltete Einstellungen und die Analyse von Daten zusätzliche Kontrolle über Claude Code-Bereitstellungen.
Die Einrichtung von WSL2 mag im Vergleich zu nativen Windows-Anwendungen zusätzliche Schritte erfordern, ist aber derzeit der einzige Weg, Claude Code unter Windows auszuführen. Die gute Nachricht? Nach der Konfiguration läuft es reibungslos und lässt sich in die meisten Entwicklungsworkflows integrieren.
