Zum Hauptinhalt springen
Zurück zum Blog
Claude CodeInstallationKI-AgentenAnthropicAnleitung

Claude Code installieren: macOS, Linux und Windows in fünf Minuten

Ulrich Diedrichsen
Ulrich Diedrichsen
••7 Min. Lesezeit

Ein Befehl im Terminal, dann einmal anmelden: So installierst du Claude Code auf macOS, Linux und Windows, prüfst die Installation, meldest dich mit Abo oder API-Schlüssel an und behebst die häufigsten Fehler. Alle Befehle aus der offiziellen Doku, Stand 20.11.2026.

„Claude Code installieren“ wird gerade sehr oft gesucht. Die kurze Antwort: ein Befehl im Terminal, dann einmal anmelden.

macOS, Linux und WSL:

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

Windows PowerShell:

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

Windows Eingabeaufforderung (CMD):

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

Danach ein neues Terminalfenster öffnen und prüfen:

claude --version

Kommt eine Versionsnummer, ist Claude Code installiert. Weiter unten steht, wie du dich anmeldest und was du tust, wenn der Befehl nicht gefunden wird.

Quelle und Stand: Alle Befehle und Voraussetzungen in diesem Beitrag stammen aus Anthropics offizieller Doku, abgerufen am 20. November 2026: Advanced setup, Quickstart, Authentication und Troubleshoot installation. Anthropic ändert Claude Code sehr häufig. Wenn etwas abweicht, gilt die Doku.


Voraussetzungen

WasMindestens
macOS13.0
Windows10 (Version 1809) oder Windows Server 2019
LinuxUbuntu 20.04, Debian 10 oder Alpine Linux 3.19
Hardware4 GB Arbeitsspeicher, x64- oder ARM64-Prozessor
ShellBash, Zsh, PowerShell oder CMD
NetzInternetverbindung, Land von Anthropic unterstützt
KontoPro, Max, Ultra, Team, Enterprise oder Claude Console

Den kostenlosen Claude-Plan kannst du nicht nutzen, er enthält kein Claude Code. Was die Pläne kosten und wie ihre Limits funktionieren, steht in Was kostet Claude Code?.

Node.js brauchst du nicht. Der native Installer bringt alles mit. Node.js 22 oder neuer ist nur nötig, wenn du ausdrücklich über npm installierst (siehe unten).

Auf Alpine Linux fehlen bash und curl anfangs. Die Doku nennt dafür:

apk add bash curl

Installieren: welcher Weg?

Anthropic empfiehlt den nativen Installer von oben. Er aktualisiert sich selbst im Hintergrund. Daneben gibt es Paketmanager, die sich standardmäßig nicht selbst aktualisieren:

WegBefehlAktualisieren
Nativ (empfohlen)siehe obenautomatisch
Homebrew (macOS, Linux)brew install --cask claude-codebrew upgrade claude-code
WinGet (Windows)winget install Anthropic.ClaudeCodewinget upgrade Anthropic.ClaudeCode
npmnpm install -g @anthropic-ai/claude-code@latestdenselben Befehl erneut

Bei Homebrew gibt es zwei Varianten: claude-code folgt dem stabilen Kanal, der laut Doku meist rund eine Woche hinter der neuesten Version liegt. claude-code@latest bekommt jede neue Version sofort. Für Debian, Ubuntu, Fedora, RHEL und Alpine gibt es außerdem signierte apt-, dnf- und apk-Quellen, beschrieben in der Setup-Doku.

Zwei Warnungen aus der Doku zu npm: kein sudo npm install -g, und zum Aktualisieren nicht npm update -g, weil das unter Umständen nicht auf die neueste Version springt.

Der Installer zeigt beim Herunterladen keinen Fortschritt. Das ist normal.

Windows: nativ oder WSL?

Beides geht. Nativ installierst du aus PowerShell oder CMD, ohne Administratorrechte. Git for Windows ist optional: Ist es da, führt Claude Code Befehle über Git Bash aus, sonst über PowerShell.

WSL lohnt sich, wenn deine Projekte ohnehin unter Linux laufen oder du die Sandbox brauchst, denn die gibt es laut Doku nur unter WSL 2, nicht unter nativem Windows. In WSL installierst du mit dem Linux-Befehl und startest claude im WSL-Terminal, nicht aus PowerShell.

Woran du erkennst, wo du bist: In PowerShell beginnt die Zeile mit PS C:\, in CMD nur mit C:\.


Prüfen, ob alles läuft

claude --version
claude doctor

claude --version zeigt die Version. claude doctor prüft Installation und Einstellungen, ohne eine Sitzung zu starten, und nennt Warnungen mit Vorschlägen, wie man sie behebt.


Anmelden: Abo oder API-Schlüssel

Es gibt zwei übliche Wege, und sie rechnen unterschiedlich ab:

  • Abo (Pro, Max, Ultra, Team, Enterprise): Du meldest dich mit deinem Claude-Konto an. Die Nutzung läuft über das Kontingent deines Plans.
  • Claude Console: Abrechnung nach Verbrauch, pro Token. Das passt eher für Firmen mit eigener Kostenstelle oder für Skripte.

Die Anmeldung startet beim ersten Aufruf von selbst. Du folgst den Schritten im Browser, Claude Code speichert die Anmeldung danach (auf dem Mac im Schlüsselbund, unter Linux und Windows in .claude/.credentials.json im Benutzerordner). Später wechselst du das Konto mit /login innerhalb der Sitzung.

Achtung, API-Schlüssel: Ist auf deinem Rechner die Umgebungsvariable ANTHROPIC_API_KEY gesetzt und bestätigst du die Frage, ob Claude Code ihn verwenden soll, nutzt Claude Code den Schlüssel statt deines Abos. Laut Doku steht ein solcher Schlüssel in der Rangfolge vor der Abo-Anmeldung. Dann zahlst du nach Verbrauch, obwohl du ein Abo hast. Mit /status siehst du in der Sitzung, welche Anmeldung gerade gilt. Wie mir eine Variante davon passiert ist, steht im Kostenbeitrag.


Der erste Start im Projekt

Wechsle in den Ordner deines Projekts und starte Claude Code:

cd /pfad/zu/deinem/projekt
claude

Claude Code öffnet eine Sitzung im Terminal und arbeitet in diesem Ordner. Gute erste Fragen aus dem Quickstart:

what does this project do?
what technologies does this project use?

Du kannst auch auf Deutsch fragen. Hilfreiche Befehle für den Anfang:

BefehlWas er tut
/helpzeigt die verfügbaren Befehle
/statuszeigt Anmeldung und Abrechnung
/clearbeginnt ein neues Gespräch
/exitbeendet Claude Code
claude -csetzt das letzte Gespräch in diesem Ordner fort
Shift+Tabwechselt, was Claude Code ohne Nachfrage tun darf

Welche Aktionen Claude Code ohne Rückfrage ausführen darf, legt der sogenannte Berechtigungsmodus fest. Mit Shift+Tab wechselst du ihn jederzeit, die Modi beschreibt die Doku unter Permission modes.


Typische Fehler und was hilft

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

Die häufigste Meldung. Die Installation hat geklappt, aber der Ordner ~/.local/bin (Windows: %USERPROFILE%\.local\bin) steht nicht in deinem PATH. Der Installer weist darauf unter „Setup notes“ hin, ändert den PATH aber nicht selbst.

Mac mit Zsh:

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

Linux mit Bash:

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

Windows PowerShell:

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

Danach ein neues Terminal öffnen. Läuft das Terminal in einem Editor wie VS Code, den Editor einmal ganz schließen und neu öffnen.

irm is not recognized oder The token '&&' is not a valid statement separator

Falscher Befehl für die Shell. irm gehört in PowerShell, die Zeile mit && in CMD.

syntax error near unexpected token '<'

Statt des Installationsskripts kam eine Webseite zurück. Die Doku nennt als Ursachen vor allem Proxys, Netzfilter oder ein Land, in dem Claude Code nicht angeboten wird. Ein 403 hat meist dieselben Gründe.

App unavailable in region

Claude Code wird in deinem Land nicht angeboten. Die Liste steht bei Anthropic.

EACCES: permission denied

Der Installationsordner gehört nicht deinem Benutzer. Die Doku beschreibt die Prüfung und Korrektur unter Check directory permissions.

claude startet nach der Deinstallation immer noch

Dann gibt es eine zweite Installation, etwa über npm oder Homebrew. which -a claude (Windows: where.exe claude) zeigt alle Fundstellen.

Für alle übrigen Meldungen hat Anthropic eine Tabelle „Find your error“ in der Fehlerseite. Dort die Meldung suchen, nicht raten.


Aktualisieren

Die native Installation prüft beim Start und im Betrieb auf Updates und spielt sie im Hintergrund ein. Wirksam werden sie beim nächsten Start. Sofort aktualisieren:

claude update

Wer lieber etwas ältere, erprobte Versionen will, stellt in /config den Kanal auf „stable“. Für Homebrew, WinGet und npm gelten die Befehle aus der Tabelle oben.


Deinstallieren

Native Installation unter macOS, Linux und WSL:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Unter Windows PowerShell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Paketmanager: brew uninstall --cask claude-code, winget uninstall Anthropic.ClaudeCode oder npm uninstall -g @anthropic-ai/claude-code.

Einstellungen, erlaubte Werkzeuge, MCP-Server und Gesprächsverlauf liegen getrennt in ~/.claude und ~/.claude.json. Die löschst du nur, wenn du wirklich alles entfernen willst, denn sie sind danach weg. Die VS-Code-Erweiterung, das JetBrains-Plugin und die Desktop-App schreiben ebenfalls dorthin und legen den Ordner wieder an, solange sie installiert sind.


Und danach?

Installiert ist Claude Code in fünf Minuten. Die eigentlichen Fragen kommen danach:


Zum Mitnehmen

  1. Ein Befehl installiert Claude Code: curl -fsSL https://claude.ai/install.sh | bash auf macOS und Linux, irm https://claude.ai/install.ps1 | iex in Windows PowerShell.
  2. Node.js brauchst du nur für den npm-Weg.
  3. Ohne bezahlten Plan oder Console-Konto läuft Claude Code nicht.
  4. Ein gesetzter ANTHROPIC_API_KEY kann dein Abo überstimmen. /status zeigt, was gilt.
  5. Wird claude nicht gefunden, fehlt ~/.local/bin im PATH.

Häufige Fragen

Ist Claude Code kostenlos?

Das Programm selbst kostet nichts, die Nutzung schon. Laut Anthropic brauchst du ein Pro-, Max-, Ultra-, Team- oder Enterprise-Abo oder ein Konto in der Claude Console mit Abrechnung nach Verbrauch. Der kostenlose Claude-Plan enthält Claude Code nicht.

Brauche ich Node.js, um Claude Code zu installieren?

Nein. Der empfohlene native Installer bringt alles mit. Node.js 22 oder neuer brauchst du nur, wenn du bewusst über npm installierst.

Wie installiere ich Claude Code unter Windows?

In PowerShell mit irm https://claude.ai/install.ps1 | iex, in der Eingabeaufforderung (CMD) mit curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Administratorrechte brauchst du nicht. Git for Windows ist optional; ohne es nutzt Claude Code PowerShell für Befehle.

Was tun bei „command not found: claude“?

Der Installationsordner ~/.local/bin (Windows: %USERPROFILE%\.local\bin) steht nicht in deinem PATH. Auf dem Mac mit Zsh hilft echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc und danach source ~/.zshrc. Dann ein neues Terminal öffnen und claude --version prüfen.

Wie aktualisiere ich Claude Code?

Die native Installation aktualisiert sich selbst im Hintergrund. Sofort geht es mit claude update. Homebrew-, WinGet- und Linux-Paketinstallationen aktualisieren sich standardmäßig nicht; dort nimmst du den Befehl des Paketmanagers, etwa brew upgrade claude-code.

Wie deinstalliere ich Claude Code vollständig?

Bei der nativen Installation unter macOS und Linux mit rm -f ~/.local/bin/claude und rm -rf ~/.local/share/claude. Einstellungen und Verlauf liegen getrennt in ~/.claude und ~/.claude.json; die löschst du nur, wenn du wirklich alles entfernen willst.

Tags:

Claude CodeInstallationKI-AgentenAnthropicAnleitung
Ulrich Diedrichsen

Ulrich Diedrichsen

Softwarearchitekt & Produktentwickler

Softwareentwicklung seit dem Informatikstudium. Ex-IBM, Ex-PwC. Baut heute mit KI Produkte in Hamburg.