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

PowerShell - Das integrierte Befehlszeilentool von Windows, das hier zum Installieren und Ausführen von Claude Code verwendet wird
Git for Windows - Ein kostenloser Download, der Git Bash hinzufügt, die Shell, die Claude Code zum Ausführen von Befehlen verwendet
WSL (Windows Subsystem for Linux) - Eine optionale Windows-Funktion, die ein echtes Linux-System neben Windows ausführt; wird in der fortgeschrittenen Einrichtung am Ende verwendet

Was Sie benötigen

Einen Windows 10- oder Windows 11-Computer
Ein Claude Pro/Max-Abonnement oder einen API-Schlüssel
5 - 10 Minuten

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 diesen Schritt ü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.

Gehen Sie zu git-scm.com/download/win
Klicken Sie oben auf der Seite auf Click here to download und öffnen Sie das Installationsprogramm, wenn der Download fertig ist
Klicken Sie sich mit Next durch das Installationsprogramm und übernehmen Sie die Standardoptionen
Klicken Sie auf Install und dann auf Finish

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

Schritt 2: Claude Code installieren

Klicken Sie auf die Schaltfläche Start (das Windows-Logo in der Taskleiste)
Geben Sie PowerShell ein und klicken Sie auf Windows PowerShell

Geben Sie im PowerShell-Fenster ein:

 irm https://claude.ai/install.ps1 | iex

Warten Sie, bis die Installation abgeschlossen ist (das Fenster zeigt während des Downloads möglicherweise eine Minute lang nichts an – das ist normal)
Schließen Sie PowerShell und öffnen Sie es erneut, dann überprüfen Sie durch Eingabe von:
```
 claude --version
```
Sie sollten die Versionsnummer von Claude Code sehen
Wenn stattdessen „Die Benennung “claude” wurde nicht als Name eines Cmdlet … erkannt“ (englisch: 'claude' is not recognized) erscheint (Claude wurde nicht gefunden), führen Sie diese zwei Zeilen in PowerShell aus, schließen Sie PowerShell, öffnen Sie es erneut und versuchen Sie claude --version noch einmal:
```
 $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
 [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
```

Schritt 3: (Optional) Claude Code in VS Code öffnen

Überspringen Sie diesen Schritt, wenn Sie VS Code noch nicht haben – Sie können es später mit VS Code Erste Schritte installieren und dann hierher zurückkehren.

Jetzt, da Claude Code installiert ist, können Sie es auch in VS Code verwenden statt nur im Terminal. Das ist oft die einfachste Arbeitsweise, denn Sie können Dateien lesen, Code bearbeiten und um Hilfe bitten, ohne Ihren Editor zu verlassen.

Stellen Sie sich die Claude Code-Seitenleiste wie ein Chatfenster innerhalb von VS Code vor. Dort können Sie Fragen stellen, sich Code erklären lassen und Hilfe bekommen, während Sie im selben Fenster arbeiten.

So öffnen Sie die Claude Code-Seitenleiste

Öffnen Sie VS Code
Schauen Sie ganz an den linken Rand des Fensters
Klicken Sie auf das Extensions-Symbol, falls Sie das Claude Code-Fenster noch nicht sehen
Suchen Sie im Extensions-Marketplace nach Claude Code
Klicken Sie auf Install, falls die Erweiterung noch nicht installiert ist
Klicken Sie nach der Installation unten rechts im Fenster auf ✻ Claude Code, um den Chat zu öffnen. (Das Funken-Symbol, englisch „Spark“, in der linken Seitenleiste öffnet dagegen eine Liste Ihrer Sitzungen, in der Sie eine neue Sitzung starten können.)

Wenn Sie das Claude Code-Symbol nicht sehen, versuchen Sie Folgendes:

Drücken Sie Strg + Umschalt + P
Geben Sie ein: Claude Code: Open in Side Bar
Klicken Sie in der Liste auf den passenden Eintrag

Wenn die Seitenleiste immer noch nicht erscheint, schließen Sie VS Code und öffnen Sie es erneut. Manchmal braucht die Erweiterung einen Neustart, bevor die Seitenleiste angezeigt wird.

Wofür die Seitenleiste da ist

In der Claude Code-Seitenleiste können Sie:

Fragen zu Ihrem Projekt stellen
Hilfe beim Beheben von Fehlern bekommen
sich Code erklären lassen, den Sie nicht verstehen
Dateien erstellen oder aktualisieren
visueller arbeiten, ohne VS Code zu verlassen

Das ist praktisch, weil Sie Ihren Code im Editor geöffnet lassen und Claude im selben Fenster um Hilfe bitten können.

Kurzer Test

Wenn die Seitenleiste geöffnet ist:

Geben Sie ein: Erkläre mir dieses Projekt
Drücken Sie die Eingabetaste

Wenn Claude antwortet, können Sie loslegen. Beim ersten Mal fordert die Seitenleiste Sie eventuell stattdessen auf, sich anzumelden: Folgen Sie den Anweisungen, oder verbinden Sie Ihr Konto in Schritt 4 weiter unten und versuchen Sie es dann erneut.

Tipp: Wenn die Seitenleiste immer noch fehlt, prüfen Sie, ob die Claude Code-Erweiterung installiert ist und VS Code neu gestartet wurde.

Schritt 4: Mit Ihrem Anthropic-Konto verbinden

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

Geben Sie im PowerShell-Fenster ein:
```
 claude
```
Claude versucht, einen Browser zu öffnen. Wenn er sich nicht automatisch öffnet, drücken Sie die Taste c, um den Anmeldelink zu kopieren, und fügen Sie ihn dann in Ihren Browser ein.
Melden Sie sich bei Ihrem Claude.ai-Konto an (dies kann automatisch geschehen, wenn Sie Chrome verwenden)
Klicken Sie auf Authorize. Der Browser sollte anzeigen, dass Sie angemeldet sind, und PowerShell zeigt eine Erfolgsmeldung.
Nur wenn der Browser stattdessen einen langen Code anzeigt (das passiert in WSL/Ubuntu): Klicken Sie auf Copy Code, gehen Sie zurück zum Terminal, fügen Sie den Code bei Paste code here if prompted ein (Rechtsklick oder Strg+V) und drücken Sie die Eingabetaste.
Folgen Sie den Anweisungen, um die Einrichtung abzuschließen

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:

Holen Sie sich Ihren API-Schlüssel von der Anthropic Console
Geben Sie in PowerShell ein:
```
 setx ANTHROPIC_API_KEY "your-api-key-here"
```
Ersetzen Sie your-api-key-here durch Ihren tatsächlichen API-Schlüssel
Schließen Sie PowerShell und öffnen Sie es erneut, damit die Änderung wirksam wird
Starten Sie Claude Code:
```
 claude
```
Beim ersten Mal fragt Claude Code, ob Sie den gefundenen API-Schlüssel verwenden möchten. Wählen Sie Yes. (Wenn Sie versehentlich No wählen, geben Sie /config ein und aktivieren Sie Use custom API key.)

Option C. OpenRouter API verwenden (Bezahlung nach Nutzung)

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.

Registrieren Sie sich auf openrouter.ai und melden Sie sich an
Klicken Sie auf Get API key und kopieren Sie den Schlüssel an einen sicheren Ort

Setzen Sie in PowerShell die erforderlichen Umgebungsvariablen:

 setx ANTHROPIC_BASE_URL "https://openrouter.ai/api"
 setx ANTHROPIC_AUTH_TOKEN "your-openrouter-api-key"
 [Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', $null, 'User')
 setx ANTHROPIC_DEFAULT_SONNET_MODEL "~anthropic/claude-sonnet-latest"
 setx ANTHROPIC_DEFAULT_OPUS_MODEL "~anthropic/claude-opus-latest"
 setx ANTHROPIC_DEFAULT_HAIKU_MODEL "~anthropic/claude-haiku-latest"

Schließen Sie PowerShell und öffnen Sie es erneut, dann starten Sie Claude Code:
```
 claude
```
Überprüfen Sie die Verbindung durch Eingabe von /status in Claude Code

Hinweise:

Ersetzen Sie your-openrouter-api-key durch Ihren tatsächlichen OpenRouter API-Schlüssel
Die Zeile mit ANTHROPIC_API_KEY entfernt einen eventuell gespeicherten Anthropic-API-Schlüssel, der bei Verwendung von OpenRouter nicht gesetzt sein darf
Um andere Modelle zu verwenden, müssen diese Tool-Nutzungsfähigkeiten unterstützen. Sie können Modelle überschreiben mit:
```
 setx ANTHROPIC_DEFAULT_SONNET_MODEL "model-provider/model-name"
```
Durchsuchen Sie verfügbare Modelle unter openrouter.ai/models
Kostenlose Modelle (:free) sind auf 50 Anfragen pro Tag begrenzt – eine einzige Aufgabe in Claude Code kann diese schnell aufbrauchen
Die oben gezeigten Modelle sind kostenpflichtig – prüfen Sie ihre Preise unter openrouter.ai/models, bevor Sie sie verwenden
Über OpenRouter funktioniert Claude Code nur mit Anthropic-Modellen garantiert
Weitere Details finden Sie im offiziellen OpenRouter-Leitfaden

Option D. Anthropic API über Microsoft Foundry (Azure) 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-8"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "claude-sonnet-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 5: Claude Code testen

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

Schritt 6: Auf Ihre Projekte zugreifen

Wenn Sie einen Projektordner haben, wechseln Sie in PowerShell dorthin:
```
 cd ~/Documents/test_claude
```
Ersetzen Sie test_claude durch den tatsächlichen Namen Ihres Projektordners. Tipp: Geben Sie cd (mit Leerzeichen) ein, ziehen Sie den Ordner aus dem Datei-Explorer in das PowerShell-Fenster, um seinen vollständigen Pfad einzufügen, und drücken Sie die Eingabetaste.
Starten Sie dann Claude:
```
 claude
```
Bitten Sie Claude zu Beginn, 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 und speichert dort seine Einstellungen. Das ist sein Arbeitsbereich.

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

Für die meisten Nutzer reicht die native Einrichtung oben völlig aus. Einige Funktionen gibt es jedoch nur unter Linux. 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:

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 auf Leistung (unter Windows 10 eine Registerkarte oben, unter Windows 11 ein Symbol im Menü links)
Klicken Sie in der linken Seitenleiste auf CPU
Suchen Sie die Zeile Virtualisierung: und prüfen Sie, ob dort Aktiviert steht

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

Starten Sie Ihren Computer neu
Drücken Sie während des Starts die BIOS-Taste (normalerweise F2, F10, Entf oder Esc, je nach Computerhersteller)
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)

Jetzt WSL installieren:

Klicken Sie auf die Schaltfläche Start (das Windows-Logo in der Taskleiste) und geben Sie PowerShell ein
Klicken Sie mit der rechten Maustaste auf Windows PowerShell und klicken Sie auf Als Administrator ausführen
Klicken Sie auf Ja, wenn gefragt wird „Möchten Sie zulassen, dass durch diese App Änderungen an Ihrem Gerät vorgenommen werden?“
Geben Sie im PowerShell-Fenster ein:
```
 wsl --install
```
Möglicherweise sehen Sie Meldungen wie „Installing: Windows Subsystem for Linux“ und „Installing: Ubuntu“
Wenn die Installation abgeschlossen ist, starten Sie Ihren Computer neu

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 Schaltfläche Start (das Windows-Logo in der Taskleiste), geben Sie Ubuntu ein und klicken Sie auf die Ubuntu-App (orangefarbenes Kreissymbol).

Warten Sie auf die Meldung: Enter new UNIX username:
Geben Sie einen Benutzernamen ein (nur Kleinbuchstaben und Zahlen, keine Leerzeichen) – zum Beispiel john
Sie sehen: New password:
Geben Sie ein einfaches Passwort ein (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.

c) Claude Code in WSL installieren

Geben Sie im Ubuntu-Terminal ein:

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

Schließen Sie das Ubuntu-Fenster, öffnen Sie Ubuntu erneut über das Startmenü und überprüfen Sie dann durch Eingabe von:
```
 claude --version
```
Wenn weiterhin command not found erscheint (Befehl nicht gefunden), führen Sie diese Zeile aus und versuchen Sie dann claude --version noch einmal:
```
 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
```
Verbinden Sie Ihr Konto, indem Sie claude im Ubuntu-Terminal eingeben und der Browser-Anmeldung folgen (wie in Schritt 4, Option A). Wenn Sie stattdessen einen API-Schlüssel verwenden, speichern Sie ihn mit echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bashrc && source ~/.bashrc (WSL verwendet Linux-Befehle, kein setx)
Um einen Windows-Projektordner aus WSL zu öffnen:
```
 cd /mnt/c/Users/Username/Documents/test_claude
```
Ersetzen Sie Username durch Ihren tatsächlichen Windows-Benutzernamen.

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

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)

Schließen Sie PowerShell und öffnen Sie es erneut
Versuchen Sie, den Installationsbefehl erneut auszuführen:
```
 irm https://claude.ai/install.ps1 | iex
```
Wenn „Die Benennung “claude” wurde nicht als Name eines Cmdlet … erkannt“ (englisch: 'claude' is not recognized) erscheint (Claude wurde nicht gefunden), führen Sie diese zwei Zeilen in PowerShell aus und schließen und öffnen Sie PowerShell dann erneut:
```
 $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
 [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
```

Fehlermeldung zur „VM-Plattform“ (Virtual Machine Platform) und zur Virtualisierung im BIOS

Je nach Sprache Ihres Windows erscheint diese Meldung auf Englisch („Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS“) oder sinngemäß auf Deutsch: Sie sollen die Windows-Funktion „VM-Plattform“ aktivieren und sicherstellen, dass die Virtualisierung im BIOS aktiviert ist. Dieser Fehler bedeutet, dass die Virtualisierung nicht aktiviert ist:

Prüfen Sie im Task-Manager, ob die Virtualisierung aktiviert ist (siehe den optionalen WSL-Abschnitt oben)
Wenn sie deaktiviert ist, aktivieren Sie sie im BIOS Ihres Computers
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
Führen Sie zuerst wsl --update aus, dann wsl --install erneut

Ubuntu-Fenster öffnet sich nach dem Neustart nicht

Klicken Sie auf die Schaltfläche Start (das Windows-Logo in der Taskleiste), geben Sie Ubuntu ein und klicken Sie auf die Ubuntu-App, um sie manuell zu starten

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. Aktualisiert Juni 2026.