Startseite

Claude Code unter Windows mit WSL installieren

Claude Code ist ein leistungsstarker KI-Programmierassistent, aber Windows-Benutzer stehen vor einer Herausforderung: Viele Entwicklertools funktionieren unter Linux besser. Die Lösung? WSL (Windows Subsystem for Linux) ermöglicht es Ihnen, eine vollständige Linux-Umgebung innerhalb von Windows auszuführen – wie zwei Computer in einem. Diese Anleitung führt Sie durch die komplette Einrichtung, sodass Sie in etwa 20 Minuten mit Claude programmieren können.

Wichtige Konzepte

• WSL (Windows Subsystem for Linux) - Eine Windows-Funktion, die ein echtes Linux-System neben Windows ausführt
• Ubuntu - Eine beliebte, einsteigerfreundliche Linux-Distribution, die wir über WSL installieren
• PowerShell - Das integrierte Befehlszeilentool von Windows, das hier zur Installation von WSL verwendet wird
• Node.js - Eine JavaScript-Laufzeitumgebung, die Claude Code zum Ausführen benötigt
• Terminal - Eine textbasierte Schnittstelle zum Ausführen von Befehlen (wie Ubuntus Befehlszeile)

Was Sie benötigen

• Einen Windows 10 (Version 2004 oder höher) oder Windows 11 Computer
• Administratorzugang auf Ihrem Computer
• Claude Pro/Max-Abonnement oder API-Schlüssel über Azure Foundry
• 15 - 20 Minuten

Schritt 1: Prüfen, ob Virtualisierung aktiviert ist

Bevor Sie WSL installieren, müssen Sie überprüfen, ob die Virtualisierung auf Ihrem Computer aktiviert ist. Dies ist erforderlich, damit WSL funktioniert.

• Klicken Sie mit der rechten Maustaste auf die Taskleiste (die Leiste am unteren Bildschirmrand)
• Klicken Sie im Menü auf Task-Manager
• Wenn sich der Task-Manager in einem kleinen Fenster öffnet, klicken Sie unten auf Mehr Details
• Klicken Sie oben auf die Registerkarte Leistung
• Klicken Sie in der linken Seitenleiste auf CPU
• Schauen Sie auf den unteren rechten Bereich des Fensters
• Suchen Sie die Zeile Virtualisierung: und prüfen Sie, ob dort Aktiviert steht

Wenn dort „Aktiviert” steht: Ausgezeichnet! Fahren Sie mit Schritt 2 fort.

Wenn dort „Deaktiviert” steht: Sie müssen die Virtualisierung in den BIOS-Einstellungen Ihres Computers aktivieren:

• Starten Sie Ihren Computer neu
• Drücken Sie während des Starts die BIOS-Taste (normalerweise F2, F10, Entf oder Esc - es hängt von Ihrem Computerhersteller ab)
• Suchen Sie nach Einstellungen zu „Virtualization Technology”, „Intel VT-x”, „AMD-V” oder „SVM Mode”
• Aktivieren Sie diese Einstellungen
• Speichern und verlassen Sie das BIOS (normalerweise F10)
• Ihr Computer startet normal neu

Schritt 2: PowerShell als Administrator öffnen

• Klicken Sie auf die Windows-Starttaste (Windows-Symbol in der unteren linken Ecke)
• Geben Sie PowerShell in das Suchfeld ein
• In den Suchergebnissen sehen Sie Windows PowerShell
• Klicken Sie mit der rechten Maustaste auf Windows PowerShell
• Klicken Sie im Menü auf Als Administrator ausführen
• Ein Fenster erscheint mit der Frage „Möchten Sie zulassen, dass diese App Änderungen an Ihrem Gerät vornimmt?”
• Klicken Sie auf Ja

Ein blaues Fenster mit weißem Text öffnet sich - das ist PowerShell mit Administratorrechten.

Schritt 3: WSL installieren

Prüfen Sie zunächst, ob WSL und Ubuntu bereits installiert sind:

• Geben Sie im PowerShell-Fenster ein:

   wsl --list --verbose
  

• Schauen Sie sich das Ergebnis an:
  • Wenn Sie „Ubuntu” aufgelistet sehen mit einem STATUS „Running” oder „Stopped”: WSL und Ubuntu sind bereits installiert! Fahren Sie mit Schritt 4 fort.
  • Wenn Sie eine Fehlermeldung sehen oder „Windows-Subsystem für Linux hat keine installierten Distributionen”: Fahren Sie mit der Installation unten fort.

Um WSL und Ubuntu zu installieren:

• Geben Sie im PowerShell-Fenster ein:

   wsl --install
  

• Möglicherweise sehen Sie Meldungen wie „Installiere: Windows-Subsystem für Linux” und „Installiere: Ubuntu”
• Wenn Sie eine Meldung sehen, dass die Installation abgeschlossen ist, müssen Sie Ihren Computer neu starten:
  • Klicken Sie auf die Windows-Starttaste
  • Klicken Sie auf das Ein/Aus-Symbol
  • Klicken Sie auf Neu starten
• Ihr Computer wird neu gestartet - das dauert etwa 1-2 Minuten

Warum ein Neustart erforderlich ist: Der Neustart ermöglicht Windows, die gerade installierten WSL- und Virtual Machine Platform-Funktionen zu aktivieren.

Hinweis: Wenn Sie einen Fehler erhalten, dass der Befehl nicht erkannt wird, ist Ihre Windows-Version möglicherweise zu alt. Stellen Sie sicher, dass Sie Windows 10 Version 2004 oder höher oder Windows 11 haben. Führen Sie Windows Update aus, um die neueste Version zu erhalten.

Schritt 4: Ubuntu einrichten (nur beim ersten Mal)

Nach dem Neustart Ihres Computers sollte innerhalb von 2-5 Minuten automatisch ein Terminalfenster mit „Ubuntu” im Titel erscheinen.

Wenn sich das Ubuntu-Fenster NICHT automatisch geöffnet hat:

• Klicken Sie auf die Windows-Starttaste
• Geben Sie Ubuntu in das Suchfeld ein
• Klicken Sie auf Ubuntu (Sie sehen ein kreisförmiges orangefarbenes Symbol)
• Das Ubuntu-Terminal öffnet sich und setzt die Einrichtung fort

Schließen Sie nun die erstmalige Einrichtung ab:

• Warten Sie auf die Meldung: Enter new UNIX username:
• Geben Sie einen Benutzernamen ein (verwenden Sie nur Kleinbuchstaben und Zahlen, keine Leerzeichen)
  • Beispiel: john
• Sie sehen: New password:
• Geben Sie ein einfaches Passwort ein (sogar dasselbe wie der Benutzername john)
• Sie sehen die Zeichen beim Tippen nicht - das ist normal
• Geben Sie dasselbe Passwort erneut ein, wenn Sie dazu aufgefordert werden

Wichtig: Merken Sie sich diesen Benutzernamen und das Passwort - Sie werden sie später brauchen.

Schritt 5: Ubuntu aktualisieren

• Geben Sie im Ubuntu-Terminalfenster ein:

   sudo apt update
  

• Geben Sie Ihr Passwort ein (das, das Sie gerade erstellt haben), wenn Sie dazu aufgefordert werden
• Geben Sie dann ein:

   sudo apt upgrade -y
  

• Warten Sie, bis alle Pakete aktualisiert sind (das kann 5 Minuten dauern)

Schritt 6: Node.js installieren

Claude Code erfordert Node.js Version 18 oder höher. Folgen Sie diesen Schritten:

• Kopieren und fügen Sie im Ubuntu-Terminal diese Befehle ein:

  Laden Sie zuerst den nvm-Installer herunter:

   wget https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh --no-check-certificate
   cat install.sh | bash
   \. "$HOME/.nvm/nvm.sh"
   nvm install 24
  

  Dies lädt zuerst den nvm-Installer herunter, installiert ihn und verwendet ihn dann, um Node.js v24.0 zu installieren

• Warten Sie, bis Node.js installiert ist (2-5 Minuten)
• Überprüfen Sie die Installation durch Eingabe von:

   node --version
  

• Sie sollten etwas wie v24.x.x sehen (die genauen Zahlen können variieren)

Schritt 7: Claude Code installieren

• Geben Sie im Ubuntu-Terminal ein:

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

• Warten Sie, bis Claude Code installiert ist (2-5 Minuten)
• Sie sehen möglicherweise einige Warnungen in gelbem oder rotem Text - das ist normalerweise normal
• Wenn die Installation abgeschlossen ist, überprüfen Sie durch Eingabe von:

   claude --version
  

• Sie sollten die Versionsnummer von Claude Code sehen

Schritt 8: Ihre Anthropic-API-Verbindung konfigurieren

Option A. Ihr Claude Pro- oder Max-Abonnement verwenden

• Geben Sie im Ubuntu-Terminal ein:

   claude
  

• Claude versucht, einen Browser zu öffnen. Wenn er sich nicht automatisch öffnet, halten Sie Strg gedrückt und klicken Sie auf die lange URL, um sie in einem Browser zu öffnen. Alternativ kopieren Sie die URL und fügen Sie sie in einen externen Browser ein.
• Melden Sie sich bei Ihrem Claude.ai-Konto an (dies kann automatisch geschehen, wenn Sie Chrome verwenden)
• Klicken Sie auf Autorisieren
• Klicken Sie auf Code kopieren, wenn ein langer Code erscheint
• Gehen Sie zurück zum Terminal-Fenster
• Zum Einfügen im Terminal: Rechtsklick und Einfügen wählen (oder Strg+Umschalt+V drücken)
• Sie sollten eine Erfolgsmeldung sehen
• Folgen Sie den Anweisungen, um die Einrichtung abzuschließen

Option B. Anthropic-API-Schlüssel verwenden

Wenn Sie einen Anthropic-API-Schlüssel anstelle eines Claude-Abonnements haben:

• Holen Sie sich zunächst Ihren API-Schlüssel von der Anthropic Console
• Geben Sie im Ubuntu-Terminal ein:

   export ANTHROPIC_API_KEY="your-api-key-here"
  

  Ersetzen Sie your-api-key-here durch Ihren tatsächlichen API-Schlüssel

• Um dies dauerhaft zu machen (damit Sie es nicht jedes Mal einstellen müssen), fügen Sie es zu Ihrem Shell-Profil hinzu:

   echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bashrc
  

  Ersetzen Sie your-api-key-here durch Ihren tatsächlichen API-Schlüssel

• Schließen Sie das Ubuntu-Terminal und öffnen Sie es erneut, damit die Änderungen wirksam werden
• Sie sollten nun Claude Code mit Ihrem API-Schlüssel verwenden können

Option C. Anthropic API über Azure Foundry verwenden

Fügen Sie vor dem Starten von Claude Code im Ubuntu-Terminalfenster diesen Code ein, um Umgebungsvariablen zu definieren:

# Enable Microsoft Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1
# Azure resource name
export ANTHROPIC_FOUNDRY_RESOURCE=xxxx-eastus2
# Set models to your resource's deployment names
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5
export ANTHROPIC_FOUNDRY_API_KEY=your_api_key

Hinweis: Ersetzen Sie xxxx-eastus2 durch Ihren Foundry-Ressourcennamen (verwenden Sie nicht die gesamte Basis-URL). Ersetzen Sie your_api_key durch Ihren vollständigen API-Schlüssel aus Ihrem Azure-Portal.

Starten Sie dann Claude Code:

claude

Sie sollten nun Claude Code mit Azure-bereitgestellten Claude-Modellen verwenden können.

Schritt 9: Claude Code testen

Sie sind fertig! Um zu testen, ob es funktioniert, stellen Sie eine allgemeine Frage wie „Erkläre Quantencomputing.”

Schritt 10: Auf Ihre Windows-Projekte zugreifen

• Wenn Sie einen Windows-Ordner namens test_claude haben, der die Dateien eines Projekts enthält, können Sie darauf zugreifen:

   cd /mnt/c/Users/Username/Documents/test_claude
  

  Ersetzen Sie Username durch Ihren tatsächlichen Windows-Benutzernamen.

• Starten Sie dann Claude:

   claude
  

• Beginnen Sie damit, Claude zu bitten, Ihnen die Codebasis zu erklären.
• Sie können Claude bitten, Änderungen vorzunehmen.
• Testen Sie Ihren Code in Ihrer bevorzugten IDE.

Hinweis: Claude arbeitet innerhalb eines Projektordners. Es speichert Einstellungen in diesem Ordner. Es ist Claudes Arbeitsbereich.

Nächste Schritte

• VS Code einrichten: Folgen Sie der Anleitung VS Code Erste Schritte, dann verbinden Sie es mit Claude Code mit Claude Code in VS Code (Windows)
• Git-Grundlagen lernen: Fügen Sie Versionskontrolle zu Ihren Projekten hinzu mit Claude Code Git unter Windows
• Ein Projekt ausprobieren: Arbeiten Sie durch Eine Forschungsarbeit mit Claude Code schreiben, um Claude Code in Aktion zu sehen

Fehlerbehebung

Ubuntu-Terminal nach dem Schließen wieder öffnen

• Klicken Sie auf die Windows-Starttaste, geben Sie Ubuntu ein und klicken Sie auf die Ubuntu-App (orangefarbenes Kreissymbol)

„Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS”

Dieser Fehler bedeutet, dass die Virtualisierung nicht aktiviert ist:

• Gehen Sie zurück zu Schritt 1 und prüfen Sie im Task-Manager, ob die Virtualisierung aktiviert ist
• Wenn deaktiviert, müssen Sie sie im BIOS Ihres Computers aktivieren (siehe Schritt 1 für Anweisungen)
• Nach dem Aktivieren der Virtualisierung starten Sie Ihren Computer neu und versuchen Sie wsl --install erneut

„wsl –install” funktioniert nicht

• Stellen Sie sicher, dass Sie PowerShell als Administrator ausführen
• Stellen Sie sicher, dass Sie Windows 10 Version 2004+ oder Windows 11 haben
• Versuchen Sie zuerst: wsl --update, dann versuchen Sie wsl --install erneut

Ubuntu-Fenster öffnet sich nach dem Neustart nicht

• Klicken Sie auf Windows-Start
• Geben Sie Ubuntu ein
• Klicken Sie auf die Ubuntu-App, um sie manuell zu starten

„sudo: apt: command not found”

• Ihr WSL wurde möglicherweise nicht korrekt installiert
• In PowerShell (als Administrator), geben Sie ein: wsl --unregister Ubuntu
• Führen Sie dann wsl --install erneut aus

Node.js-Installation schlägt fehl

• Stellen Sie sicher, dass Sie zuerst sudo apt update ausgeführt haben
• Versuchen Sie den Installationsbefehl erneut

Claude Code-Befehle werden nicht gefunden

• Stellen Sie sicher, dass die Installation erfolgreich abgeschlossen wurde
• Versuchen Sie, das Ubuntu-Terminal zu schließen und erneut zu öffnen
• Versuchen Sie, den Installationsbefehl erneut auszuführen: curl -fsSL https://claude.ai/install.sh | bash

Benötigen Sie Hilfe?

• Für WSL-Probleme: Microsoft WSL-Dokumentation
• Für Claude Code-Probleme: Claude Code GitHub

Erstellt von Steven Ge am 11. Dezember 2025.