Claude Code wird auf jeder unterstützten Plattform mit einem einzigen Befehl installiert; der gesamte erste Durchlauf lautet: installieren, claude eingeben, anmelden. Dieser Leitfaden enthält den genauen Befehl für jedes Betriebssystem, was du bei Problemen prüfen solltest und wie du es anschließend auf einen anderen Endpunkt richtest.
Befehle verifiziert 3. Oktober 2026 anhand der Einrichtungsdokumentation von Anthropic für Claude Code.
Vorbereitung
| Anforderung | Unterstützung |
|---|---|
| Betriebssystem | macOS 13.0+, Windows 10 1809+ / Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ |
| Hardware | Mindestens 4 GB RAM, x64 oder ARM64 |
| Shell | Bash, Zsh, PowerShell oder CMD |
| Netzwerk | Internetverbindung erforderlich |
| Konto | Pro, Max, Team, Enterprise oder Console — der kostenlose Claude.ai-Tarif umfasst keinen Zugriff auf Claude Code |
Installation — der native Installer
Dies ist auf jeder Plattform die empfohlene Methode. Sie installiert eine eigenständige Binärdatei und aktualisiert sich im Hintergrund selbst.
# macOS, Linux, 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.cmdWenn du nicht sicher bist, welche Windows-Shell du verwendest, zeigt es dir der Prompt: PowerShell zeigt PS C:\, CMD zeigt C:\ ohne PS. Die falsche Variante auszuführen ist der häufigste Installationsfehler unter Windows — in der folgenden Tabelle findest du für beide Vertauschungen den genauen Fehler.
Paketmanager
Verwende diese Optionen, wenn dein vorhandener Paketmanager die Installation verwalten soll. Der Nachteil betrifft die Aktualisierungen: Keine dieser Optionen aktualisiert standardmäßig automatisch, anders als der native Installer.
# Homebrew (macOS, Linux) — stable channel
brew install --cask claude-code
# WinGet (Windows)
winget install Anthropic.ClaudeCode
# npm — requires Node.js 22+; never with sudo
npm install -g @anthropic-ai/claude-codeHomebrew veröffentlicht zwei Casks: claude-code folgt dem Stable-Kanal (typischerweise etwa eine Woche im Rückstand und mit ausgelassenen Releases, die größere Regressionen enthalten) und claude-code@latest liefert jedes Release sofort aus. Signierte apt-, dnf- und apk-Repositories gibt es für Debian / Ubuntu, Fedora / RHEL und Alpine, jeweils mit denselben Stable- und Latest-Kanälen.
Verwende bei npm niemals sudo npm install -g — das verursacht Berechtigungsprobleme und stellt ein Sicherheitsrisiko dar. Das npm-Paket installiert exakt dieselbe native Binärdatei wie der eigenständige Installer; daher besteht in beiden Fällen keine Node-Abhängigkeit zur Laufzeit.
Installation überprüfen
claude --version # prints e.g. "2.1.211 (Claude Code)"
claude doctor # read-only install + settings diagnostics
claude # start a session in the current projectclaude doctor ist der wichtigste Befehl: Er zeigt den Installationsstatus, Validierungsfehler in Einstellungsdateien und vorgeschlagene Lösungen an, ohne eine Sitzung zu starten. Damit lässt sich am schnellsten feststellen, ob die Installation oder die Konfiguration fehlerhaft ist.
Erster Start und Anmeldung
Öffne ein Terminal in dem Projekt, in dem du arbeiten möchtest, und führe claude aus. Dadurch wird eine interaktive Sitzung geöffnet und du wirst im Browser durch die Anmeldung geführt. Claude Code erfordert ein Pro-, Max-, Team-, Enterprise- oder Console-Konto.
Ein Verhalten solltest du kennen, bevor es dich überrascht: Wenn ANTHROPIC_API_KEY bereits in deiner Umgebung gesetzt ist, fordert Claude Code dich einmalig auf, diesen Schlüssel zu genehmigen, statt einen Browser zu öffnen. Lehnst du diese Aufforderung ab, wird der Schlüssel danach ohne weitere Aufforderung stillschweigend ignoriert — genau so, als würde die Variable nicht gelesen. Aktiviere ihn erneut unter /config → Benutzerdefinierten API-Schlüssel verwenden.
Windows: nativ oder WSL
| Option | Erfordert | Sandboxing | Wähle es, wenn |
|---|---|---|---|
| Natives Windows | Nichts; Git for Windows optional | Nicht unterstützt | Deine Projekte und Tools sind nativ für Windows |
| WSL 2 | WSL 2 aktiviert | Unterstützt | Linux-Toolchains oder der Wunsch nach Sandbox-Ausführung von Befehlen |
| WSL 1 | WSL 1 aktiviert | Nicht unterstützt | WSL 2 ist für dich nicht verfügbar |
Unter nativem Windows ist die Installation von Git for Windows optional, aber empfohlen: Sie stellt die Git Bash bereit, auf der das Bash-Tool basiert. Ohne sie führt Claude Code Shell-Befehle stattdessen über das PowerShell-Tool aus. Unter WSL installierst und startest du claude innerhalb des WSL-Terminals, nicht aus PowerShell.
Fehlerbehebung
| Symptom | Ursache und Lösung |
|---|---|
The token '&&' is not a valid statement separator | Du hast den CMD-Befehl in PowerShell ausgeführt. Verwende stattdessen die Zeile irm … | iex. |
'irm' is not recognized… | Das Gegenteil — du hast den PowerShell-Befehl in CMD ausgeführt. Verwende die Zeile curl … install.cmd. |
syntax error near unexpected token '<', ein 403 oder ein anderer curl-Fehler | Der Download hat das Skript nicht zurückgegeben — normalerweise aufgrund eines Proxys oder eines Netzwerkfilters zwischen dir und dem Installer. Versuche es erneut oder installiere stattdessen über einen Paketmanager. |
claude: command not found nach einer sauberen Installation | Öffne ein neues Terminal, damit deine Shell das Installationsverzeichnis übernimmt, und führe anschließend claude doctor aus. Eine zweite, ältere Installation oder ein veralteter Shell-Alias ist die andere häufige Ursache. |
| Berechtigungsfehler bei einer npm-Installation | Du hast sudo verwendet oder das globale npm-Verzeichnis ist nicht beschreibbar. Korrigiere die Eigentümerschaft des Verzeichnisses, statt den Vorgang mit sudo erneut auszuführen; ein nicht beschreibbares globales Verzeichnis verhindert auch automatische Aktualisierungen. |
Native Binärdatei fehlt nach npm install -g | Dein Paketmanager ist so konfiguriert, dass optionale Abhängigkeiten übersprungen werden. Die Plattform-Binärdatei wird als eine solche ausgeliefert; erlaube sie und installiere erneut. |
| Installation schlägt unter Alpine oder einer anderen musl-Distribution fehl | Alpine wird ohne bash und curl ausgeliefert. Installiere bash curl libgcc libstdc++ ripgrep und setze anschließend USE_BUILTIN_RIPGREP im env-Block deiner Einstellungsdatei auf "0". |
| Suche und Dateierkennung schlagen fehl | ripgrep ist normalerweise enthalten. Wenn es auf deiner Plattform nicht ausgeführt werden kann, installiere das System-ripgrep und setze USE_BUILTIN_RIPGREP=0. |
| Bash-Tool fehlt unter nativem Windows | Installiere Git for Windows. Wenn Claude Code Git Bash weiterhin nicht findet, setze CLAUDE_CODE_GIT_BASH_PATH im env-Block von ~/.claude/settings.json. |
401 nach dem Konfigurieren eines Schlüssels | Der Schlüssel befindet sich in dem Header, den der Server nicht liest — wechsle zwischen ANTHROPIC_AUTH_TOKEN und ANTHROPIC_API_KEY. Details findest du im Leitfaden zu API-Schlüsseln. |
Claude Code auf Kunavo richten
Sobald Claude Code ausgeführt wird, funktioniert es mit jedem Endpunkt, der die Anthropic Messages API bereitstellt — es liest ANTHROPIC_BASE_URL nativ, sodass dies eine unterstützte Konfiguration und kein Workaround ist. Kein Plugin, kein Proxy, keine gepatchte Binärdatei:
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5Fünf Dinge zu diesem Block, von denen dich jeder einzelne eine Stunde kosten kann, wenn du ihn falsch konfigurierst:
ANTHROPIC_BASE_URList ausschließlich der Ursprung. Claude Code hängt/v1/messagesselbst an — wenn du den Pfad einschließt, erhältst du einen 404-Fehler.- Verwende
ANTHROPIC_AUTH_TOKEN, nichtANTHROPIC_API_KEY. Sie gehören in unterschiedliche HTTP-Header. Das Bearer-Token wird sofort wirksam, währendANTHROPIC_API_KEYdie oben beschriebene einmalige Genehmigung benötigt. Kunavo liest den Schlüssel aus beiden Headern, einschließlich/v1/models, sodass auf Kunavo dieser Genehmigungsschritt den Unterschied ausmacht. - Setze
ANTHROPIC_MODELexplizit. Kunavo gleicht Model-Slugs exakt ab und behandelt Namen mit Datumszusatz nicht als Aliase, sodassclaude-sonnet-4-5-20250929einen 404-Fehler zurückgibt, währendclaude-sonnet-5funktioniert. - Setzen Sie auch
ANTHROPIC_DEFAULT_OPUS_MODELundANTHROPIC_DEFAULT_SONNET_MODELfest. Der integrierte Standard von Claude Code und sein Aliasopuswerden beide zum neuesten Opus aufgelöst. Wenn Kunavo dieses Modell noch nicht bereitstellt, liefert die erste Anfrage einen 404-Fehler. Der Block setztopusauf Opus 5.5 (claude-opus-5-5), wofür Claude Code v2.1.280 oder neuer erforderlich ist — führen Sie bei einer älteren Installationclaude updateaus. Das Aliassonnetfordert Sonnet 5.5 an, das Kunavo nicht bereitstellt. Ohne den Sonnet-Pin/model sonnetliefern die Ausführungsphase vonopusplanund alle Subagents mitmodel: sonneteinen 404-Fehler. ANTHROPIC_DEFAULT_HAIKU_MODELdeckt die Hintergrundaufrufe ab, die Claude Code selbst für Zusammenfassungen und Titel ausführt.claude-haiku-4-5kostet $0.70 / $3.50 pro 1M gegenüber $1.40 / $7.00 für das Hauptmodell — eine einzige Zeile für eine dauerhafte Ersparnis.
Trage diese Werte in den env-Block von ~/.claude/settings.json ein, statt sie per Shell-Export zu setzen, wenn Editoren und Hintergrundagenten sie ebenfalls sehen sollen — und niemals in die versionierte .claude/settings.json eines Projekts. Erstelle den sk-kn--Schlüssel in der Dashboard-Oberfläche, nachdem du dich registriert hast; eine Aufladung von $10 ist das Minimum, es gibt keine monatliche Gebühr und das Guthaben verfällt nicht. Wie weit diese $10 reichen, hängt von den Kosten jedes Modells pro Token im Vergleich zu Anthropics offiziellen API-Preisen ab.
Was sich hinter einem Gateway ändert
Programmieren, Tools, Subagenten, MCP, Hooks und Prompt-Caching bleiben unverändert. Drei Dinge ändern sich jedoch und sollten dir bekannt sein, bevor du von einem Fehler ausgehst:
- Remote Control und Spracheingabe sind nicht verfügbar. Beide benötigen eine claude.ai-Identität, die durch die Gateway-Anmeldedaten ersetzt wird.
/fastkann den schnellen Modus als deaktiviert melden. Die Verfügbarkeitsprüfung ruft Anthropic direkt auf, statt deiner Base-URL zu folgen. Normale Anfragen sind davon nicht betroffen./context-Zähler werden zu lokalen Schätzungen. Die Tokenzählung ist der eine Endpunkt, den Anthropics eigene Gateway-Spezifikation als optional kennzeichnet. Wenn er fehlt, schätzt Claude Code lokal — Kunavo stellt/v1/messages/count_tokensderzeit nicht bereit. Automatische Komprimierung und die Sitzung selbst bleiben unberührt.
Die vollständige Liste sowie die Entscheidung zwischen Router und keinem Router findest du im Claude-Code-Router-Leitfaden.
Häufig gestellte Fragen
Wie installiere ich Claude Code?
Auf macOS, Linux oder WSL führe `curl -fsSL https://claude.ai/install.sh | bash` aus. Unter Windows führe `irm https://claude.ai/install.ps1 | iex` in PowerShell aus oder `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd` in CMD. Der native Installer ist die empfohlene Methode und aktualisiert sich im Hintergrund selbst. Homebrew (`brew install --cask claude-code`), WinGet (`winget install Anthropic.ClaudeCode`), npm sowie signierte apt/dnf/apk-Repositories werden ebenfalls unterstützt, aber keine dieser Methoden aktualisiert standardmäßig automatisch.
Benötige ich Node.js, um Claude Code zu installieren?
Nicht für den nativen Installer, Homebrew, WinGet oder die Linux-Paket-Repositories — sie alle installieren eine native Binärdatei, die Node zur Laufzeit nicht verwendet. Nur der npm-Installationspfad umfasst Node, und seit v2.1.198 erfordert dieses Paket Node.js 22 oder höher. Auch dann lädt npm über eine plattformspezifische optionale Abhängigkeit lediglich dieselbe native Binärdatei herunter.
Welche Systemanforderungen gelten für Claude Code?
macOS 13.0+, Windows 10 1809+ oder Windows Server 2019+, Ubuntu 20.04+, Debian 10+ oder Alpine Linux 3.19+; mindestens 4 GB RAM auf einem x64- oder ARM64-Prozessor; eine Internetverbindung; sowie Bash, Zsh, PowerShell oder CMD als Shell. Du musst dich außerdem in einem von Anthropic unterstützten Land befinden.
Wie melde ich mich zum ersten Mal bei Claude Code an?
Führe `claude` in einem Projektverzeichnis aus und folge den Browser-Eingabeaufforderungen. Claude Code erfordert ein Pro-, Max-, Team-, Enterprise- oder Console-Konto — der kostenlose Claude.ai-Tarif umfasst keinen Zugriff auf Claude Code. Wenn die Umgebungsvariable ANTHROPIC_API_KEY gesetzt ist, fordert Claude Code dich einmalig auf, diesen Schlüssel zu genehmigen, statt einen Browser zu öffnen.
Kann ich Claude Code unter Windows ohne WSL installieren?
Ja. Führe den PowerShell- oder CMD-Installer aus und starte `claude` in einem beliebigen Terminal; Administratorrechte sind nicht erforderlich. Git for Windows ist optional, aber empfohlen, da es die Git Bash bereitstellt, auf der das Bash-Tool basiert — ohne sie führt Claude Code Shell-Befehle stattdessen über das PowerShell-Tool aus. WSL 2 ist die richtige Wahl, wenn du Linux-Toolchains oder eine Sandbox-Ausführung von Befehlen möchtest, die natives Windows nicht unterstützt.
Warum meldet `claude` nach der Installation „command not found“?
Das Installationsverzeichnis befindet sich in der verwendeten Shell nicht in deinem PATH. Öffne zuerst ein neues Terminal — der Installer fügt unter macOS und Linux ~/.local/bin hinzu, und eine bestehende Sitzung übernimmt diese Änderung nicht. Führe `claude doctor` aus, um schreibgeschützte Diagnosen der Installation und deiner Einstellungsdateien zu erhalten. Eine zweite, ältere Installation oder ein zurückgebliebener Shell-Alias ist die andere häufige Ursache.
Wie richte ich Claude Code auf einen anderen API-Endpunkt?
Setzen Sie ANTHROPIC_BASE_URL auf den Ursprung eines beliebigen Endpunkts, der die Anthropic Messages API bereitstellt — Claude Code liest diese Variable nativ und hängt /v1/messages selbst an, sodass weder Plugin noch Proxy beteiligt sind. Kombinieren Sie sie mit ANTHROPIC_AUTH_TOKEN für die Zugangsdaten und einem expliziten ANTHROPIC_MODEL. Setzen Sie ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL und ANTHROPIC_DEFAULT_HAIKU_MODEL auf Modelle, die der Endpunkt bereitstellt, da die Opus- und Sonnet-Aliase sonst den neuesten Modellen von Anthropic folgen. Bei Kunavo werden dieselben Claude-Modelle im Pay-as-you-go-Verfahren zu 30 % unter dem Listenpreis von Anthropic ausgeführt.
Nächste Schritte
- Claude-Code-API-Schlüssel — wo du einen erhältst, wo du ihn einträgst und welcher Header-Mismatch hinter den meisten 401-Fehlern steckt.
- Claude-Code-Preise — Abonnement oder API, Preise pro Modell und was ein Monat kostet.
- Ist Claude Code kostenlos? — was kostenlos ist, was nicht und wo die Grenze verläuft.
- Ausführung ohne Berechtigungsaufforderungen — was
--dangerously-skip-permissionstatsächlich entfernt und drei Einschränkungen, die jeweils etwa eine Minute dauern. - Claude Code vs. Codex CLI — falls du noch zwischen Terminal-Agenten wählst.