Claude Code unter Windows installieren und nutzen – Die vollständige Anleitung

Wer als Entwickler auf Windows arbeitet und den leistungsstarken AI-Coding-Assistenten von Anthropic nutzen möchte, steht manchmal vor einer kleinen Hürde: Claude Code ist primär für Unix-basierte Systeme entwickelt worden. Mit der richtigen Vorbereitung läuft er aber auch unter Windows hervorragend – und in dieser Anleitung zeige ich dir Schritt für Schritt, wie du das schaffst.

Diese Anleitung begleitet dich von der ersten Voraussetzung bis zur produktiven Session. Du lernst, wie du die Umgebung einrichtest, typische Windows-Fallstricke vermeidest und das volle Potenzial des Claude Code CLI ausschöpfst.

Was ist Claude Code und warum lohnt sich der Einsatz unter Windows?

Claude Code ist ein KI-gestützter Coding-Assistent von Anthropic, der direkt im Terminal läuft. Anders als viele grafische Tools setzt Claude Code auf eine CLI-First-Philosophie: Du arbeitest in deinem gewohnten Terminal, gibst Anweisungen in natürlicher Sprache ein, und der Assistent liest, bearbeitet und erklärt deinen Code – direkt in der Kommandozeile.

Das klingt spartanisch, ist aber in der Praxis enorm mächtig. Claude Code versteht ganze Codebasen, schreibt Tests, refaktoriert Funktionen und erklärt komplexe Zusammenhänge – ohne dass du den Kontext aus dem Terminal wechseln musst. Für Windows-Entwickler, die bisher vor allem mit grafischen IDEs gearbeitet haben, ist das ein echter Paradigmenwechsel.

Voraussetzungen: Das brauchst du vor der Installation

Bevor du Claude Code auf Windows installierst, müssen einige Grundlagen stimmen. Geh diese Checkliste durch, bevor du mit der eigentlichen Installation beginnst.

Systemanforderungen im Überblick

Den Anthropic API-Key bekommst du unter console.anthropic.com nach einer kostenlosen Registrierung. Ohne diesen Schlüssel lässt sich Claude Code nicht nutzen.

Node.js und npm installieren

Claude Code wird über npm bereitgestellt und benötigt daher Node.js. Am einfachsten installierst du Node.js über den offiziellen Installer von nodejs.org. Lade die LTS-Version herunter und führe den Installer aus – npm wird dabei automatisch mitinstalliert.

Nach der Installation prüfst du im Terminal, ob alles geklappt hat:

node --version
npm --version

Beide Befehle sollten eine Versionsnummer ausgeben. Falls nicht, starte den Rechner einmal neu – Windows aktualisiert den PATH manchmal erst nach einem Neustart.

Windows Terminal installieren (empfohlen)

Für das beste Erlebnis mit Claude Code unter Windows empfehle ich den Windows Terminal. Er unterstützt Tabs, verschiedene Shell-Profile und Unicode-Zeichen korrekt – was bei der Ausgabe von Claude Code wichtig ist. Du findest ihn kostenlos im Microsoft Store oder installierst ihn über winget:

winget install Microsoft.WindowsTerminal

Claude Code auf Windows installieren – Schritt für Schritt

Jetzt geht es an die eigentliche claude code windows installation. Du hast zwei Wege zur Auswahl: die direkte Installation unter Windows oder die Nutzung via WSL (Windows Subsystem for Linux). Ich empfehle für die meisten Entwickler den WSL-Weg, zeige dir aber beide Varianten.

Variante 1: Direkte Installation unter Windows (PowerShell)

Öffne den Windows Terminal mit Administratorrechten und führe das npm install für Claude Code global aus:

npm install -g @anthropic-ai/claude-code

Nach erfolgreicher Installation setzt du deinen Anthropic API-Key als Umgebungsvariable. In PowerShell geht das so:

$env:ANTHROPIC_API_KEY = "dein-api-key-hier"

Damit der Key dauerhaft gespeichert bleibt und nicht bei jedem Start neu eingegeben werden muss, trägst du ihn in die Windows-Umgebungsvariablen ein:

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "dein-api-key-hier", "User")

Danach kannst du Claude Code direkt in PowerShell oder der Eingabeaufforderung starten:

claude

Variante 2: Installation via WSL (Windows Subsystem for Linux) – empfohlen

WSL bringt eine vollständige Linux-Umgebung in Windows und ist für Claude Code die sauberste Lösung. Viele der internen Tools und Shell-Skripte, die Claude Code verwendet, laufen unter Linux einfach reibungsloser.

Zuerst installierst du WSL2, falls noch nicht vorhanden. Öffne PowerShell als Administrator:

wsl --install

Der Befehl installiert WSL2 und Ubuntu als Standard-Distribution. Nach einem Neustart richtest du deinen Linux-Benutzernamen und dein Passwort ein. Anschließend öffnest du eine Ubuntu-Shell und installierst Node.js über den offiziellen NodeSource-Installer:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Jetzt installierst du Claude Code global in der WSL-Umgebung:

sudo npm install -g @anthropic-ai/claude-code

Den API-Key trägst du in deine Shell-Konfiguration ein, damit er bei jedem Start automatisch verfügbar ist:

echo 'export ANTHROPIC_API_KEY="dein-api-key-hier"' >> ~/.bashrc
source ~/.bashrc

Falls du zsh verwendest, ersetze ~/.bashrc entsprechend durch ~/.zshrc.

Erste Session starten und einrichten

Mit der abgeschlossenen Installation kannst du deine erste Session starten. Navigiere in deinem Terminal in ein Projektverzeichnis und ruf Claude Code auf:

cd /pfad/zu/deinem/projekt
claude

Beim ersten Start wirst du durch eine kurze Einrichtung geführt. Claude Code fragt nach deiner Zustimmung zu den Nutzungsbedingungen und initialisiert die Konfiguration. Anschließend öffnet sich die interaktive REPL-Oberfläche, in der du direkt mit dem KI-Assistenten kommunizieren kannst.

Den ersten Befehl eingeben

In der Claude Code Session kannst du sofort mit natürlicher Sprache arbeiten. Probiere zum Einstieg einfache Anfragen:

> Erkläre mir die Struktur dieses Projekts
> Schreibe einen Unit-Test für die Funktion calculateTotal
> Refaktoriere diese Datei und verbessere die Lesbarkeit

Claude Code liest dabei automatisch die relevanten Dateien aus deinem Projektverzeichnis und liefert kontextbezogene Antworten. Du musst keine Dateipfade manuell angeben – der Assistent findet selbst heraus, welche Dateien relevant sind.

Auto-accept aktivieren

Standardmäßig fragt Claude Code bei jeder Dateiänderung nach deiner Bestätigung. Mit dem auto-accept Flag kannst du dieses Verhalten für eine Session deaktivieren, wenn du dem Assistenten vertraust:

claude --dangerously-skip-permissions

Alternativ kannst du während einer Session einzelne Aktionen mit “yes” bestätigen oder mit “no” ablehnen. Für produktive Workflows empfehle ich, auto-accept nur in kontrollierten Umgebungen zu nutzen.

Mit Code arbeiten: Die wichtigsten Funktionen im Überblick

Claude Code bietet weit mehr als einfaches Code-Generieren. Als vollwertiger AI-Coding-Assistent unterstützt er dich durch den gesamten Entwicklungsprozess.

Code lesen und verstehen

Gibst du Claude Code eine Aufgabe, analysiert er automatisch die relevanten Dateien in deinem Projekt. Du kannst auch gezielt nach bestimmten Bereichen fragen:

> Was macht die Funktion in src/utils/parser.js?
> Erkläre die Datenbankanbindung in diesem Projekt
> Wo wird die Authentifizierung implementiert?

Code bearbeiten und schreiben

Claude Code kann Dateien direkt erstellen und modifizieren. Er schlägt Änderungen vor, zeigt dir ein Diff an und wartet auf deine Freigabe. So behältst du immer die Kontrolle darüber, was im Projekt passiert.

> Füge eine Fehlerbehandlung für den API-Aufruf in services/api.js hinzu
> Erstelle eine neue Datei components/Header.tsx mit einem responsiven Header
> Optimiere die Datenbankabfragen in models/user.js

Git-Integration

Claude Code arbeitet nahtlos mit Git zusammen. Du kannst Commits erstellen, Branches verwalten und Pull Requests vorbereiten – alles direkt aus der Session heraus:

> Committe die aktuellen Änderungen mit einer passenden Nachricht
> Erstelle einen Branch für das neue Feature
> Was hat sich seit dem letzten Commit geändert?

Claude Code auf dem Desktop nutzen

Neben der reinen CLI-Nutzung gibt es Möglichkeiten, Claude Code komfortabler in deinen Windows-Desktop-Workflow zu integrieren. Das verbessert die Ergonomie erheblich, besonders wenn du täglich damit arbeitest.

Windows Terminal Profile einrichten

Richte ein dediziertes Profil im Windows Terminal ein, das automatisch in dein Hauptprojektverzeichnis wechselt und Claude Code startet. Öffne die Windows Terminal Einstellungen (Strg+,) und füge ein neues Profil hinzu:

{
  "name": "Claude Code",
  "commandline": "wsl.exe -e bash -c 'cd ~/projekte && claude'",
  "startingDirectory": "\\\\wsl$\\Ubuntu\\home\\username\\projekte",
  "icon": "ms-appx:///ProfileIcons/{9acb9455-ca41-5af7-950f-6bca1bc9722f}.scale-200.png"
}

So öffnest du Claude Code mit einem Klick in deinem Projektordner – ohne erst durch Verzeichnisse navigieren zu müssen.

VS Code Integration

Claude Code lässt sich auch aus dem integrierten Terminal von Visual Studio Code heraus nutzen. Öffne das VS Code Terminal und führe einfach claude aus. Der Vorteil: Du siehst gleichzeitig deinen Code-Editor und die Claude Code Session, was das Arbeiten deutlich effizienter macht.

Für tiefergehende Möglichkeiten zur KI-Integration in deinen Entwicklungsworkflow lohnt sich auch ein Blick auf OpenClaude – dort findest du weitere Einblicke in Open-Source-KI-Assistenten und deren Konfigurationsmöglichkeiten.

Sessions verwalten und Einstellungen anpassen

Claude Code bietet verschiedene Einstellungsmöglichkeiten, die du an deinen Workflow anpassen kannst. Die Konfiguration findet über eine lokale JSON-Datei sowie über Kommandozeilenflags statt.

Die CLAUDE.md Konfigurationsdatei

Im Wurzelverzeichnis deines Projekts kannst du eine Datei namens CLAUDE.md anlegen. Diese gibt Claude Code projektspezifische Anweisungen, die bei jeder Session automatisch geladen werden. Beispielinhalt:

# Projektanweisungen für Claude Code

## Technologie-Stack
- Backend: Node.js mit Express
- Frontend: React mit TypeScript
- Datenbank: PostgreSQL

## Coding-Konventionen
- Verwende async/await statt Callbacks
- Schreibe Tests für alle neuen Funktionen
- Kommentare auf Deutsch

## Wichtige Befehle
- Tests: npm test
- Build: npm run build
- Dev-Server: npm run dev

Mit dieser Datei weißt Claude Code von Anfang an, womit er es zu tun hat – ohne dass du bei jeder Session erneut Kontext erklären musst.

Nützliche CLI-Flags und Konfigurationsoptionen

• –model: Wählt das verwendete Claude-Modell (z. B. claude-opus-4-5).
• –print: Führt einen einzelnen Befehl aus und beendet Claude Code danach (non-interactive).
• –no-streaming: Deaktiviert das Streaming der Ausgabe, nützlich bei Pipe-Operationen.
• –add-dir: Fügt ein zusätzliches Verzeichnis zum Kontext hinzu.
• –debug: Aktiviert ausführliche Debug-Ausgaben für die Fehlersuche.

Den Nicht-interaktiven Modus nutzt du beispielsweise so:

claude --print "Analysiere die Datei src/index.js und liste mögliche Bugs auf"

Claude Code erweitern: Plugins und Integrationen

Claude Code unterstützt ein Plugin-System über das Model Context Protocol (MCP). MCP-Server erweitern die Fähigkeiten des Assistenten um zusätzliche Tools – etwa Datenbankzugriffe, Web-Searches oder Integrationen in externe Dienste.

Einen MCP-Server einrichten

MCP-Server werden in der globalen Claude Code Konfiguration registriert. Die Konfigurationsdatei findest du unter:

~/.claude/settings.json

Dort trägst du neue MCP-Server unter dem Schlüssel mcpServers ein. Ein Beispiel für einen Browser-MCP-Server:

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

Nach einem Neustart von Claude Code steht der neue Server in deiner Session zur Verfügung. Claude Code erkennt automatisch, welche Tools vom Server bereitgestellt werden, und kann sie bei passenden Aufgaben einsetzen.

Beliebte MCP-Integrationen für Entwickler

• Filesystem MCP: Erweiterter Dateisystemzugriff über Projektgrenzen hinaus.
• GitHub MCP: Direkte Interaktion mit GitHub-Repositories, Issues und Pull Requests.
• PostgreSQL MCP: Datenbankabfragen und Schema-Analysen direkt aus der Session.
• Brave Search MCP: Web-Suche für aktuelle Informationen während der Entwicklung.

Wer komplexere Automatisierungen und KI-Workflows aufbauen möchte, findet bei der Workflow-Automation von Automated weitere Ansätze, wie sich Claude Code in umfassendere Prozesse integrieren lässt.

Umgebungskonfiguration unter Windows optimieren

Windows bringt einige Besonderheiten mit sich, die beim Einsatz von Claude Code relevant werden. Hier sind die wichtigsten Optimierungen, die du kennen solltest.

Zeilenenden und Encoding richtig konfigurieren

Ein klassisches Windows-Problem sind die unterschiedlichen Zeilenenden (CRLF vs LF). Git neigt dazu, Dateien automatisch zu konvertieren, was Claude Code bei Diffs verwirren kann. Stelle Git auf LF ein:

git config --global core.autocrlf false
git config --global core.eol lf

In WSL ist dieses Problem von Haus aus nicht vorhanden, da du dort in einer echten Linux-Umgebung arbeitest.

Pfade richtig handhaben

Wenn du Claude Code direkt unter Windows (nicht WSL) verwendest, können Windows-Pfade mit Backslashes gelegentlich Probleme verursachen. Claude Code verarbeitet normalerweise Unix-artige Pfade besser. Im Zweifelsfall nutze in PowerShell Forward-Slashes oder das WSL-Pfadformat:

# Windows-Pfad
C:\Users\username\projekte\mein-projekt

# Äquivalent über WSL-Mount
/mnt/c/Users/username/projekte/mein-projekt

Node.js Version Manager (nvm) verwenden

Für Projekte mit unterschiedlichen Node.js-Anforderungen empfiehlt sich der Einsatz von nvm (Node Version Manager). Unter WSL installierst du ihn so:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

Unter Windows nativ gibt es nvm-windows als Alternative. Damit kannst du problemlos zwischen verschiedenen Node.js-Versionen wechseln, ohne Claude Code neu installieren zu müssen.

Firewall und Netzwerk

Claude Code kommuniziert über HTTPS mit der Anthropic API. In Unternehmensumgebungen mit strengen Firewall-Regeln musst du gegebenenfalls sicherstellen, dass ausgehende Verbindungen zu api.anthropic.com auf Port 443 erlaubt sind. Proxy-Einstellungen kannst du über Umgebungsvariablen konfigurieren:

export HTTPS_PROXY="http://proxy.unternehmen.de:8080"
export HTTP_PROXY="http://proxy.unternehmen.de:8080"

Häufige Probleme und Lösungen (Troubleshooting)

Bei der Installation und dem Betrieb von Claude Code unter Windows tauchen immer wieder bestimmte Fehler auf. Hier sind die häufigsten Probleme und ihre Lösungen.

“claude: command not found” nach der Installation

Dieses Problem tritt auf, wenn der globale npm-Bin-Ordner nicht im PATH steht. Prüfe zuerst, wo npm globale Pakete installiert:

npm root -g

Füge das übergeordnete bin-Verzeichnis zu deinem PATH hinzu. Unter WSL/Linux editierst du ~/.bashrc, unter Windows setzt du die Umgebungsvariable über die Systemeinstellungen.

Berechtigungsfehler bei npm install -g

Unter Windows kann es bei der globalen npm-Installation zu Berechtigungsfehlern kommen. Starte PowerShell als Administrator und versuche es erneut. Unter WSL löst du das Problem mit sudo:

sudo npm install -g @anthropic-ai/claude-code

Alternativ konfigurierst du npm so, dass globale Pakete in einem Ordner ohne Root-Rechte installiert werden:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

API-Key wird nicht erkannt

Wenn Claude Code meldet, dass kein API-Key gefunden wurde, prüfe, ob die Umgebungsvariable korrekt gesetzt ist:

echo $ANTHROPIC_API_KEY

Falls die Ausgabe leer ist, hast du die Variable möglicherweise nur für die aktuelle Session gesetzt. Trage sie dauerhaft in ~/.bashrc oder die Windows-Systemumgebungsvariablen ein.

Langsame Performance in WSL

WSL kann bei großen Projekten langsam werden, wenn Dateien auf dem Windows-Filesystem (/mnt/c/) liegen. Kopiere das Projekt in das native Linux-Filesystem:

cp -r /mnt/c/Users/username/projekte/mein-projekt ~/projekte/mein-projekt
cd ~/projekte/mein-projekt
claude

Der Geschwindigkeitsunterschied ist erheblich – Dateizugriffe im Linux-Filesystem sind unter WSL deutlich schneller als über den Windows-Mount.

Unicode-Darstellungsprobleme im Terminal

Falls Claude Code seltsame Zeichen oder Kästchen anstelle von Icons anzeigt, fehlt möglicherweise eine geeignete Nerd Font. Installiere eine kompatible Schriftart wie “Cascadia Code NF” oder “FiraCode NF” und stelle sie im Windows Terminal als Standardschrift ein.

Für eine umfassendere Beratung zu KI-Tools in professionellen Entwicklungsumgebungen bietet die KI-Unterstützung von Automated individuelle Beratung und Implementierungshilfe.

Claude Code aktuell halten

Claude Code wird aktiv weiterentwickelt. Halte die Installation aktuell, um neue Features und Bugfixes zu erhalten. Das Update-Kommando ist denkbar einfach:

npm update -g @anthropic-ai/claude-code

Alternativ installierst du immer die neueste Version mit dem Install-Befehl – npm aktualisiert dabei automatisch, falls bereits eine Version vorhanden ist. Die aktuelle Version überprüfst du mit:

claude --version

In aktiven Projekten empfiehlt es sich, Claude Code in regelmäßigen Abständen zu aktualisieren – neue Modelle und verbesserte Kontext-Fenster machen die Arbeit noch produktiver.

FAQ – Häufig gestellte Fragen

Funktioniert Claude Code unter Windows ohne WSL?

Ja, Claude Code lässt sich direkt unter Windows über PowerShell oder den Windows Terminal verwenden. Die Installation via npm funktioniert ohne WSL. Allerdings bietet WSL2 eine stabilere und schnellere Umgebung, da Claude Code intern viele Unix-typische Operationen nutzt. Für professionelle Nutzung ist WSL2 klar zu empfehlen.

Wie aktualisiere ich Claude Code unter Windows?

Das Update läuft über npm. Führe in PowerShell oder der WSL-Shell folgenden Befehl aus:

npm update -g @anthropic-ai/claude-code

Damit erhältst du immer die aktuellste Version aus dem npm-Registry.

Kann ich Claude Code ohne Internetverbindung nutzen?

Nein. Claude Code kommuniziert für jede Anfrage mit der Anthropic API über das Internet. Eine Offline-Nutzung ist nicht möglich. Du benötigst eine stabile Internetverbindung und einen gültigen API-Key mit ausreichend Credits.

Welches Terminal ist für Claude Code unter Windows am besten geeignet?

Der Windows Terminal in Kombination mit WSL2 und Ubuntu ist die beste Wahl. Er unterstützt alle notwendigen Zeichen korrekt, bietet Tab-Management und lässt sich hervorragend mit Claude Code-Profilen konfigurieren. Als Schrift empfiehlt sich eine Nerd Font für die korrekte Darstellung von Icons.

Wie viel kostet die Nutzung von Claude Code?

Claude Code selbst ist kostenlos via npm installierbar. Du zahlst jedoch für die Nutzung der Anthropic API nach Verbrauch (Token-basiert). Die Kosten hängen vom verwendeten Modell und dem Umfang deiner Sessions ab. Auf der Anthropic-Preisseite findest du aktuelle Tarife. Für Vielnutzer lohnt sich ein Blick auf die Claude-Pro- oder Team-Pläne, die ein Kontingent enthalten.

Kann ich Claude Code in automatisierte Pipelines integrieren?

Ja, über den nicht-interaktiven Modus mit dem --print-Flag lässt sich Claude Code problemlos in CI/CD-Pipelines, Shell-Skripte oder andere Automatisierungen einbinden. Das macht ihn besonders wertvoll für wiederkehrende Code-Analysen, automatische Dokumentationsgenerierung oder Quality-Gate-Checks in Build-Prozessen.