Claude Code installieren 2026 (macOS, Windows, Linux, npm): Schritt-für-Schritt-Anleitung

Um Claude Code zu installieren, führen Sie den nativen Installer von Anthropic in einem Terminal aus (ein Befehl für macOS, Linux und WSL, einer für Windows PowerShell und einer für Windows CMD; alle drei stehen unten), starten dann Claude Code in Ihrem Projektordner und melden sich im Browser an. Sie brauchen einen Claude-Plan Pro, Max, Team oder Enterprise, ein Claude-Console-(API-)Konto oder Zugang über Amazon Bedrock, die Agent Platform von Google Cloud oder Microsoft Foundry, denn der kostenlose Claude-Plan enthält kein Claude Code. Node.js ist nur nötig, wenn Sie die npm-Methode wählen.

Dieser Guide behandelt jede offizielle Installationsmethode, die Prüfung der Installation, die erste Anmeldung, Besonderheiten von Windows und Alpine sowie Lösungen für die Fehler, die die Troubleshooting-Seite von Anthropic am häufigsten nennt. Alle Befehle wurden am 17. Oktober 2026 mit der Claude-Code-Dokumentation von Anthropic abgeglichen.

Vor der Installation: Konto und Systemanforderungen

Welches Konto Sie brauchen

Wenn Sie nicht sicher sind, ob ein kostenloser Plan reicht, erklärt unser Guide Ist Claude kostenlos?, was das kostenlose Angebot abdeckt. Studierende und Open-Source-Maintainer sollten vor dem Bezahlen die Seiten zu Claude-Angeboten für Studierende und Claude for Open Source prüfen.

Systemanforderungen

• Betriebssystem: macOS 13.0+, Windows 10 1809+ oder Windows Server 2019+, Ubuntu 20.04+, Debian 10+ oder Alpine Linux 3.19+
• Hardware: 4 GB+ RAM, x64- oder ARM64-Prozessor (32-Bit-Windows wird nicht unterstützt)
• Shell: Bash, Zsh, PowerShell oder CMD
• Netzwerk und Standort: eine Internetverbindung, in einem von Anthropic unterstützten Land
• ripgrep: in der Regel in Claude Code enthalten; unter Alpine muss es separat installiert werden (siehe unten)

Schritt 1: Installationsmethode wählen

Für die meisten ist der native Installer die richtige Wahl. Anthropic empfiehlt ihn, er hält sich selbst aktuell und braucht keine weitere Software. Paketmanager sind sinnvoll, wenn Ihr Team Tools ohnehin so verwaltet oder Sie Updates nach eigenem Zeitplan einspielen möchten.

Schritt 2: Den nativen Installer ausführen

Öffnen Sie ein Terminal und führen Sie den einen Befehl für Ihr System aus.

macOS, Linux und WSL

curl -fsSL https://claude.ai/install.sh | bash

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

Unter Windows zeigt die Eingabeaufforderung in PowerShell PS C:\ und in CMD C:\ ohne PS. Sehen Sie „The token '&&' is not a valid statement separator“, sind Sie in PowerShell und sollten den PowerShell-Befehl verwenden. Sehen Sie „'irm' is not recognized“, sind Sie in CMD.

Der Installer zeigt beim Herunterladen keinen Fortschritt an, warten Sie also, bis er fertig ist. Unter macOS und Linux legt er den claude-Launcher unter ~/.local/bin/claude ab und speichert Versionen unter ~/.local/share/claude/versions/. Unter Windows landet das Programm in %USERPROFILE%\.local\bin\claude.exe. Administratorrechte brauchen Sie nicht.

Stattdessen den Stable-Kanal installieren

Standardmäßig erhalten Sie den Kanal latest, der neue Releases sofort ausliefert. Der Kanal stable liefert eine Version, die meist etwa eine Woche alt ist, und überspringt Releases mit gravierenden Regressionen. Der bei der Installation gewählte Kanal wird zum Standard für automatische Updates. macOS, Linux und WSL:

curl -fsSL https://claude.ai/install.sh | bash -s stable

Windows PowerShell:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd

Statt stable können Sie auch eine bestimmte Versionsnummer übergeben. Unser Update-Guide behandelt das Festlegen von Versionen, den späteren Kanalwechsel und das Zurückrollen.

Weitere offizielle Installationsmethoden

Homebrew (macOS und Linux)

brew install --cask claude-code

Der Cask claude-code folgt dem Stable-Kanal. Um neue Releases sofort zu erhalten, installieren Sie stattdessen den Latest-Cask:

brew install --cask claude-code@latest

WinGet (Windows)

winget install Anthropic.ClaudeCode

apt (Debian und Ubuntu)

Anthropic veröffentlicht signierte apt-, dnf- und apk-Repositorys. Diese Befehle richten den Stable-Kanal ein. Zuerst, falls curl oder gpg auf einem frischen System fehlen:

sudo apt install curl gnupg

Laden Sie den Signaturschlüssel herunter:

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc

Prüfen Sie den Schlüssel, bevor Sie ihm vertrauen. Der Fingerabdruck sollte 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE lauten:

gpg --show-keys /etc/apt/keyrings/claude-code.asc

Registrieren Sie das Repository und installieren Sie:

echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

dnf (Fedora und RHEL)

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

dnf fordert Sie bei der ersten Installation auf, den Fingerabdruck des Schlüssels zu bestätigen. Er sollte 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE entsprechen.

apk (Alpine Linux)

wget -O /etc/apk/keys/claude-code.rsa.pub \
  https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

npm

Das npm-Paket erfordert Node.js 22 oder neuer. Bei einer älteren Node.js-Version gibt npm eine EBADENGINE-Warnung aus, die Installation wird aber trotzdem abgeschlossen:

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

Das npm-Paket installiert dieselbe native Binärdatei wie der eigenständige Installer, eingebunden über eine plattformspezifische optionale Abhängigkeit, und der installierte claude-Befehl nutzt Node zur Laufzeit nicht. Unterstützte npm-Plattformen sind darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 und win32-arm64, und Ihr Paketmanager muss optionale Abhängigkeiten zulassen.

Verwenden Sie bei einer globalen npm-Installation kein sudo. Anthropic warnt, dass das zu Berechtigungsproblemen und Sicherheitsrisiken führen kann. Wenn Berechtigungsfehler auftreten, wechseln Sie zum nativen Installer oder folgen Sie der offiziellen Troubleshooting-Seite.

Schritt 3: Die Installation prüfen

Öffnen Sie ein neues Terminalfenster (das alte behält seinen alten PATH) und führen Sie aus:

claude --version

Eine funktionierende Installation gibt eine Versionsnummer gefolgt von (Claude Code) aus. Meldet Ihre Shell, dass claude nicht gefunden wird, liegt das Installationsverzeichnis noch nicht in Ihrem PATH; die Lösung steht im Abschnitt zur Fehlerbehebung unten. Für einen ausführlicheren, rein lesenden Gesundheitscheck ohne Sitzungsstart, der auch Fehler und Warnungen in Einstellungsdateien samt Lösungsvorschlägen meldet, führen Sie aus:

claude doctor

Schritt 4: Claude Code starten und anmelden

Wechseln Sie in Ihren Projektordner und starten Sie eine Sitzung:

cd /path/to/your/project
claude

Beim ersten Start öffnet Claude Code ein Browserfenster zur Anmeldung. Öffnet sich der Browser nicht, drücken Sie c, um die Anmelde-URL zu kopieren, und fügen Sie sie in einen Browser ein. Nach der Anmeldung zeigt das Terminal Login successful an und bittet Sie, Enter zu drücken. Diese Konten funktionieren:

• Claude Pro, Max, Team oder Enterprise: Melden Sie sich mit Ihrem claude.ai-Konto an. Die Nutzung zählt zu den Limits Ihres Plans.
• Claude Console: nutzungsbasierte API-Abrechnung. Wenn Sie der Console-Organisation einer anderen Person beitreten, muss ein Admin Sie zuerst einladen. Bei der ersten Anmeldung legt Claude Code in der Console einen Workspace „Claude Code“ zur Kostenverfolgung an.
• Amazon Bedrock, Agent Platform von Google Cloud oder Microsoft Foundry: Setzen Sie die Umgebungsvariablen des Anbieters oder wählen Sie bei der Anmeldeaufforderung 3rd-party platform (Drittanbieterplattform). Eine Browser-Anmeldung ist nicht nötig.

Ist ANTHROPIC_API_KEY gesetzt und stimmen Sie bei der Nachfrage zu, überspringt Claude Code die Browser-Anmeldung und rechnet über Ihre API-Credits ab; unser Guide zum Anthropic-API-Key erklärt, wie Sie einen Key erstellen und Guthaben aufladen. Um später das Konto zu wechseln, geben Sie in einer Sitzung ein:

/login

Anmeldung über SSH, in WSL2 oder in einem Container

Hier öffnet sich der Browser meist auf einem anderen Rechner und kann nicht zu Claude Code zurückleiten. Nach der Anmeldung zeigt der Browser stattdessen einen Anmeldecode an; fügen Sie ihn bei der Aufforderung Paste code here if prompted ein. Funktioniert das Einfügen dort nicht, melden Sie sich mit diesem Befehl an, der den eingefügten Code von der Standardeingabe liest:

claude auth login

Öffnet sich der Browser aus WSL2 überhaupt nicht, lassen Sie die Variable BROWSER auf Ihren Windows-Browser zeigen, zum Beispiel:

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

Eine erste Aufgabe ausprobieren

Der Quickstart von Anthropic empfiehlt, mit Fragen zu Ihrem Code in natürlicher Sprache zu beginnen. Geben Sie Prompts wie diese in Claude Code ein:

what does this project do?
where is the main entry point?
add a hello world function to the main file

Claude Code liest Dateien nach Bedarf und fragt je nach Berechtigungsmodus der Sitzung nach, bevor es Änderungen vornimmt (mit Shift+Tab wechseln Sie den Modus). Für größere Änderungen siehe unseren Guide zum Plan Mode von Claude Code.

Claude Code unter Windows installieren

Sie können Claude Code nativ unter Windows oder in WSL ausführen:

• Sie müssen den Installer nicht als Administrator ausführen.
• Ohne Git for Windows führt Claude Code Shell-Befehle über sein PowerShell-Tool aus. Ist es installiert, kann Claude Code für sein Bash-Tool auch Git Bash nutzen.
• Für WSL öffnen Sie Ihre WSL-Distribution und führen dort den Linux-Installer aus. Installieren und starten Sie claude innerhalb von WSL, nicht aus PowerShell oder CMD.
• Wenn eine ältere Claude-Desktop-Installation dazu führt, dass der Befehl claude die Desktop-App statt der CLI öffnet, aktualisieren Sie Claude Desktop auf die neueste Version.

Findet Claude Code Git Bash nicht, setzen Sie den Pfad in Ihrer settings.json-Datei:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Installation unter Alpine und anderen musl-basierten Linux-Systemen

Der Installationsbefehl braucht bash und curl, und Claude Code braucht zur Laufzeit libgcc, libstdc++ und ripgrep. Alpine enthält bash und curl standardmäßig nicht, installieren Sie die Pakete also zuerst:

apk add bash curl libgcc libstdc++ ripgrep

ripgrep liegt im Community-Repository von Alpine; fügen Sie es zu /etc/apk/repositories hinzu, falls apk das Paket nicht findet. Weisen Sie Claude Code dann in settings.json an, das System-ripgrep zu nutzen:

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

Probleme bei der Installation beheben

Das sind die Probleme, die die Troubleshooting-Seite zur Installation von Anthropic am häufigsten behandelt, mit den offiziellen Lösungen.

„command not found: claude“ oder „'claude' is not recognized“

Die Installation hat funktioniert, aber ihr Ordner liegt nicht in Ihrem PATH. Öffnen Sie zuerst ein neues Terminal. Schlägt es unter macOS oder Linux weiterhin fehl, prüfen Sie, ob die Datei existiert:

ls -la ~/.local/bin/claude

Wenn ja, fügen Sie den Ordner zu Ihrem PATH hinzu. Für Zsh, den macOS-Standard:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Für Bash unter Linux:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Für Bash unter macOS verwenden Sie ~/.bash_profile statt ~/.bashrc, weil Terminal Bash als Login-Shell startet. In Windows PowerShell fügen Sie den Installationsordner zu Ihrem Benutzer-PATH hinzu und starten das Terminal neu:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Ein Terminal in einem Editor wie VS Code übernimmt den PATH vom Editor, beenden und öffnen Sie also auch den Editor neu. Beachten Sie, dass die VS-Code-Erweiterung ihre eigene private Kopie von Claude Code mitbringt und claude nicht in Ihren PATH legt; führen Sie den eigenständigen Installer aus, wenn Sie den Befehl im Terminal nutzen möchten.

„syntax error near unexpected token '<'“ oder ein 403 vom Installer

Die Installations-URL hat statt des Skripts eine Webseite oder einen Fehler zurückgegeben. Erwähnt die Ausgabe App unavailable in region, ist Claude Code in Ihrem Land nicht verfügbar. Andernfalls handelt es sich oft um ein vorübergehendes Problem, einen Proxy oder eine Firewall oder regionales Routing. Versuchen Sie es nach einigen Minuten erneut, prüfen Sie, ob Sie den Download-Server erreichen, oder nutzen Sie stattdessen Homebrew oder WinGet. So testen Sie die Verbindung unter macOS oder Linux:

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Eine erste Zeile mit Status 200 bedeutet, dass Sie den Server erreicht haben. Hinter einem Unternehmensproxy setzen Sie HTTP_PROXY und HTTPS_PROXY auf die Adresse Ihres Proxys, bevor Sie den Installer ausführen.

„Killed“ bei der Installation auf einem kleinen Linux-Server

Der Out-of-Memory-Killer hat die Installation beendet. Laut Anthropic braucht die Installation etwa 512 MB freien Speicher, und Claude Code benötigt zum Laufen mindestens 4 GB RAM. Schließen Sie andere Prozesse, nutzen Sie eine größere Instanz oder fügen Sie Swap-Speicher hinzu und versuchen Sie es erneut:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

Installation hängt in Docker

Wird der Installer als root von / aus gestartet, durchsucht er das gesamte Dateisystem. Setzen Sie zuerst ein Arbeitsverzeichnis:

WORKDIR /tmp
RUN curl -fsSL https://claude.ai/install.sh | bash

TLS- oder SSL-Fehler

Fehler wie curl: (35) TLS connect error oder Could not create SSL/TLS secure channel in PowerShell bedeuten, dass die sichere Verbindung fehlgeschlagen ist. Unter Ubuntu oder Debian aktualisieren Sie Ihre CA-Zertifikate:

sudo apt-get update && sudo apt-get install ca-certificates

In Windows PowerShell 5.1 aktivieren Sie TLS 1.2 im selben Fenster, bevor Sie den Installer ausführen:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Hinter einem Unternehmensproxy, der TLS prüft, bitten Sie die IT um das CA-Zertifikat des Proxys und lassen NODE_EXTRA_CA_CERTS darauf zeigen, sobald Claude Code installiert ist.

Homebrew meldet, dass der Cask nicht verfügbar ist

Ihr lokaler Homebrew-Index ist älter als der Cask. Aktualisieren Sie ihn und versuchen Sie es erneut:

brew update
brew install --cask claude-code

npm: „claude native binary not installed“ oder deaktivierte Skripte

Das npm-Paket liefert die eigentliche Binärdatei als optionale Abhängigkeit und verknüpft sie in einem postinstall-Schritt. Haben Sie mit --omit=optional oder --ignore-scripts installiert (oder mit einem pnpm-Setup, das diese überspringt), installieren Sie ohne diese Optionen neu. Unter Windows stammt „running scripts is disabled on this system“ von der PowerShell-Ausführungsrichtlinie, die die .ps1-Shims von npm blockiert; erlauben Sie lokal erstellte Skripte für Ihren Benutzer oder nutzen Sie stattdessen den nativen Installer:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Nach der Installation läuft weiterhin eine alte Version

Vermutlich haben Sie zwei Installationen, etwa eine alte npm-Installation und eine neue native. Listen Sie unter macOS oder Linux jedes claude in Ihrem PATH auf:

which -a claude

Behalten Sie eine (Anthropic empfiehlt die native Installation) und entfernen Sie die anderen, zum Beispiel die npm-Kopie:

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

Probleme bei der Anmeldung

• API Error: 403 Request not allowed nach der Anmeldung: Prüfen Sie bei Pro oder Max in den claude.ai-Einstellungen, ob Ihr Abo aktiv ist. Bei Console-Konten muss Ihnen ein Admin auf der Members-Seite die Rolle Claude Code oder Developer geben.
• OAuth error: Invalid code: Der Code ist abgelaufen oder wurde abgeschnitten. Versuchen Sie es erneut und schließen Sie zügig ab, oder drücken Sie c, um die vollständige URL zu kopieren.
• „This organization has been disabled“ trotz aktivem Abo: Ein alter ANTHROPIC_API_KEY in Ihrem Shell-Profil überschreibt Ihre Anmeldung. Entfernen Sie ihn aus dem Profil und heben Sie ihn auf (der Befehl steht in unserem Guide zum API-Key).
• Wiederholt abgemeldet: Prüfen Sie, ob Ihre Systemuhr korrekt geht, denn die Token-Validierung hängt davon ab, und melden Sie sich erneut an.

Für einen sauberen Neustart der Anmeldung geben Sie dies in Claude Code ein, schließen es, führen dann erneut claude aus und melden sich an:

/logout

Lieber ohne Terminal?

Anthropic bietet Claude Code auch als Desktop-App für macOS, Windows und Linux, im Web unter claude.ai/code sowie als Erweiterungen für VS Code und JetBrains-IDEs an. Sie brauchen trotzdem einen berechtigten bezahlten Plan oder ein Console-Konto. Wie Sie die Kommandozeilenversion später aktuell halten, lesen Sie unter Claude Code aktualisieren.