WissenClaude Code & Vibe Coding

Claude Code auf Windows einrichten, was anders läuft als auf dem Mac

Die meisten Claude-Code-Tutorials zeigen einen Mac-Terminal mit zsh. Was auf Windows tatsächlich passiert, welche Shell im Hintergrund läuft und wo die echten Unterschiede stecken.

Tommy Hummel-Nguyen
Tommy Hummel-Nguyen · Ingenieur, kein Softwareentwickler ·

Die meisten Claude-Code-Anleitungen zeigen einen Mac-Bildschirm, ein Terminal mit einem Dollarzeichen und zsh im Hintergrund. Auf Windows siehst du stattdessen ein PS vor deinem Pfad, und die erste Frage ist meistens: reicht das, oder brauche ich jetzt WSL, um überhaupt mitzumachen?

Kurz gesagt

Claude Code läuft seit 2025 nativ auf Windows 10 und 11, ganz ohne WSL. Installiert wird es mit einer Zeile in PowerShell, ohne Administratorrechte. Ohne Git für Windows nutzt Claude Code die eingebaute PowerShell für Befehle, mit Git für Windows nutzt es Git Bash und damit echte Bash-Syntax. Der größte Unterschied zum Mac ist also nicht die Installation, sondern welche Shell im Hintergrund deine Befehle ausführt.

Installation in einer Zeile

Für die native Installation reicht ein Befehl in PowerShell:

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

Der Befehl installiert Claude Code unter deinem eigenen Benutzerprofil, ganz ohne Administratorrechte. Windows 10 ab Version 1809 oder Windows Server 2019 reichen als Betriebssystem, dazu mindestens 4 GB Arbeitsspeicher. Danach startest du einfach claude im Ordner deines Projekts und meldest dich im Browser mit einem Pro-, Max-, Team-, Enterprise- oder Console-Konto an. Der kostenlose Claude.ai-Zugang reicht dafür nicht.

Native Installation oder WSL, was du wählen solltest

Du hast zwei sinnvolle Wege. Native Windows-Installation, wenn deine Projekte ohnehin unter Windows liegen und du keine Linux-Werkzeuge brauchst. WSL, wenn du sowieso mit einem Linux-Werkzeugkasten arbeitest oder die eingebaute Bash-Sandbox nutzen willst, die aktuell unter nativem Windows nicht unterstützt wird, unter WSL2 aber schon. Für die meisten Solo-Projekte reicht die native Installation völlig, sie ist einfacher aufzusetzen und du bleibst in deiner gewohnten Windows-Umgebung.

Der eigentliche Unterschied: welche Shell im Hintergrund läuft

Das ist der Punkt, an dem sich Windows spürbar vom Mac unterscheidet. Ohne installiertes Git für Windows nutzt Claude Code für Bash-Befehle automatisch die PowerShell. Mit installiertem Git für Windows nutzt es stattdessen Git Bash, also eine echte Bash-Umgebung, wie du sie von Tutorials aus dem Mac- oder Linux-Umfeld kennst. Deshalb ist die Empfehlung, Git für Windows gleich mitzuinstallieren, auch wenn du kein aktives Git-Projekt hast. Findet Claude Code Git Bash nicht automatisch, lässt sich der Pfad manuell in der settings.json setzen, über den Schlüssel CLAUDE_CODE_GIT_BASH_PATH.

Was auf Windows noch anders läuft

Zwei Dinge solltest du kennen, bevor du auf ein Tutorial stößt, das sie voraussetzt. Erstens: die eingebaute Bash-Sandbox, die Befehle in einer isolierten Umgebung ausführt, läuft nativ unter Windows nicht, nur unter macOS, Linux und WSL2. Zweitens: Symlinks, wie sie manche Anleitungen zum Verknüpfen von AGENTS.md mit CLAUDE.md vorschlagen, brauchen unter Windows Administratorrechte oder den aktivierten Entwicklermodus. Für beide Fälle gibt es funktionierende Alternativen, aber sie sehen anders aus als im Mac-Tutorial.

Ich denke, der Windows-Einstieg wirkt komplizierter, als er ist, weil fast jede Anleitung im Netz mit einem Mac gedreht wird. Sobald einmal Git für Windows installiert ist, läuft der Alltag danach fast identisch, mit Bash-Syntax statt PowerShell-Syntax in den Befehlen. Der Unterschied liegt nicht im Werkzeug selbst, nur in dem, was du am Anfang einmal einrichtest.

Quellen: Advanced setup (Claude Code Docs) · Claude Code Windows Install Guide 2026 (SmartScope)

Häufige Fragen

Brauche ich WSL, um Claude Code auf Windows zu nutzen?

Nein. Claude Code läuft seit 2025 nativ auf Windows 10 und 11, ganz ohne WSL. WSL bleibt eine Option, wenn du einen Linux-Werkzeugkasten brauchst oder die Bash-Sandbox nutzen willst, die nativ unter Windows aktuell nicht unterstützt wird.

Was mache ich, wenn Claude Code Git Bash nicht findet?

Trage den Pfad manuell in deine settings.json ein, über den Schlüssel CLAUDE_CODE_GIT_BASH_PATH, zum Beispiel C:\\Program Files\\Git\\bin\\bash.exe.

Reicht der kostenlose Claude-Zugang für Claude Code?

Nein. Du brauchst mindestens ein Pro-, Max-, Team-, Enterprise- oder Console-Konto. Der kostenlose Claude.ai-Zugang schließt Claude Code nicht mit ein.

Aktualisiert sich Claude Code auf Windows von selbst?

Bei der nativen Installation ja, im Hintergrund. Bei einer Installation über Winget oder Homebrew musst du selbst mit winget upgrade beziehungsweise brew upgrade nachziehen.

Willst du das bei dir umsetzen?

In der Community zeige ich, was bei mir hält. Im Erstgespräch schauen wir uns dein Vorhaben konkret an.