Claude Code installieren: ein Befehl, vier Stolperstellen

Die Installation von Claude Code ist ein einziger Befehl, und sie ist nicht dein Problem. Wir haben sie am 30. September 2026 in einem frisch aufgesetzten Ubuntu 24.04 gemessen: 16,6 Sekunden vom Befehl bis zur fertigen Meldung, Rückgabewert 0, Version 2.1.285.

Die kurze Antwort: Nimm den nativen Installer für dein System, öffne danach ein NEUES Terminalfenster und prüfe mit claude --version. Was Leute tatsächlich aufhält, kommt danach und besteht aus vier Dingen: der PATH, die Frage nach Administratorrechten unter Windows, die Node-Version beim npm-Weg und das Abo, das du brauchst. Drei davon werden in den meistgelesenen deutschsprachigen Anleitungen falsch beantwortet.

Wie installierst du Claude Code?

Mit einem Befehl, der sich nur nach deinem System unterscheidet. Der native Installer ist der von Anthropic empfohlene Weg, weil er sich danach selbst aktualisiert.

Alle fünf Varianten stehen so in Anthropics Einrichtungsdokumentation. Ein Unterschied ist wichtig genug, um ihn vor der Wahl zu kennen: die native Installation aktualisiert sich im Hintergrund selbst, Homebrew und WinGet nicht. Wer über einen Paketmanager installiert, aktualisiert später von Hand mit brew upgrade claude-code oder winget upgrade Anthropic.ClaudeCode.

Zwei Fehlermeldungen beim Einfügen bedeuten nur, dass du in der falschen Shell bist. Sagt Windows The token '&&' is not a valid statement separator, sitzt du in PowerShell und hast den CMD-Befehl genommen. Sagt es 'irm' is not recognized as an internal or external command, ist es umgekehrt. Deine Eingabeaufforderung zeigt PS C:\ in PowerShell und C:\ ohne PS in CMD.

Was passiert bei der Installation wirklich?

Ein Download, eine Datei und eine Zeile in deiner Shell-Konfiguration. Wir haben den dokumentierten Befehl in einem leeren Container ausgeführt und danach nachgesehen, was auf der Platte steht.

Das Installationsskript selbst ist 9.704 Bytes groß. Es lädt eine einzige Binärdatei von 240.327.864 Bytes, also rund 229 MiB, und legt sie unter ~/.local/share/claude/versions/2.1.285 ab. Darauf zeigt ein Symlink von ~/.local/bin/claude. Danach schreibt der Installer in drei Dateien je eine Zeile, .bashrc, .profile und .zshrc, und zwar immer dieselbe:

. "$HOME/.local/bin/env"

Mehr ist es nicht. Keine Systemverzeichnisse, keine erhöhten Rechte, kein Dienst im Hintergrund. Genau deshalb braucht die Installation auch keine Minute.

Dauer der Installation, gemessen

Je ein Lauf auf einer Maschine. Für einen Vergleich der beiden Wege ist das zu wenig; was es zeigt, ist die Größenordnung. Beide Wege liefern dieselbe Binärdatei.

Dauer der Installation, gemessen

Nativer Installer	16.6 s
npm install -g	6.5 s

Der Punkt dieser Zahlen ist nicht, welcher Weg schneller ist. Der Punkt ist, dass der Schritt, um den sich die meisten Anleitungen drehen, unter einer halben Minute abgeschlossen ist. Die Zeit geht anderswo verloren.

Warum findet dein Terminal claude danach nicht?

Weil deine Shell die Zeile, die der Installer geschrieben hat, erst beim nächsten Start liest. Das ist die häufigste Stolperstelle nach einer erfolgreichen Installation, und sie sieht aus wie ein Fehlschlag, obwohl alles funktioniert hat.

Wir haben das im selben Lauf nachgestellt. Eine Shell, die die Konfigurationsdateien nicht gelesen hat, meldet:

$ command -v claude
claude: NOT FOUND

Dieselbe Shell, nachdem sie genau die Datei gelesen hat, die der Installer eingetragen hat:

$ . "$HOME/.local/bin/env"
$ command -v claude
/root/.local/bin/claude

Die Datei ~/.local/bin/env enthält nichts weiter als eine Prüfung, ob ~/.local/bin schon im PATH steht, und hängt das Verzeichnis sonst vorne an. Deshalb gilt: öffne nach der Installation ein neues Terminalfenster, statt im alten weiterzuarbeiten. Unter Windows heißt das ein neues PowerShell- oder CMD-Fenster. Bleibt die Meldung auch dort, steht das Installationsverzeichnis nicht im PATH, und Anthropics Anleitung zur PATH-Korrektur führt durch den Rest.

Brauchst du unter Windows Administratorrechte?

Nein. Anthropics Dokumentation schreibt zur nativen Windows-Installation wörtlich: "Sie müssen nicht als Administrator ausführen" (Anthropic, Erweiterte Einrichtung).

Das ist erwähnenswert, weil zwei der meistgelesenen deutschsprachigen Anleitungen das Gegenteil behaupten und ihre Leser PowerShell ausdrücklich als Administrator starten lassen. Der Rat ist nicht nur überflüssig, er erzeugt ein Folgeproblem: eine erhöhte PowerShell läuft unter einem anderen Benutzerprofil, die Installation liegt dann in einem anderen Heimatverzeichnis, und wer später aus dem normalen Fenster claude aufruft, findet nichts. Aus dieser einen unnötigen Empfehlung entsteht die Suche nach einem Fehler, den es nicht gibt.

Die zweite Windows-Entscheidung ist nativ oder WSL, und dafür gibt die Dokumentation eine klare Tabelle vor:

Entscheide danach, wo deine Projekte liegen. Arbeitest du ohnehin in WSL, installierst du dort mit dem Linux-Befehl und startest claude auch dort, nicht aus PowerShell. Git für Windows ist bei der nativen Variante optional und hat genau eine Folge: ohne Git für Windows führt Claude Code Shell-Befehle über PowerShell aus, mit Git für Windows über Git Bash.

curl oder npm: macht das einen Unterschied?

Für die Datei, die am Ende auf deiner Platte liegt, nicht. Das haben wir geprüft, statt es zu glauben: wir haben beide Wege in derselben Umgebung installiert und die Prüfsummen verglichen.

$ sha256sum ~/.local/share/claude/versions/2.1.285
33dad1ec615a2e08cc78b494f05c110e49916de2c79d78ec8799ebf46b233d29

$ sha256sum .../claude-code-linux-x64/claude
33dad1ec615a2e08cc78b494f05c110e49916de2c79d78ec8799ebf46b233d29

Beide Dateien sind 240.327.864 Bytes groß und Byte für Byte identisch, cmp meldet keinen Unterschied, und beide melden 2.1.285 (Claude Code). Der npm-Weg lädt dieselbe native Binärdatei über eine plattformabhängige optionale Abhängigkeit, und die installierte Binärdatei ruft selbst kein Node auf.

Der Unterschied liegt also nicht in dem, was du bekommst, sondern in dem, was du danach pflegst:

Die Angabe "Node.js 18 oder höher", die in einer der meistgelesenen deutschen Anleitungen steht, ist überholt. Läufst du auf einer älteren Node-Version, bricht die Installation übrigens nicht ab: npm gibt eine EBADENGINE-Warnung aus, die Installation wird fertig, und claude läuft trotzdem, weil die Binärdatei dein Node zur Laufzeit nicht benutzt.

Eine Sache macht der npm-Weg falsch, wenn du einer verbreiteten Empfehlung folgst. Anthropics Dokumentation warnt ausdrücklich: "Verwenden Sie NICHT sudo npm install -g, da dies zu Berechtigungsproblemen und Sicherheitsrisiken führen kann." Genau dieser Befehl steht in einer der deutschsprachigen Schritt-für-Schritt-Anleitungen als Empfehlung für Linux.

Welchen Anthropic-Plan brauchst du?

Einen bezahlten. Die Dokumentation ist an dieser Stelle eindeutig: Claude Code erfordert ein Pro-, Max-, Team-, Enterprise- oder Console-Konto, und der kostenlose Claude.ai-Plan enthält keinen Zugriff auf Claude Code. Wer das erst nach der Installation merkt, hat den Abend schon investiert.

Die Anmeldung selbst passiert beim ersten Start: du führst claude aus und folgst den Aufforderungen im Browser. Ist die Umgebungsvariable ANTHROPIC_API_KEY gesetzt, fragt Claude Code einmalig nach der Freigabe dieses Schlüssels, statt den Browser zu öffnen. Daneben läuft Claude Code über Amazon Bedrock, Google Cloud und Microsoft Foundry.

Was die Nutzung dich am Monatsende kostet, hängt weniger vom Abo ab als davon, wie du arbeitest. Der Claude Code Kostenrechner rechnet das mit deinen eigenen Zahlen durch, und was Claude Code kostet nimmt die Preisseiten auseinander.

Woran erkennst du, dass die Installation sitzt?

An zwei Befehlen, von denen der zweite mehr sagt als der erste. claude --version gibt eine Versionsnummer aus, zum Beispiel 2.1.285 (Claude Code). Das beweist, dass die Datei gefunden wird, und sonst nichts.

claude doctor prüft die Installation, ohne eine Sitzung zu starten, und gibt eine schreibgeschützte Diagnose aus. Aus unserem Lauf:

Running: native (2.1.285)
Platform: linux-x64
Path: /root/.local/share/claude/versions/2.1.285
Config install method: native
Search: OK (/usr/bin/rg)
Auto-update channel: latest
No installation issues found.

Interessant sind drei Zeilen. Config install method zeigt, über welchen Weg installiert wurde, was die Frage nach zwei parallelen Installationen sofort klärt. Search zeigt, ob ripgrep gefunden wird, denn ohne ripgrep bricht die Suche im Projekt ab. Und Auto-updates zeigt, ob du künftig aktuelle Versionen bekommst oder eingefroren bist.

Was tun, wenn es trotzdem klemmt?

Drei Fälle decken den größten Teil ab, und alle drei haben eine dokumentierte Ursache statt eines Rätsels.

claude läuft noch nach der Deinstallation. Dann liegt eine zweite Installation vor oder ein Alias aus einem älteren Installer. claude doctor zeigt in Path, welche Datei tatsächlich läuft.

Alpine und andere musl-basierte Systeme. Der dokumentierte Installationsbefehl scheitert dort mit not found, weil Alpine bash und curl nicht mitbringt. Nötig sind laut Dokumentation bash und curl für die Installation sowie libgcc, libstdc++ und ripgrep zur Laufzeit, danach USE_BUILTIN_RIPGREP=0 in der settings.json.

Du willst wissen, ob die Binärdatei echt ist. Für jede Veröffentlichung gibt es eine manifest.json mit SHA256-Prüfsummen, signiert mit einem GPG-Schlüssel von Anthropic. Der Fingerabdruck lautet 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE. Wer über apt, dnf oder apk installiert, bekommt diese Prüfung vom Paketmanager automatisch.

Bekommst du Updates automatisch?

Das hängt davon ab, welchen Weg du oben genommen hast, und es ist der einzige Unterschied zwischen den Installationswegen, der dich dauerhaft betrifft. Native Installationen aktualisieren sich im Hintergrund. Homebrew, WinGet sowie apt, dnf und apk tun das nicht und brauchen einen Befehl von dir.

Bei der nativen Installation kannst du zusätzlich wählen, wie schnell neue Versionen bei dir ankommen. Die Einstellung heißt autoUpdatesChannel und kennt zwei Werte: latest, die Voreinstellung, liefert neue Versionen sofort. stable liefert eine Version, die typischerweise etwa eine Woche alt ist und Veröffentlichungen mit größeren Regressionen überspringt. Wer Claude Code beruflich einsetzt und keine Lust auf eine Überraschung mitten in der Woche hat, trägt in die settings.json ein:

{
  "autoUpdatesChannel": "stable"
}

Ein sofortiges Update ohne Warten auf die Hintergrundprüfung holt claude update. Der Befehl meldet entweder Successfully updated from <alt> to version <neu> oder, wenn nichts zu tun ist, Claude Code is up to date. Welchen Kanal du fährst und wann zuletzt aktualisiert wurde, steht in der Ausgabe von claude doctor.

Was kommt nach der Installation?

Der Teil, der über das Ergebnis entscheidet. Ein installiertes Werkzeug kann noch nichts über dein Projekt wissen, und die Arbeit, die den Unterschied macht, ist aufgeschrieben: was in die CLAUDE.md gehört, welche Regeln du dem Werkzeug gibst und welche Schritte du dir vorbehältst.

Wenn du in deiner Sprache weiterarbeiten willst, beschreibt Claude Code auf Deutsch die Antwortsprache und die Sprache in der Projektdatei. Wie wir wiederkehrende Abläufe als Skills versioniert betreiben, steht in Claude Code Skills. Und wer den Aufbau nicht allein durchlaufen will: Das Claude Code System ist unser vierwöchiges Programm mit wöchentlichen Live-Sitzungen.