Claude Code mit einem Befehl installieren: macOS, Linux und Windows
Stand 2026-10-07 empfiehlt Anthropic für Claude Code den Native Install: Unter macOS, Linux und WSL führen Sie curl -fsSL https://claude.ai/install.sh | bash aus, in Windows PowerShell irm https://claude.ai/install.ps1 | iex; Homebrew, WinGet und npm funktionieren ebenfalls. Für die Anbindung an QCode genügt ein Befehl mit dem QCode-Einrichtungsskript: Es wählt den Endpunkt nach Latenz, schreibt die Konfiguration, installiert bei Bedarf Node.js und die CLI und prüft die Verbindung. Diese Seite zeigt die Befehle für beide Wege, die Prüfung nach der Installation und häufige Installationsfehler.
Aktualisiert 2026-10-08
Vier Dinge vorab
Offizieller Installer, je Shell ein Befehl
install.sh für macOS, Linux und WSL, install.ps1 für Windows PowerShell, install.cmd für Windows CMD. Anthropic kennzeichnet diesen Weg als empfohlen; danach aktualisiert sich Claude Code im Hintergrund.
Voraussetzung für die npm-Installation
Laut offizieller Dokumentation braucht das npm-Paket Node.js 22 oder neuer; bei einer älteren Version gibt npm nur eine EBADENGINE-Warnung aus, die Installation läuft trotzdem durch. npm installiert dieselbe native Binärdatei wie der offizielle Installer.
QCode-Einrichtungsskript
Unter macOS und Linux: curl -fsSL https://qcode.cc/install/claude-code.sh | bash, in Windows PowerShell: irm https://qcode.cc/install/claude-code.ps1 | iex. Weder sudo noch Administratorrechte nötig.
Die erste Prüfung nach der Installation
Eine funktionierende Installation gibt eine Versionsnummer wie 2.1.211 (Claude Code) aus. Für eine gründlichere Prüfung gibt es claude doctor; in einer Sitzung zeigt /status, welche Authentifizierung aktiv ist.
Welche Installationswege offiziell sind
Stand 2026-10-07 nennt die Einrichtungsseite der Claude-Code-Dokumentation den offiziellen Installer (Native Install, als empfohlen gekennzeichnet), Homebrew (brew install --cask claude-code), WinGet (winget install Anthropic.ClaudeCode) und npm (npm install -g @anthropic-ai/claude-code); für Debian, Fedora, RHEL und Alpine gibt es zusätzlich signierte apt-, dnf- und apk-Repositories. Der wichtigste Unterschied sind Updates: Der offizielle Installer aktualisiert sich im Hintergrund, Installationen über Homebrew und WinGet nicht automatisch. Homebrew bietet zwei Casks: claude-code folgt dem Kanal stable, der meist etwa eine Woche zurückliegt und Releases mit größeren Regressionen überspringt, claude-code@latest folgt dem Kanal latest. Systemvoraussetzungen: macOS 13.0+, Windows 10 1809+ oder Windows Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+, mindestens 4 GB RAM und ein x64- oder ARM64-Prozessor.
Versionen und Dokumentation, Stand 2026-10-07
Stand 2026-10-07 ist das neueste Claude-Code-Release auf GitHub Releases v2.1.292, veröffentlicht am 2026-10-06 (UTC); auch das latest-Tag von @anthropic-ai/claude-code auf npm steht auf 2.1.292, und die Paketmetadaten nennen node >=22.0.0. Die QCode-Dokumentationsseiten zum Einrichtungsskript und zur Installation tragen beide den Vermerk aktualisiert am 2026-09-25; die Installationsanleitung stellt das Skript als empfohlenen Weg an den Anfang und erklärt, dass es alle Schritte der Seite mit einem Befehl erledigt. Im Quelltext des öffentlichen Skripts claude-code.sh auf qcode.cc steht die Version 2026.10.07.1.
Zeitleiste
Die QCode-Dokumentationsseiten zum Einrichtungsskript und zur Installation werden aktualisiert; Stand 2026-10-07 empfiehlt die Installationsanleitung das Skript.
Claude Code v2.1.292 erscheint auf GitHub Releases (UTC), Stand 2026-10-07 das neueste Release; auch das latest-Tag auf npm ist 2.1.292.
Der Quelltext des öffentlichen Skripts claude-code.sh trägt die Version 2026.10.07.1; Befehle, Fehlermeldungen und Skriptverhalten auf dieser Seite wurden an diesem Tag mit den offiziellen Seiten und dem Skript-Quelltext abgeglichen.
Bestätigt vs. nicht dokumentiert
Bestätigt (wörtlich in der Dokumentation)
Folgendes steht wörtlich in der Claude-Code-Dokumentation, auf GitHub Releases, in den npm-Paketmetadaten oder in der QCode-Dokumentation und im Quelltext des öffentlichen Skripts: die drei offiziellen Installationsbefehle und die Empfehlung für Native Install; automatische Hintergrund-Updates beim offiziellen Installer, keine bei Homebrew und WinGet; das npm-Paket braucht Node.js 22 oder neuer und installiert dieselbe native Binärdatei; Anthropic rät ausdrücklich von sudo npm install -g ab; unter Windows müssen Sie nicht als Administrator installieren; wofür claude --version, claude doctor und /status da sind; die Befehle des QCode-Skripts, seine vier Schritte (Endpunktwahl, Konfiguration schreiben, bei Bedarf Node.js und CLI installieren, Verbindungstest), Sicherungen und Rückgängigmachen; zu den Variablen, die das Skript schreibt, gehören ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN und CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1.
Nicht dokumentiert oder hier nicht geprüft
Drei Punkte lässt diese Seite offen. Erstens: Das npm-Paket verlangt Node.js 22 oder neuer, Anthropic schreibt aber auch, dass ein älteres Node.js nur eine EBADENGINE-Warnung auslöst und die Installation durchläuft; das QCode-Skript installiert eine LTS-Version, wenn Node.js fehlt, und über das Verhalten bestimmter Node.js-Versionen spekulieren wir nicht. Zweitens: Die Installation wurde nicht auf jedem Betriebssystem Schritt für Schritt getestet; die Befehle folgen der offiziellen und der QCode-Dokumentation vom 2026-10-07, maßgeblich sind Ihr System und Ihre Version. Drittens: 2.1.211 ist in der offiziellen Dokumentation nur ein Beispiel für das Ausgabeformat, nicht die aktuelle Version.
Offizieller Installer, npm oder QCode-Skript
Offizieller Installer vs. npm
Anthropic kennzeichnet Native Install als empfohlen, und er aktualisiert sich im Hintergrund; bei npm-spezifischen Rechtefehlern lautet der offizielle Rat, auf ihn umzusteigen. Der npm-Weg braucht Node.js 22 oder neuer und installiert dieselbe native Binärdatei; aktualisiert wird mit npm install -g @anthropic-ai/claude-code@latest, von npm update -g und sudo npm install -g rät die Dokumentation ab. Homebrew und WinGet passen für alle, die diese Paketmanager ohnehin nutzen, aktualisieren aber nicht automatisch.
Nur Claude Code vs. QCode-Skript
Der offizielle Installer installiert nur Claude Code; auf dem offiziellen Weg melden Sie sich danach mit einem Pro-, Max-, Team-, Enterprise- oder Console-Konto an. Das QCode-Einrichtungsskript richtet zusätzlich die Verbindung ein: Es wählt den Endpunkt nach Latenz, schreibt ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN, installiert bei fehlendem Node.js eine LTS-Version über nvm oder winget und danach die CLI per npm und schickt zum Schluss eine minimale Anfrage mit Ihrem Schlüssel zur Prüfung. Ist Claude Code schon installiert und brauchen Sie nur die QCode-Konfiguration, hängen Sie --no-install an.
Schritt für Schritt, beide Wege
Offizieller Weg: (1) Öffnen Sie ein Terminal und führen Sie den Befehl für Ihr System aus: unter macOS, Linux oder WSL curl -fsSL https://claude.ai/install.sh | bash; in Windows PowerShell irm https://claude.ai/install.ps1 | iex; in Windows CMD curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. (2) Öffnen Sie ein neues Terminalfenster und führen Sie claude --version aus; es sollte eine Versionsnummer erscheinen. (3) Starten Sie claude in Ihrem Projektordner. Weg über QCode: (1) Legen Sie im QCode-Dashboard einen API-Schlüssel an, der mit cr_ beginnt. (2) Unter macOS oder Linux führen Sie curl -fsSL https://qcode.cc/install/claude-code.sh | bash aus, unter Windows irm https://qcode.cc/install/claude-code.ps1 | iex in PowerShell, und fügen den Schlüssel bei der Abfrage ein (die Eingabe wird nicht angezeigt). (3) Öffnen Sie ein neues Terminal, damit die Konfiguration greift (unter Windows Editoren wie VS Code zusätzlich einmal neu starten), führen Sie claude --version aus, starten Sie dann claude und prüfen Sie mit /status die Authentifizierung. Für die manuelle Einrichtung setzt die QCode-Installationsanleitung zwei Variablen: ANTHROPIC_BASE_URL=https://api.qcode.cc/api und ANTHROPIC_AUTH_TOKEN mit Ihrem Schlüssel. Bricht der Installationsbefehl mit syntax error near unexpected token '<' oder einem 403 ab, hat die Installationsadresse laut Dokumentation statt des Skripts eine Webseite oder einen Fehlerstatus geliefert: Installieren Sie dann unter macOS per Homebrew oder unter Windows per WinGet, oder versuchen Sie es nach ein paar Minuten erneut.
Mit QCode
Bei QCode nutzt Claude Code den Endpunkt mit Anthropic-Protokoll: ANTHROPIC_BASE_URL ist https://api.qcode.cc/api (bis /api, ohne abschließenden Schrägstrich), ANTHROPIC_AUTH_TOKEN ein im Dashboard erstellter cr_-Schlüssel; Claude Code sendet ihn im Authorization-Header mit dem Präfix Bearer. Unter macOS und Linux gehört zu den Variablen, die das Skript in den verwalteten Shell-Block schreibt, auch CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1; die QCode-Installationsanleitung beschreibt sie als Abschalten nicht notwendiger Netzwerkanfragen wie Telemetrie. Standardmäßig schreibt das Skript kein ANTHROPIC_MODEL, sodass Claude Code sein eingebautes Standardmodell behält und dessen Upgrades folgt; zum Festlegen übergeben Sie --model, etwa claude-sonnet-5-5 oder claude-opus-5-5. Weitere Claude-Modelle wie claude-sonnet-5 lassen sich genauso aufrufen. Abgerechnet wird pro Token, die Preise je Modell stehen unter /models; für Claude-Modelle gibt es keinen separaten Langkontext-Tarif.
Häufig gestellte Fragen
Wie installiere ich Claude Code unter Windows?
In PowerShell führen Sie irm https://claude.ai/install.ps1 | iex aus, in CMD curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd; Administratorrechte brauchen Sie nicht, winget install Anthropic.ClaudeCode geht ebenfalls. Unterstützt werden Windows 10 1809+ und Windows Server 2019+. Git for Windows ist optional: Damit nutzt Claude Code Git Bash, ohne es PowerShell als Shell-Werkzeug. Für WSL führen Sie den Linux-Befehl im WSL-Terminal aus und starten claude dort. Für die Anbindung an QCode führen Sie in PowerShell irm https://qcode.cc/install/claude-code.ps1 | iex aus.
Nach der Installation erscheint command not found: claude oder 'claude' is not recognized?
Meist liegt das Installationsverzeichnis noch nicht im PATH; öffnen Sie also zuerst ein neues Terminalfenster und versuchen Sie es erneut: Laut Dokumentation behält die Sitzung, aus der Sie installiert haben, ihren alten PATH. Der offizielle Installer legt claude unter macOS und Linux in ~/.local/bin/claude ab, unter Windows in %USERPROFILE%\.local\bin\claude.exe; in Zsh führen Sie echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc aus, für Bash unter Linux kommt dieselbe Zeile in ~/.bashrc. Fehlt der Befehl nach dem QCode-Skript unter Windows, rät auch die QCode-Dokumentation, ein neues PowerShell-Fenster zu öffnen.
Meldung irm is not recognized oder The token '&&' is not a valid statement separator?
Befehl und Shell passen nicht zusammen. Laut Dokumentation heißt 'irm' is not recognized, dass Sie in CMD sind: Nehmen Sie den CMD-Befehl oder öffnen Sie PowerShell; The token '&&' is not a valid statement separator heißt, dass Sie den CMD-Befehl in PowerShell ausgeführt haben. Wer curl -fsSL ... | bash in PowerShell startet, bekommt einen Fehler zum Parameter fsSL, weil curl dort ein Alias für Invoke-WebRequest ist. Für das QCode-Skript in CMD führen Sie powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://qcode.cc/install/claude-code.ps1 | iex" aus.
PowerShell meldet running scripts is disabled on this system?
Die Ausführungsrichtlinie blockiert die .ps1-Startskripte, die npm anlegt. Die Dokumentation nennt drei Lösungen: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser ausführen und erneut versuchen; npm.cmd und claude.cmd verwenden; oder statt npm den PowerShell-Installer nutzen, der eine Binärdatei statt eines .ps1-Skripts installiert. Das QCode-Einrichtungsskript lockert die Richtlinie nur für den eigenen Lauf und lässt Ihre Einstellungen auf Benutzer- und Computerebene unverändert; damit auch künftige PowerShell-Sitzungen nicht blockiert werden, nennt die QCode-Dokumentation Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
npm bricht mit EACCES ab. Soll ich sudo verwenden?
Nein. Anthropic schreibt ausdrücklich, sudo npm install -g nicht zu verwenden, weil das zu Rechteproblemen und Sicherheitsrisiken führen kann; wenn Sie zuvor per npm installiert haben und npm-spezifische Rechtefehler sehen, empfiehlt die Dokumentation den Wechsel zum offiziellen Installer curl -fsSL https://claude.ai/install.sh | bash. Auch das QCode-Skript braucht kein sudo: Mit sudo landet die Konfiguration im Home-Verzeichnis von root, das Ihr eigenes Terminal nie liest; starten Sie es ohne sudo neu.
Die Prüfung des QCode-Skripts scheitert mit 401, 404 oder einem Timeout – was tun?
Entscheidend ist der Statuscode. Laut QCode-Dokumentation bedeutet 401 einen ungültigen oder abgelaufenen Schlüssel: Prüfen Sie im Dashboard, ob das Präfix cr_ vollständig kopiert wurde, und starten Sie das Skript erneut; 404 bedeutet eine falsche Adresse: Für Claude Code muss ANTHROPIC_BASE_URL die Form https://api.qcode.cc/api haben, ohne abschließenden Schrägstrich; bei einem Timeout starten Sie erneut mit dem Parameter --domain und wählen einen anderen Endpunkt. Meldet das Skript, dass die Konfiguration geschrieben, die Prüfung aber nicht bestanden wurde, ist die Konfiguration bereits vorhanden: Beheben Sie die Ursache und starten Sie erneut. Ein erneuter Lauf ist immer sicher: Der verwaltete Block wird an Ort und Stelle aktualisiert, Dateien werden vor dem Überschreiben gesichert.
Quellen
Installationswege, Voraussetzungen und Updates: die Seiten Advanced setup und Quickstart der Claude-Code-Dokumentation (code.claude.com). Fehler und Lösungen: die offizielle Seite Troubleshoot installation and login. Bedeutung der Variablen: die offiziellen Seiten zu Umgebungsvariablen und Authentifizierung. Versionen: GitHub Releases und CHANGELOG von anthropics/claude-code sowie die npm-Metadaten von @anthropic-ai/claude-code. QCode-Seite: die QCode-Dokumentationsseiten zum Einrichtungsskript und zur Installation (beide aktualisiert am 2026-09-25) und der Quelltext des öffentlichen Skripts claude-code.sh auf qcode.cc (nur gelesen, nicht ausgeführt). Alles abgerufen am 2026-10-07.
Mit einem Befehl installieren und mit QCode verbinden
Halten Sie Ihren cr_-Schlüssel bereit und starten Sie das Einrichtungsskript. Bezahlt wird pro Token, Preise je Modell unter /models.
Weiterführende Lektüre
Claude Code Benutzerhandbuch
Komplettes Tutorial von der Installation bis zum sicheren Umgang.
ANTHROPIC_BASE_URL und AUTH_TOKEN einrichten
Claude Code mit zwei Umgebungsvariablen auf einen eigenen Endpunkt ausrichten.
Claude Code in China
Zahlung per Alipay / WeChat Pay und Einrichtungsschritte.
Befehle und Zitate auf dieser Seite wurden am 2026-10-07 geprüft; maßgeblich sind die offizielle Claude-Code-Dokumentation und die QCode-Dokumentation, Änderungen beim Anbieter sind ohne Vorankündigung möglich. Installationsbefehle und Fehlertexte ändern sich mit den Versionen, richten Sie sich nach Ihrer Version; maßgeblich für die Modellverfügbarkeit ist /models.