Einsteiger 14 Min.IDE

Claude Code installieren unter Windows, Mac und Linux

Ein aufgeklappter Laptop taucht einen dunklen Schreibtisch in grünes Licht.
Direkte Antwort

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.

Von Mohamed Meguedmi·Aktualisierung 2026-11-20·Getestet auf Windows 11

#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.

Installationsmethoden für Claude Code je nach System (Anthropic-Dokumentation, 18. November 2026)
SystemMethodeCommandeAutomatische Aktualisierung
macOS, Linux, WSLNatives Skript (empfohlen)curl -fsSL https://claude.ai/install.sh | bashJa, im Hintergrund
Windows (PowerShell)Natives Skript (empfohlen)irm https://claude.ai/install.ps1 | iexJa, im Hintergrund
Windows (CMD)Natives Skriptcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdJa, im Hintergrund
macOSHomebrewbrew install --cask claude-codeStandardmäßig nicht: brew upgrade claude-code
WindowsWinGetwinget install Anthropic.ClaudeCodeNicht standardmäßig: winget upgrade Anthropic.ClaudeCode
Debian, Ubuntu, Fedora, RHEL, AlpineSignierte apt-, dnf- und apk-RepositorysOffizielle Dokumentation ansehenNein: Systemaktualisierung
Alle (Node.js 22 oder höher)npmnpm install -g @anthropic-ai/claude-code@latestJe nach Berechtigungen des npm-Ordners

#Systemanforderungen

Das komplette Kit, um lokale KI auf deinem Mac zu nutzen.

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.

  1. 01
    PowerShell ö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.
  2. 02
    Installationsskript ausführen
    Fü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.
  3. 03
    Neues Terminal öffnen
    Schließ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.
  4. 04
    Version überprüfen
    Geben 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.
  5. 05
    Git 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.
Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows (WinGet)
winget install Anthropic.ClaudeCode
→
WSL 2 oder natives Windows?
Wählen Sie natives Windows für Windows-Projekte und -Tools. Wählen Sie WSL 2, wenn Ihre Projekte Linux-Tools verwenden oder wenn Sie die Befehls-Sandbox nutzen möchten, die laut der Dokumentation von Anthropic weder unter nativem Windows noch unter WSL 1 unterstützt wird. Installieren und starten Sie claude in WSL über das WSL-Terminal, nicht über PowerShell.

#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.

macOS (Terminal, natives Skript)
curl -fsSL https://claude.ai/install.sh | bash
macOS (Homebrew)
brew install --cask claude-code

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.

Linux (Ubuntu, Debian, Fedora…)
curl -fsSL https://claude.ai/install.sh | bash

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.

Linux (Alpine)
apk add bash curl

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.

!
Installation über npm: niemals mit sudo
Die npm-Methode erfordert Node.js 22 oder höher. Die Dokumentation von Anthropic rät ausdrücklich von sudo npm install -g ab, da dies zu Berechtigungsproblemen und Sicherheitsrisiken führt, und weist darauf hin, dass sich eine Installation, die sudo benötigt, nicht selbst aktualisieren kann. Das native Skript vermeidet dieses Problem.
macOS, Linux, Windows (npm, Node.js 22+)
npm install -g @anthropic-ai/claude-code@latest

#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.

macOS, Linux, Windows
claude --version
claude doctor

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.

  1. 01
    In ein Projekt wechseln
    Wechseln 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.
  2. 02
    Claude Code starten
    Geben 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.
  3. 03
    Eine erste Frage stellen
    Nach 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.
  4. 04
    Projekt vorbereiten
    Geben 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.

macOS, Linux, WSL (native Deinstallation)
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

#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.

Installationsfehler bei Claude Code und ihre Behebung (Anthropic-Leitfaden zur Fehlerbehebung, 18. November 2026)
Angezeigte MeldungUrsacheKorrekturmaßnahme
command not found: claude / 'claude' is not recognizedInstallationsordner 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 separatorIn PowerShell eingefügter CMD-BefehlDen PowerShell-Befehl verwenden
'irm' is not recognized as an internal or external commandPowerShell-Befehl in CMD eingefügtCMD-Befehl verwenden
curl: (22) The requested URL returned error: 403Proxy oder Netzwerkfilter, oder nicht unterstütztes LandNetzwerk oder Unternehmens-Proxy überprüfen
App unavailable in regionVon Anthropic nicht unterstütztes LandClaude Code ist in diesem Land nicht verfügbar
not found unter Alpinebash ou curl absentsapk add bash curl
macOS (zsh): ~/.local/bin zum PATH hinzufügen
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Windows (PowerShell): den Ordner zum Benutzer-PATH hinzufügen
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

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.

i
Ohne Terminal: die Desktop-App
Die Dokumentation von Anthropic bietet außerdem die Claude-Desktop-App an, mit der Sie Claude Code ohne Terminal nutzen können, unter macOS, Windows und Linux (Betaversion unter Linux). Sie erfordert dieselbe Anmeldung mit einem kostenpflichtigen Claude-Konto.

#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.

macOS, Linux, Windows (Ollama installiert)
ollama launch claude

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.

macOS, Linux (Bash oder Zsh)
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3.5
!
Von Anthropic nicht unterstützte Konfiguration
Laut der Dokumentation von Claude Code unterstützt Anthropic die Nutzung von Claude Code mit anderen Modellen als Claude über ein Gateway nicht. Die Anbindung an Ollama funktioniert laut der Dokumentation von Ollama, ein Problem fällt jedoch in die Zuständigkeit von Ollama, nicht in die des Anthropic-Supports. Die Qualität hängt stark vom lokalen Modell und vom verfügbaren Arbeitsspeicher ab.
Häufig gestellte Fragen
Ist Claude Code kostenlos?+
Das Programm Claude Code lässt sich kostenlos installieren, seine Nutzung mit den Claude-Modellen erfordert jedoch ein kostenpflichtiges Abonnement (Pro, Max, Ultra, Team, Enterprise) oder ein nutzungsbasiert abgerechnetes Console-Konto. Laut der am 18. November 2026 eingesehenen Dokumentation von Anthropic enthält der kostenlose Plan von claude.ai kein Claude Code. Die Anbindung an ein lokales Modell über Ollama ersetzt die Claude-Modelle durch ein Modell auf Ihrem Rechner, außerhalb des Supports von Anthropic.
Wird Node.js für die Installation von Claude Code benötigt?+
Nein, Node.js ist für die Installation von Claude Code mit dem nativen Skript, Homebrew, WinGet oder den Linux-Repositorys nicht mehr erforderlich. Nur die npm-Methode benötigt Node.js 22 oder höher, und laut Dokumentation ist das installierte Programm ein natives Binary, das Node.js zur Laufzeit nicht verwendet. Das native Skript bleibt die empfohlene Methode.
Benötigen Sie Administratorrechte, um Claude Code unter Windows zu installieren?+
Nein. Laut der Dokumentation von Anthropic wird der Installationsbefehl von Claude Code in PowerShell oder CMD ausgeführt, ohne das Terminal als Administrator zu starten. Das Programm wird im Benutzerordner unter %USERPROFILE%\.local\bin installiert.
Wie installiert man ein Plugin in Claude Code?+
In einer Claude-Code-Sitzung öffnet der Befehl /plugin ein Panel, das die Plugins der konfigurierten Kataloge auflistet, und /plugin install, gefolgt von Name und Katalog, zum Beispiel commit-commands@claude-plugins-official, öffnet vor der Installation die Detailseite des Plugins. Die Dokumentation von Anthropic weist darauf hin, dass ein Plugin Hooks und MCP-Server ausführen kann: Lesen Sie seine Detailseite, bevor Sie es installieren.
Wie konfiguriert man Claude Code nach der Installation richtig?+
Führen Sie nach der Installation von Claude Code in Ihrem Projekt /init aus, um eine Datei CLAUDE.md zu erzeugen, die die Build- und Testbefehle sowie die Konventionen beschreibt. Die Einstellungen ändern Sie mit /config oder in der Datei ~/.claude/settings.json. Der Befehl claude doctor meldet ungültige Einstellungsdateien und Installationsprobleme.
Funktioniert Claude Code offline?+
Nein. Laut der Dokumentation von Anthropic ist für die Nutzung von Claude Code eine Internetverbindung zwingend erforderlich, da die Claude-Modelle auf den Servern von Anthropic laufen. Mit Ollama und einem lokalen Modell bleiben die Anfragen an das Modell auf dem Rechner, die Dokumentation von Anthropic beschreibt jedoch keinen vollständigen Offline-Betrieb: Betrachten Sie diesen Punkt als nicht garantiert.
Wie aktualisiert man Claude Code?+
Eine native Installation von Claude Code aktualisiert sich selbst, beim Start und im Hintergrund, und claude update erzwingt die sofortige Aktualisierung. Standardmäßig aktualisieren sich Installationen über Homebrew, WinGet, apt, dnf und apk nicht selbst: Verwenden Sie brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode oder die Systemaktualisierung von Linux. Bei Homebrew und WinGet überträgt die Variable CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 diese Aktualisierung an 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.

Hat Ihnen dieser Guide geholfen?

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.