Startseite

Claude Code unter Windows installieren

Claude Code ist ein KI-Assistent, der in Ihrem Terminal lebt und Ihnen beim Schreiben, Debuggen und Verstehen von Code hilft. Mit dieser Anleitung läuft Claude Code in wenigen Minuten nativ unter Windows. WSL2 wird am Ende als optionale, fortgeschrittenere Einrichtung vorgestellt.

Wichtige Konzepte

Was Sie benötigen

Schritt 1: Git for Windows installieren (optional, empfohlen)

Git for Windows ist empfohlen, aber optional. Es fügt Git Bash hinzu, die Shell, die Claude Code zum Ausführen von Befehlen verwendet. Wenn Sie ihn überspringen, greift Claude Code stattdessen auf PowerShell zurück – Sie können also direkt zu Schritt 2 wechseln und Git bei Bedarf später installieren.

Das war’s – Claude Code erkennt Git Bash beim Start automatisch.

Schritt 2: Claude Code installieren

Schritt 3: Mit Ihrem Anthropic-Konto verbinden

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

Die folgenden API-basierten Optionen laufen ebenfalls in PowerShell und nutzen den Befehl setx, der eine Einstellung dauerhaft speichert. Schließen Sie PowerShell nach einem setx und öffnen Sie es erneut, damit die Änderung wirksam wird, und starten Sie dann claude.

Option B. Anthropic-API-Schlüssel verwenden

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

Option C. OpenRouter API verwenden (kostenlos starten!)

OpenRouter ist ein einheitliches API-Gateway, das über einen einzigen API-Schlüssel Zugang zu über 500 großen Sprachmodellen bietet. Das kann eine günstige Möglichkeit sein, Claude Code zu nutzen: Sie zahlen nur für die Nutzung und wählen aus Modellen verschiedener Preisklassen.

Hinweise:

Option D. Anthropic API über Azure Foundry verwenden

Fügen Sie in PowerShell diesen Code ein, um die Umgebungsvariablen zu definieren:

# Enable Microsoft Foundry integration
setx CLAUDE_CODE_USE_FOUNDRY 1
# Azure resource name
setx ANTHROPIC_FOUNDRY_RESOURCE "xxxx-eastus2"
# Set models to your resource's deployment names
setx ANTHROPIC_DEFAULT_OPUS_MODEL "claude-opus-4-5"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "claude-sonnet-4-5"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "claude-haiku-4-5"
setx 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.

Schließen Sie dann PowerShell, öffnen Sie es erneut und starten Sie Claude Code:

claude

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

Schritt 4: Claude Code testen

Sie sind fertig! Geben Sie claude in PowerShell ein und stellen Sie eine allgemeine Frage wie „Erkläre Quantencomputing”.

Schritt 5: Auf Ihre Projekte zugreifen

Hinweis: Claude arbeitet innerhalb eines Projektordners und speichert dort seine Einstellungen. Das ist sein Arbeitsbereich.

Schritt 6: (Optional) WSL2 für die vollständige Linux-Erfahrung installieren

Für die meisten Nutzer reicht die native Einrichtung oben völlig aus. Claude Code läuft unter Linux jedoch besser. WSL2 führt ein echtes Linux-System innerhalb von Windows aus und bietet Bash Tool Sandboxing (eine Sicherheitsfunktion) sowie eine bessere Kompatibilität mit Linux-Toolchains. Die Einrichtung dauert länger und erfordert einen Neustart – tun Sie dies also nur, wenn Sie die vollständige Linux-Erfahrung möchten.

a) Virtualisierung prüfen und WSL installieren

Prüfen Sie zunächst, ob die Virtualisierung aktiviert ist:

Wenn dort „Deaktiviert” steht: Sie müssen die Virtualisierung im BIOS Ihres Computers aktivieren:

Jetzt WSL installieren:

Hinweis: wsl --install erfordert Windows 10 Version 2004 oder höher oder Windows 11. Wenn der Befehl nicht erkannt wird, ist Ihre Windows-Version möglicherweise zu alt.

b) Ubuntu einrichten

Nach dem Neustart sollte innerhalb von 2-5 Minuten automatisch ein Terminalfenster mit „Ubuntu” im Titel erscheinen. Falls nicht, klicken Sie auf die Windows-Starttaste, geben Sie Ubuntu ein und klicken Sie auf die Ubuntu-App (orangefarbenes Kreissymbol).

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

c) Claude Code in WSL installieren

Nächste Schritte

Fehlerbehebung

Erster Schritt: Claude Doctor ausführen

Wenn etwas nicht funktioniert, versuchen Sie zuerst diesen Befehl:

claude doctor

Dieses integrierte Diagnosetool überprüft Ihre Installation und meldet häufige Probleme.

Claude-Befehl nicht gefunden (natives Windows)

„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:

„wsl –install” funktioniert nicht

Ubuntu-Fenster öffnet sich nach dem Neustart nicht

Benötigen Sie Hilfe?

Erstellt von Steven Ge am 11. Dezember 2025. Aktualisiert Juni 2026.