Claude Code installieren unter Windows, Mac und Linux

Um Claude Code zu installieren, führen Sie in einem Terminal den offiziellen Befehl von Anthropic aus: curl -fsSL https://claude.ai/install.sh | bash unter macOS, Linux und WSL oder irm https://claude.ai/install.ps1 | iex in PowerShell unter Windows. Prüfen Sie anschließend mit claude --version und geben Sie dann claude ein, um sich anzumelden. Erforderlich ist ein kostenpflichtiges Claude-Abonnement oder ein Console-Konto: Der kostenlose Plan enthält Claude Code nicht.
Claude Code lässt sich unter Windows, macOS und Linux mit einem Befehl installieren, die Details unterscheiden sich jedoch von System zu System: PowerShell oder CMD, WSL, Homebrew, Linux-Repositorys, zu korrigierender PATH. Dieser Leitfaden enthält die am 18. November 2026 erfassten offiziellen Befehle, die Vorgehensweise, um zu prüfen, ob alles funktioniert, die häufigsten Fehler und zum Schluss die Anbindung an ein lokales Modell mit Ollama.
#Wie installieren Sie Claude Code? Voraussetzungen und offizielle Befehle
Claude Code wird mit einem einzigen offiziellen Befehl installiert: curl -fsSL https://claude.ai/install.sh | bash unter macOS, Linux und WSL oder irm https://claude.ai/install.ps1 | iex in PowerShell unter Windows. Dieses native Skript ist die von Anthropic empfohlene Methode, da es sich im Hintergrund selbst aktualisiert.
Claude Code ist der Programmieragent von Anthropic: ein Programm, das im Terminal verwendet wird, den Code eines Projekts liest, Dateien bearbeitet und nach Ihrer Zustimmung Befehle ausführt. Das Programm wird auf Ihrem Rechner installiert, das KI-Modell läuft jedoch auf den Servern von Anthropic: Laut der am 18. November 2026 eingesehenen offiziellen Dokumentation ist eine Internetverbindung zwingend erforderlich.
| System | Methode | Commande | Automatische Aktualisierung |
|---|---|---|---|
| macOS, Linux, WSL | Natives Skript (empfohlen) | curl -fsSL https://claude.ai/install.sh | bash | Ja, im Hintergrund |
| Windows (PowerShell) | Natives Skript (empfohlen) | irm https://claude.ai/install.ps1 | iex | Ja, im Hintergrund |
| Windows (CMD) | Natives Skript | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd | Ja, im Hintergrund |
| macOS | Homebrew | brew install --cask claude-code | Standardmäßig nicht: brew upgrade claude-code |
| Windows | WinGet | winget install Anthropic.ClaudeCode | Nicht standardmäßig: winget upgrade Anthropic.ClaudeCode |
| Debian, Ubuntu, Fedora, RHEL, Alpine | Signierte apt-, dnf- und apk-Repositorys | Offizielle Dokumentation ansehen | Nein: Systemaktualisierung |
| Alle (Node.js 22 oder höher) | npm | npm install -g @anthropic-ai/claude-code@latest | Je nach Berechtigungen des npm-Ordners |
#Systemanforderungen
Profitiere von unserer Erfahrung und einem geführten Lernpfad, um die passenden Tools für deinen Mac auszuwählen und deine KI im Alltag zu nutzen.
- Lebenslanger Online-Zugang
- PDF + Dateien
- Erstattung binnen 30 Tagen
- System
- macOS 13.0 oder neuer, Windows 10 1809 oder neuer (oder Windows Server 2019), Ubuntu 20.04 oder neuer, Debian 10 oder neuer, Alpine Linux 3.19 oder neuer.
- Hardware
- Mindestens 4 GB RAM und ein x64- oder ARM64-Prozessor. Eine Grafikkarte ist nicht erforderlich, da das Claude-Modell remote läuft.
- Compte
- Ein Abonnement für Claude Pro, Max, Ultra, Team oder Enterprise oder ein nutzungsbasiert abgerechnetes Claude-Console-Konto. Der kostenlose Plan von claude.ai enthält Claude Code nicht.
- Land
- Claude Code ist nur aus den von Anthropic unterstützten Ländern zugänglich; Frankreich gehört dazu.
Zum Preis: Die offizielle Seite von Anthropic, abgerufen am 18. November 2026, weist das Pro-Angebot mit 20 Dollar pro Monat bei monatlicher Abrechnung aus und stellt klar, dass Claude Code in allen kostenpflichtigen Tarifen enthalten ist, mit denselben Nutzungslimits wie der Rest des Abonnements. Die Einzelheiten der Angebote und die kostenlosen Alternativen behandelt der eigene Leitfaden zum Preis von Claude Code.
#Claude Code unter Windows installieren: PowerShell, CMD oder WSL
Unter Windows wird Claude Code über PowerShell mit irm https://claude.ai/install.ps1 | iex installiert, ohne Administratorrechte. Alternativ lässt es sich in WSL 2, dem Linux-Subsystem von Windows, mit dem Linux-Befehl installieren: Dies ist der einzige Windows-Modus, in dem die Sandbox für Befehle unterstützt wird.
- 01PowerShell öffnenÖffnen Sie das Startmenü, geben Sie PowerShell ein und starten Sie es normal, ohne „Als Administrator ausführen“. Die Eingabeaufforderung beginnt mit PS C:\Users\VotreNom>, was bestätigt, dass Sie sich in PowerShell und nicht in der CMD-Eingabeaufforderung befinden.
- 02Installationsskript ausführenFügen Sie den Befehl irm https://claude.ai/install.ps1 | iex ein und bestätigen Sie mit der Eingabetaste. Das Skript lädt Claude Code herunter, ohne einen Fortschrittsbalken anzuzeigen: Warten Sie, bis die Eingabeaufforderung zurückkehrt, bevor Sie etwas anderes tun.
- 03Neues Terminal öffnenSchließen Sie das PowerShell-Fenster und öffnen Sie ein neues, damit der Installationsordner berücksichtigt wird. Das Programm wird unter %USERPROFILE%\.local\bin\claude.exe abgelegt.
- 04Version überprüfenGeben Sie claude --version ein. Bei erfolgreicher Installation wird eine Versionsnummer gefolgt von (Claude Code) angezeigt. Meldet Windows, dass claude nicht erkannt wird, wenden Sie die weiter unten beschriebene PATH-Korrektur an.
- 05Git for Windows installieren (empfohlen)Git for Windows ist optional, wird aber von Anthropic empfohlen: Es stellt Git Bash bereit, das Claude Code zum Ausführen seiner Befehle verwendet. Ohne Git for Windows greift Claude Code auf PowerShell zurück. Eine Installation in WSL benötigt es nicht.
#Claude Code auf dem Mac installieren: natives Skript oder Homebrew
Auf dem Mac installieren Sie Claude Code, indem Sie die Terminal-App öffnen und curl -fsSL https://claude.ai/install.sh | bash ausführen. Erforderlich ist macOS 13.0 oder neuer; sowohl Macs mit Apple Silicon (ARM64) als auch Intel-Macs (x64) werden unterstützt. Homebrew ist eine Alternative, allerdings ohne automatische Updates.
Homebrew bietet zwei Claude-Code-Pakete an. Das Paket claude-code folgt dem stabilen Kanal, der in der Regel etwa eine Woche hinterherhinkt und Versionen mit größeren Regressionen ausschließt. Das Paket claude-code@latest erhält jede Version, sobald sie erscheint. Standardmäßig erfolgt das Homebrew-Update manuell mit brew upgrade claude-code bzw. brew upgrade claude-code@latest für das zweite Paket. Damit Claude Code dieses Homebrew- oder WinGet-Update selbst startet, muss laut der Dokumentation von Anthropic die Umgebungsvariable CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE auf 1 gesetzt werden.
Das native Skript legt den Launcher unter ~/.local/bin/claude ab. Wenn das Terminal mit „command not found: claude“ antwortet, ist dieser Ordner noch nicht im PATH Ihrer Shell: Die Lösung finden Sie im Abschnitt zu den Fehlern.
#Claude Code unter Linux installieren: Skript, apt, dnf oder Alpine
Unter Linux wird Claude Code mit demselben Skript wie auf dem Mac installiert: curl -fsSL https://claude.ai/install.sh | bash, ohne sudo. Anthropic veröffentlicht außerdem signierte Repositorys für apt (Debian, Ubuntu), dnf (Fedora, RHEL) und apk (Alpine) für Rechner, auf denen Software über den Paketmanager installiert werden muss.
Alpine Linux und andere musl-basierte Distributionen enthalten standardmäßig weder bash noch curl. Ohne sie schlägt das Installationsskript mit dem Fehler „not found“ fehl. Installieren Sie zuerst diese beiden Pakete und führen Sie dann den Installationsbefehl erneut aus.
Die apt-, dnf- und apk-Repositorys bieten jeweils einen stable- und einen latest-Kanal. Ihre Einrichtung erfordert mehrere Befehle, darunter die Überprüfung des Fingerabdrucks des Signaturschlüssels von Anthropic: Folgen Sie ihnen direkt auf der Seite zur erweiterten Installation in der offiziellen Dokumentation, die am Ende des Leitfadens verlinkt ist. Diese Installationen werden zusammen mit dem System aktualisiert, zum Beispiel mit sudo apt update && sudo apt upgrade claude-code.
#Wie prüfen Sie, ob Claude Code korrekt installiert ist?
Um die Installation von Claude Code zu überprüfen, öffnen Sie ein neues Terminal und geben Sie claude --version ein: Es muss eine Versionsnummer angezeigt werden. Am 18. November 2026 ist die neueste Version an der Spitze des offiziellen Versionsprotokolls die 2.1.327, während der stabile Kanal laut npm-Registry die 2.1.311 verteilt. Eine ältere Nummer ist also nicht unbedingt ein Fehler: Das Homebrew-Paket claude-code und die standardmäßig konfigurierten Linux-Repositorys folgen diesem stabilen Kanal. Der Befehl claude doctor liefert anschließend eine vollständige Diagnose.
Der Befehl claude doctor zeigt, ohne eine Sitzung zu öffnen, den Zustand der Installation, Fehler in den Einstellungsdateien sowie Warnungen mit einem Korrekturvorschlag an. Das ist der erste Schritt, wenn sich Claude Code nach einer Installation oder einem Update merkwürdig verhält.
- 01In ein Projekt wechselnWechseln Sie im Terminal mit dem Befehl cd, gefolgt vom Ordnerpfad, in den Projektordner, an dem Sie arbeiten möchten. Claude Code arbeitet mit den Dateien des Ordners, in dem es gestartet wird.
- 02Claude Code startenGeben Sie claude ein. Beim ersten Start öffnet Claude Code den Browser, damit Sie sich mit Ihrem Claude-Konto (Pro, Max, Ultra, Team, Enterprise) oder Ihrem Console-Konto anmelden. Wenn der Browser einen Code anzeigt, statt zum Terminal zurückzukehren, fügen Sie diesen Code im Terminal ein.
- 03Eine erste Frage stellenNach der Anmeldung zeigt die Eingabeaufforderung von Claude Code die Version, das Modell und den Arbeitsordner an. Fragen Sie zum Beispiel „Was macht dieses Projekt?“. Die Anmeldedaten bleiben gespeichert: Bei späteren Starts wird die Anmeldung nicht mehr abgefragt.
- 04Projekt vorbereitenGeben Sie /init ein, damit Claude Code den Code analysiert und eine erste CLAUDE.md-Datei mit den Build- und Testbefehlen sowie den Konventionen des Projekts erzeugt. Geben Sie /help für die Liste der Befehle und /config für die Einstellungen ein.
#Claude Code aktualisieren oder deinstallieren
Eine native Installation von Claude Code aktualisiert sich beim Start und im Hintergrund selbstständig; der Befehl claude update installiert sofort die neueste Version. Bei einer nativen Installation unter macOS, Linux oder WSL besteht die Deinstallation darin, den Launcher und den Versionsordner zu löschen.
#Claude Code nicht gefunden oder Installation blockiert: die häufigsten Fehler
Der häufigste Fehler nach der Installation von Claude Code ist „command not found: claude“ oder „'claude' wird nicht als interner oder externer Befehl erkannt“: Das Programm ist zwar installiert, aber sein Ordner, ~/.local/bin auf Mac und Linux bzw. %USERPROFILE%\.local\bin unter Windows, ist nicht im PATH. Das Installationsprogramm weist in seinen „Setup notes“ darauf hin, ohne den PATH selbst zu korrigieren.
| Angezeigte Meldung | Ursache | Korrekturmaßnahme |
|---|---|---|
| command not found: claude / 'claude' is not recognized | Installationsordner nicht im PATH | ~/.local/bin (bzw. %USERPROFILE%\.local\bin) zum PATH hinzufügen, dann ein neues Terminal öffnen |
| The token '&&' is not a valid statement separator | In PowerShell eingefügter CMD-Befehl | Den PowerShell-Befehl verwenden |
| 'irm' is not recognized as an internal or external command | PowerShell-Befehl in CMD eingefügt | CMD-Befehl verwenden |
| curl: (22) The requested URL returned error: 403 | Proxy oder Netzwerkfilter, oder nicht unterstütztes Land | Netzwerk oder Unternehmens-Proxy überprüfen |
| App unavailable in region | Von Anthropic nicht unterstütztes Land | Claude Code ist in diesem Land nicht verfügbar |
| not found unter Alpine | bash ou curl absents | apk add bash curl |
Die Korrektur für zsh gilt unter macOS, wo zsh die Standard-Shell ist. Unter Linux mit bash wird dieselbe export-Zeile in die Datei ~/.bashrc eingefügt; auf dem Mac mit bash gehört sie in ~/.bash_profile, da das Terminal von macOS bash als Login-Shell startet, die ~/.bashrc ignoriert. Ein vor der Korrektur geöffnetes Terminal behält den alten PATH, und ein in einen Editor wie VS Code integriertes Terminal übernimmt den PATH des Editors: Schließen Sie das Fenster bzw. den Editor und öffnen Sie ihn erneut, bevor Sie claude --version noch einmal testen.
#Wie verbinden Sie Claude Code mit VS Code?
Um Claude Code in VS Code zu verwenden, installieren Sie die offizielle Claude-Code-Erweiterung von Anthropic: Öffnen Sie die Erweiterungsansicht mit Cmd+Shift+X auf dem Mac oder Ctrl+Shift+X unter Windows und Linux, suchen Sie nach „Claude Code“ und klicken Sie auf „Installieren“. Erforderlich sind VS Code 1.94.0 oder neuer sowie ein kostenpflichtiges Claude-Konto oder ein Console-Konto.
Die VS-Code-Erweiterung von Claude Code bringt für ihr Chat-Panel eine eigene Kopie des Programms mit, fügt diese aber nicht zum PATH hinzu. Um claude im integrierten Terminal von VS Code einzugeben, ist die oben beschriebene eigenständige Installation weiterhin erforderlich. Die Erweiterung lässt sich über die Open-VSX-Registry auch in Cursor und anderen von VS Code abgeleiteten Editoren installieren.
#Claude Code mit Ollama an ein lokales Modell anbinden
Claude Code kann dank Ollama, das eine mit der Anthropic-API kompatible API bereitstellt, mit einem lokalen Modell arbeiten. Sobald Claude Code und Ollama installiert sind, startet der Befehl ollama launch claude Claude Code mit Anbindung an Ollama. Die Dokumentation von Ollama empfiehlt ein lokales Modell, das auf einen Kontext von 64k Tokens oder mehr eingestellt ist.
Die Dokumentation von Ollama beschreibt außerdem eine manuelle Konfiguration über Umgebungsvariablen, die Claude Code auf den lokalen Server von Ollama auf Port 11434 verweist. Das offizielle Beispiel verwendet das Modell qwen3.5, dessen Standard-Tag in der Bibliothek von Ollama der Version 9B mit 6,6 bis 7,6 GB entspricht; ein Modell muss Tool-Aufrufe unterstützen, damit Claude Code Dateien lesen und bearbeiten kann.
Ist Claude Code kostenlos?+
Wird Node.js für die Installation von Claude Code benötigt?+
Benötigen Sie Administratorrechte, um Claude Code unter Windows zu installieren?+
Wie installiert man ein Plugin in Claude Code?+
Wie konfiguriert man Claude Code nach der Installation richtig?+
Funktioniert Claude Code offline?+
Wie aktualisiert man Claude Code?+
#Quellen und Überprüfung vom 18. November 2026
Die Befehle, Voraussetzungen, Versionen und Preise in diesem Leitfaden wurden am 18. November 2026 der offiziellen Dokumentation von Claude Code, der Preisseite von Anthropic, dem Versionsprotokoll des GitHub-Repositorys von Anthropic und der Dokumentation von Ollama entnommen; Befehle und Preise ändern sich häufig, prüfen Sie sie daher vor einer Installation im Unternehmen.
- Quelle: erweiterte Installation von Claude Code (Anthropic)
- Quelle: Schnellstart von Claude Code (Anthropic)
- Quelle: Fehlerbehebung bei der Installation (Anthropic)
- Quelle: VS-Code-Erweiterung (Anthropic)
- Quelle: Preise der Claude-Tarife (Anthropic)
- Quelle: Changelog von Claude Code (GitHub, Anthropic)
- Quelle: Claude Code mit Ollama (Dokumentation von Ollama)
Haben Sie Feedback, einen Fehler entdeckt oder möchten Sie etwas präzisieren? Geben Sie uns Bescheid – so wird der Guide für alle besser.