Claude Code installieren dauert auf jedem System einen einzigen Befehl im Terminal: auf dem Mac und unter Linux curl -fsSL https://claude.ai/install.sh | bash, unter Windows in der PowerShell irm https://claude.ai/install.ps1 | iex. Danach wechselst du in einen Projektordner, tippst claude und meldest dich im Browser mit deinem Claude-Konto an. Node.js brauchst du dafür nicht, Administratorrechte auch nicht, aber ein bezahltes Abo: Der kostenlose Plan enthält Claude Code laut Anthropic nicht. Alle Befehle in diesem Beitrag stammen wörtlich aus der Anthropic-Dokumentation, Stand September 2026, und ich nenne bei jedem, wo er herkommt.
Ich arbeite seit dem Erscheinen von Claude Code täglich damit, auf einem MacBook Pro und auf einem Linux-Rechner. Meine KI-Belegschaft auf Claude-Basis läuft in Arbeitsordnern mit einer eigenen CLAUDE.md je Mitarbeiter, meistens im Terminal. Die Installation ist der kleinste Teil davon, aber sie ist der Schritt, an dem die typischen Stolperfallen liegen: falsche Shell, fehlender PATH, kostenloses Konto. Alles Weitere zu Claude sammle ich auf der Seite Claude.
Was du vor der Installation brauchst
Drei Dinge musst du vorher klären: Konto, System und Terminal. Zum Konto sagt die Anthropic-Doku zur Einrichtung unmissverständlich: Claude Code verlangt ein Pro-, Max-, Team-, Enterprise- oder Console-Konto, der kostenlose Plan auf claude.ai reicht nicht. Die aktuellen Preise, Stand September 2026, stehen mit Quelle in Claude Kosten und Abos im Überblick: Pro 20 Dollar im Monat, Max 100 oder 200 Dollar im Monat, Team ab 20 Dollar je Sitz und Monat. Ich habe nicht mit Max angefangen, inzwischen nutze ich es, weil die Belegschaft in langen Sitzungen läuft. Für den Einstieg reicht Pro.
Zum System nennt dieselbe Doku diese Mindestanforderungen: macOS 13 oder neuer, Windows 10 ab Version 1809 oder Windows Server 2019, Ubuntu 20.04, Debian 10 oder Alpine 3.19, jeweils mit mindestens 4 GB RAM und einem 64-Bit-Prozessor (x64 oder ARM64). 32-Bit-Windows wird nicht unterstützt. Dazu brauchst du eine Internetverbindung und ein Konto in einem der von Anthropic unterstützten Länder.
Node.js ist keine Voraussetzung mehr. Der empfohlene native Installer lädt eine fertige Programmdatei, die ohne Node läuft. Nur wer den alten Weg über npm wählt, braucht laut Doku seit Version 2.1.198 Node.js 22 oder neuer, und selbst dort holt npm nur eine native Binary. Wer nach einem Claude Code Download sucht, findet also keine klassische Setup-Datei zum Doppelklicken: Der Installer ist ein kurzes Skript, das die passende Datei für dein System lädt. Die Ausnahme ist die Desktop-App, die Claude Code als Oberfläche enthält und laut der Übersichtsseite der Doku für macOS, Windows und als Beta für Linux angeboten wird, ebenfalls nur mit bezahltem Abo.
Claude Code auf dem Mac installieren
Auf dem Mac öffnest du das Terminal (Programme, Dienstprogramme) und tippst den Befehl aus der Anthropic-Doku ein:
curl -fsSL https://claude.ai/install.sh | bash
Das Skript legt die Programmdatei unter ~/.local/bin/claude ab und hält sie danach im Hintergrund selbst aktuell. Wenn du Homebrew nutzt, geht laut Doku auch brew install --cask claude-code. Dieser Kanal hängt etwa eine Woche hinter der aktuellen Version und überspringt Versionen mit schweren Rückschritten. Wer immer die neueste Version will, nimmt brew install --cask claude-code@latest. Beide Homebrew-Varianten aktualisieren sich nicht von selbst: dafür läuft brew upgrade claude-code beziehungsweise brew upgrade claude-code@latest.
Bei mir läuft Claude Code seit dem Start als Research Preview im Februar 2025 auf dem Mac, seit Mai 2025 ist es allgemein verfügbar. Installiert ist es hier über den nativen Installer: Die Programmdatei liegt unter ~/.local/bin/claude, und sie hält sich selbst aktuell; von Hand stoße ich nichts an. Wenn du über Homebrew installierst, ist das anders, deshalb steht brew upgrade oben. Der Mac ist auch das System, auf dem ich die Belegschaft betreibe. Welche Befehle für welches System gelten, nehme ich in diesem Beitrag trotzdem aus der Doku und kennzeichne sie so, statt dir Erfahrungen zu erzählen, die ich nicht habe.
Claude Code unter Windows installieren: drei Wege
Für Windows nennt die Doku drei Wege, die sich in Voraussetzungen und Möglichkeiten unterscheiden. Die Entscheidung hängt davon ab, womit du sonst arbeitest:
Der native Weg ist für die meisten der einfachste. Du öffnest die PowerShell (nicht die Eingabeaufforderung und nicht „Windows PowerShell (x86)") und führst den Befehl aus der Doku aus:
irm https://claude.ai/install.ps1 | iex
Administratorrechte sind laut Doku ausdrücklich nicht nötig. Wer lieber in der klassischen Eingabeaufforderung arbeitet, nimmt die CMD-Variante curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd, und wer den Windows-Paketmanager nutzt, winget install Anthropic.ClaudeCode. Git for Windows ist laut Doku optional, aber für den nativen Weg empfohlen: Ohne läuft Claude Code über die PowerShell, mit Git nutzt es die Git Bash. Findet es die Git Bash nicht, trägst du den Pfad in die Datei settings.json ein:
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}
Für WSL 2 installierst du Claude Code nicht unter Windows, sondern innerhalb deiner Linux-Distribution mit dem Linux-Befehl aus dem nächsten Abschnitt und startest claude im WSL-Terminal. Auf WSL 1 gibt es laut der Fehlerbehebungsseite von Anthropic einen bekannten Fehler mit der Meldung Exec format error. Die Lösung ist der Wechsel auf WSL 2 mit wsl --set-version <Name deiner Distribution> 2.
Selbst arbeite ich nicht unter Windows, aber ich habe Kunden bei der Installation dort begleitet. Die Beobachtung daraus: Wer keine Softwareentwicklung macht, landet am Ende meistens bei der Claude-Desktop-App statt beim Terminal. Sie enthält Claude Code als Oberfläche, und die Installationsbefehle oben braucht dann niemand mehr.
Claude Code unter Linux installieren
Unter Linux ist der Befehl derselbe wie auf dem Mac:
curl -fsSL https://claude.ai/install.sh | bash
Das gilt für Ubuntu, Debian und ebenso innerhalb von WSL. Für Alpine nennt die Doku einen Zwischenschritt: bash und curl sind dort nicht vorinstalliert, zur Laufzeit kommen libgcc, libstdc++ und ripgrep dazu, und in der settings.json steht danach USE_BUILTIN_RIPGREP auf 0. Zusätzlich bietet Anthropic laut Doku signierte Paketquellen für apt, dnf und apk unter downloads.claude.ai an, danach reicht zum Beispiel sudo apt install claude-code. Die genauen Zeilen zum Einbinden der Paketquelle und den Fingerabdruck des Signaturschlüssels kopierst du am besten direkt aus der Doku, damit du nicht auf einen Tippfehler von mir hereinfällst. Ein dritter Weg ist npm install -g @anthropic-ai/claude-code, den die Doku mit einem klaren Hinweis versieht: nie mit sudo ausführen.
Bei mir läuft Claude Code außer auf dem Mac auch auf meinem DGX Spark, und dort unter Linux. Der Ablauf ist derselbe: Terminal auf, Befehl ausführen, in den Projektordner wechseln.
Wichtig für den Betrieb: Paketquellen, Homebrew und WinGet aktualisieren Claude Code nicht von selbst. Nur der native Installer tut das im Hintergrund. Wer über eine Paketquelle installiert, baut das Update in seine normale Systemroutine ein.
Prüfen, anmelden und aktuell halten
Nach der Installation öffnest du ein neues Terminalfenster, damit der PATH neu geladen wird, und prüfst:
claude --version
Die Ausgabe sieht laut Doku etwa so aus: 2.1.211 (Claude Code). Wenn du tiefer prüfen willst, zeigt claude doctor Installationsart, Version und mögliche Probleme. Dann wechselst du in einen Projektordner und startest die erste Sitzung:
cd dein-projekt
claude
Beim ersten Start öffnet sich der Browser, dort meldest du dich mit deinem Claude-Konto an. In WSL 2, über SSH oder in einem Container geht der Browser nicht automatisch auf; die Doku beschreibt dafür einen Code, den du im Browser bekommst und im Terminal einfügst, alternativ claude auth login.
Der Ordner, in dem du claude startest, ist das Arbeitsverzeichnis, und das ist der eigentliche Hebel. Bei mir hat jeder KI-Mitarbeiter einen eigenen Ordner mit einer CLAUDE.md, in der steht, wer er ist und was er darf. Sebastian, mein Mitarbeiter für SEO und GEO, arbeitet ausschließlich so: Am 07.09.2026 hat er aus seiner Terminal-Sitzung heraus die Übergabe für das Release von 76 neuen Blogbeiträgen an Ralf geschrieben, Ralf hat sie als Subagent ausgerollt, und Sebastian hat danach live geprüft. Die Freigabe dafür habe ich um 18:24 Uhr gegeben und er hat sie mit Zeitpunkt protokolliert. Wie so eine Datei aussieht, steht in CLAUDE.md: das Gedächtnis von Claude Code.
Zum Aktualisieren: Der native Installer aktualisiert sich selbst im Hintergrund. Wer eingreifen will, nutzt claude update, für Homebrew brew upgrade claude-code, für WinGet winget upgrade Anthropic.ClaudeCode. Wer lieber den stabilen Kanal fährt, setzt laut Doku "autoUpdatesChannel": "stable" in der settings.json. Zum Deinstallieren nennt die Doku für Mac und Linux rm -f ~/.local/bin/claude && rm -rf ~/.local/share/claude, für Windows Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force und zusätzlich den Ordner $env:USERPROFILE\.local\share\claude.
Sieben Fehlermeldungen und ihre Lösung
Die Fehlerbehebungsseite von Anthropic listet die häufigsten Meldungen. Fast alle haben dieselbe Ursache: der richtige Befehl in der falschen Shell.
'irm' is not recognized: Du bist in der Eingabeaufforderung, nicht in der PowerShell. Öffne die PowerShell oder nimm die CMD-Variante des Installers.The token '&&' is not valid: Der umgekehrte Fall, du hast den CMD-Befehl in der PowerShell eingegeben.A parameter cannot be found that matches parameter name 'fsSL': Du hast den Mac- und Linux-Befehl in der PowerShell eingegeben. Dort ist curl ein Alias für Invoke-WebRequest und kennt die Option nicht.command not found: claude oder 'claude' is not recognized: Die Installation ist durchgelaufen, aber der Ordner ~/.local/bin (Windows: %USERPROFILE%\.local\bin) steht nicht im PATH. Meist reicht ein neues Terminalfenster. Unter Windows ergänzt die Doku den PATH mit [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User'). Beachte: Die VS-Code-Erweiterung legt keinen claude-Befehl im Terminal an.running scripts is disabled on this system: Die Execution Policy von PowerShell blockiert den Starter der npm-Installation, nicht den nativen Installer. Lösung laut Doku: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser oder gleich nativ installieren.syntax error near unexpected token '<' oder ein 403-Fehler: Der Installer hat eine HTML-Seite statt des Skripts bekommen, typisch bei Proxys oder in nicht unterstützten Regionen. Ausweg ist WinGet beziehungsweise Homebrew.- Fehler zu 32-Bit unter Windows: Entweder ist dein Windows tatsächlich 32-Bit, dann geht es nicht, oder du hast auf einem 64-Bit-Rechner „Windows PowerShell (x86)" geöffnet. Nimm das Startmenü-Element ohne den Zusatz.
Wenn keine dieser sieben Meldungen passt, ist claude doctor der nächste Schritt, bevor du neu installierst.
Häufige Fragen
Brauche ich Node.js, um Claude Code zu installieren?
Nein. Der native Installer, den Anthropic empfiehlt, lädt eine fertige Programmdatei ohne Node.js. Nur das npm-Paket verlangt laut Doku seit Version 2.1.198 Node.js 22 oder neuer, und auch dort läuft Claude Code zur Laufzeit ohne Node.
Geht Claude Code auch mit dem kostenlosen Claude-Konto?
Nein. Die Anthropic-Doku nennt als Voraussetzung ein Pro-, Max-, Team-, Enterprise- oder Console-Konto. Mit dem Free-Plan kannst du Claude im Browser nutzen, aber Claude Code nicht starten. Was die Pläne kosten und welcher für den Einstieg reicht, steht in Claude Code Kosten: Abo oder API?.
Windows: PowerShell oder WSL, was ist besser für mich?
Wenn deine Projekte und Werkzeuge unter Windows laufen, nimm den nativen Weg über die PowerShell; er braucht nichts weiter und keine Administratorrechte. WSL 2 lohnt sich, wenn du mit Linux-Werkzeugen arbeitest oder das Sandboxing von Befehlen nutzen willst, das laut Doku nur dort unterstützt wird. WSL 1 ist nur der Notnagel.
Warum sagt mein Terminal „claude wird nicht erkannt", obwohl die Installation durchgelaufen ist?
Weil der Installationsordner noch nicht im PATH deines Terminals steht. Schließe das Terminal und öffne es neu; unter Windows hilft sonst der PATH-Befehl aus dem Abschnitt zu den Fehlermeldungen. Prüfe auch, ob du in derselben Umgebung bist, in der du installiert hast: Eine Installation in WSL ist in der Windows-PowerShell nicht sichtbar.
Muss ich Claude Code selbst aktualisieren?
Mit dem nativen Installer nicht, der aktualisiert sich laut Doku im Hintergrund. Homebrew, WinGet, apt, dnf und apk aktualisieren nicht automatisch, dort führst du das Update wie bei jedem anderen Paket selbst aus. claude update stößt die Aktualisierung jederzeit manuell an.
Wo finde ich den Claude Code Download für Windows?
Es gibt keine Setup-Datei zum Herunterladen, sondern den Installationsbefehl für die PowerShell oder das WinGet-Paket Anthropic.ClaudeCode. Wer eine klassische Anwendung mit Fenster will, findet in der Desktop-App von Claude eine Oberfläche, die Claude Code enthält, ebenfalls nur mit bezahltem Abo.
Was ist der Unterschied zwischen Claude Code CLI und der Desktop-App?
Die CLI ist das Werkzeug im Terminal, das du mit claude startest und das in deinem aktuellen Ordner arbeitet. Die Desktop-App bringt laut Doku dieselbe Funktion in eine Fensteroberfläche. Ich nutze je nach Aufgabe beides, meistens das Terminal, weil ich es gewohnt bin. Bei Kunden, die keine Software entwickeln, ist es meistens umgekehrt: Sie bleiben bei der Desktop-App. Wenn du eher eine Oberfläche als ein Terminal willst, hilft dir Claude Code oder Cowork: was wofür? bei der Entscheidung.
Wie du weitermachst
Nach claude --version ist Claude Code installiert, mehr ist es nicht. Der nächste Schritt ist die erste Aufgabe in einem kleinen, echten Ordner, und dafür habe ich Claude Code: Anleitung für Einsteiger geschrieben: Lass dir zuerst zusammenfassen, was in dem Ordner liegt, bevor du die erste Änderung freigibst. Sobald das klappt, legst du eine CLAUDE.md an, damit du den Kontext nicht bei jeder Sitzung neu erklärst; wie sie bei mir aussieht, zeigt CLAUDE.md: das Gedächtnis von Claude Code. Wiederkehrende Aufgaben fasst du danach in Claude Skills: erstellen und nutzen.
Die acht fertigen KI-Mitarbeiter-Pakete, jedes mit eigener Personalakte als CLAUDE.md, gibt es in meiner Community. Sie setzen genau diese Installation voraus: ein Terminal, ein Abo, ein Ordner.
