Claude Code installieren: die Anleitung für Windows und Mac

Die Installation von Claude Code ist ein einziger Befehl und dauert unter zwei Minuten. Interessant wird es danach: beim Konto, das die meisten Anleitungen falsch beschreiben, bei den Fehlermeldungen des ersten Starts und bei der Frage, wie oft sich ein Werkzeug im Hintergrund selbst aktualisieren darf, das in deiner Firma Code und Dateien anfasst.

Ein Terminalfenster, ein Befehl, fertig. Der Aufwand bei Claude Code steckt in den Entscheidungen davor und danach. Foto: olia danilevich auf Pexels

Erst das Konto, dann der Befehl

Eine Installation, die durchläuft und dann beim Anmelden scheitert, ist die häufigste vermeidbare Frustration bei diesem Werkzeug. Deshalb die Reihenfolge umdrehen.

Claude Code setzt ein bezahltes Konto voraus: Pro, Max, Team oder Enterprise, alternativ ein Console-Konto, das nach Token abrechnet. Der kostenlose Claude-Plan enthält Claude Code ausdrücklich nicht, das steht so in der Setup-Dokumentation und deckt sich mit dem, was wir in Claude kostenlos nutzen aufgeschrieben haben. Wer stattdessen über einen Cloud-Anbieter geht, nutzt Amazon Bedrock, die Agent Platform von Google Cloud oder Microsoft Foundry.

Für Firmen ist eine Angabe wichtig, die im deutschen Netz hartnäckig falsch kursiert: Im Team-Plan steckt Claude Code bereits im Standard-Sitzplatz zu 20 US-Dollar im Jahresabo. Die Behauptung, es brauche dafür einen Premium-Sitz zu 100 Dollar, stammt aus der Einführungsphase 2025 und ist überholt. Was die Nutzung im Monat tatsächlich kostet, haben wir in Claude Code Preis: Abo, API und Rechenbeispiele mit den Zahlen aus der Anthropic-Doku durchgerechnet.

Zweiter Punkt vor dem Befehl: das Betriebssystem. Die Anforderungen sind niedrig, aber eine Zahl überrascht regelmäßig.

Die Zahl, die stolpern lässt, ist macOS 13. In vielen Anleitungen steht macOS 11 Big Sur, und das ist auch korrekt, nur für ein anderes Produkt: Die grafische Claude-Desktop-App läuft ab macOS 11, das Kommandozeilen-Werkzeug erst ab macOS 13 Ventura. Auf einem MacBook, das noch auf Monterey steht, hilft also kein Installationsbefehl, sondern ein Systemupdate.

Mac: ein Befehl, zwei Kontrollen

Terminal öffnen, Befehl einfügen, Enter.

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

Danach in den Ordner wechseln, mit dem du arbeiten willst, und claude eingeben. Beim ersten Start öffnet sich der Browser zur Anmeldung. Ist die Umgebungsvariable ANTHROPIC_API_KEY gesetzt, fragt Claude Code stattdessen einmalig, ob dieser Schlüssel verwendet werden soll. Wie du so einen Schlüssel anlegst und mit einem Ausgabenlimit absicherst, steht in Claude API Key erstellen.

Zwei Kontrollen lohnen sich direkt danach:

claude --version
claude doctor

Der erste Befehl gibt eine Versionsnummer aus, etwa 2.1.272 (Claude Code). Der zweite ist der unterschätzte: claude doctor prüft die Installation und die Konfigurationsdateien, ohne eine Sitzung zu starten, meldet Fehler in der settings.json und zeigt, ob das letzte Hintergrund-Update durchgelaufen ist. Bei jedem späteren Problem ist das die erste Adresse.

Der Installer legt die Programmdatei unter ~/.local/bin/claude ab, als Verweis auf einen Ordner mit allen installierten Versionen. Kommt an dieser Stelle zsh: command not found: claude, fehlt dieser Ordner im Suchpfad:

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

Windows: nativ oder WSL, das ist die einzige echte Entscheidung

Seit dem nativen Installer braucht unter Windows niemand mehr eine Linux-Umgebung. Der Befehl läuft in PowerShell und verlangt keine Administratorrechte:

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

In der Eingabeaufforderung CMD sieht derselbe Schritt anders aus:

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

Welche der beiden Konsolen offen ist, erkennst du an der Eingabezeile: In PowerShell steht PS C:\, in CMD nur C:\. Vertauschst du die Befehle, kommt entweder 'irm' is not recognized oder The token '&&' is not a valid statement separator. Beides ist kein Defekt, sondern die falsche Zwischenablage.

Bleibt die Frage nach WSL. Die Dokumentation beantwortet sie mit einer Tabelle, deren Kern auf einen Satz hinausläuft: Sandbox-Ausführung von Befehlen gibt es nur unter WSL 2, unter nativem Windows und unter WSL 1 nicht. Wenn deine Entwickler in einer Linux-Werkzeugkette arbeiten oder wenn ihr wollt, dass das Werkzeug Befehle in einer abgeschotteten Umgebung ausführt, ist WSL 2 der richtige Weg. Für alles andere reicht die native Installation.

Git for Windows ist optional, und diese Änderung hat in den deutschen Anleitungen noch niemand nachgezogen. Ohne Git benutzt Claude Code das PowerShell-Werkzeug für Shell-Befehle, mit Git die Git Bash für das Bash-Werkzeug. Nützlich ist Git dort, wo ihr mit Bash-Skripten arbeitet. Findet Claude Code ein vorhandenes Git nicht, hilft ein Eintrag in der settings.json:

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

Ein Detail dazu, das Stunden kosten kann: Claude Code akzeptiert an dieser Stelle nur Dateien mit den Namen bash.exe, sh.exe, bash oder sh. Wer den Launcher git-bash.exe einträgt, bekommt keine Fehlermeldung, die Variable wird stillschweigend ignoriert.

Homebrew, WinGet, npm und die Linux-Paketquellen

Neben dem nativen Installer gibt es vier weitere Wege. Der Unterschied liegt weniger im Befehl als in der Frage, wer die Aktualisierung übernimmt.

Bei Homebrew gibt es eine Feinheit, die ich in keiner deutschsprachigen Anleitung gefunden habe: Anthropic pflegt dort zwei Casks. claude-code folgt dem Kanal stable, claude-code@latest bekommt jede Version sofort. Wer den ersten installiert und später brew upgrade claude-code@latest ausführt, aktualisiert ein Paket, das er gar nicht hat.

Zu npm noch eine Korrektur, weil die Angabe „Node.js 18 oder höher” in fast jeder deutschen Anleitung steht: Seit Version 2.1.198 verlangt das npm-Paket Node.js 22. Auf einer älteren Version bricht die Installation trotzdem nicht ab, npm gibt eine EBADENGINE-Warnung aus und claude läuft anschließend, weil das npm-Paket dieselbe native Programmdatei ausliefert wie der Installer und zur Laufzeit gar kein Node benutzt. Die Dokumentation warnt an dieser Stelle ausdrücklich vor sudo npm install -g, weil das Rechteprobleme und ein Sicherheitsrisiko schafft.

Do NOT use sudo npm install -g as this can lead to permission issues and security risks.

— Anthropic, Claude Code Advanced Setup, abgerufen am 15.09.2026

Die Frage, die deine IT stellen wird

„Ein Skript aus dem Internet direkt in die Shell pipen?” Diese Frage kommt in jedem Unternehmen mit einer ernstzunehmenden IT, und sie ist berechtigt. Die gute Nachricht: Anthropic liefert für alle drei Antworten, die eine IT-Abteilung akzeptiert.

Erstens die Paketquellen. Für Debian, Ubuntu, Fedora, RHEL und Alpine gibt es signierte Repositories. Der Fingerabdruck des Signaturschlüssels lautet 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE, und er lässt sich vor dem Einrichten mit gpg --show-keys prüfen. Die Paketverwaltung kontrolliert danach jede Aktualisierung selbst.

Zweitens das signierte Manifest. Jede Veröffentlichung ab 2.1.89 bringt eine manifest.json mit SHA256-Prüfsummen aller Plattform-Programmdateien mit, dazu eine abgesetzte GPG-Signatur. Wer die Signatur des Manifests prüft, hat damit indirekt jede darin gelistete Datei geprüft.

Drittens die Signaturen der Programmdateien selbst. Unter macOS ist die Datei von „Anthropic PBC” signiert und von Apple notariell beglaubigt, prüfbar mit codesign --verify --verbose ./claude. Unter Windows trägt sie eine Authenticode-Signatur von „Anthropic, PBC”, prüfbar mit Get-AuthenticodeSignature .\claude.exe. Linux-Dateien tragen keine eigene Signatur, dort übernimmt das Manifest oder die Paketquelle diese Rolle.

Wer das dokumentiert vorlegt, bekommt die Freigabe meist ohne zweite Sitzung. Wie ihr den Rest der Claude-Einführung datenschutzseitig aufstellt, steht in Claude DSGVO-konform einführen.

Die typischen Fehlerbilder beim ersten Start

Fast alle Meldungen, die beim ersten Versuch auftauchen, gehören zu fünf Ursachen. Die Tabelle ordnet die Fehlertexte aus der Anthropic-Dokumentation direkt der Lösung zu.

Hat sich im Lauf der Zeit mehr als eine Installation angesammelt, listet which -a claude unter macOS und Linux alle gefundenen Programmdateien auf, unter Windows where.exe claude. Empfohlen ist die native Installation unter ~/.local/bin/claude; ein altes globales npm-Paket verschwindet mit npm uninstall -g @anthropic-ai/claude-code.

Der Update-Takt: 31 Versionen in 30 Tagen

Jetzt zu dem Punkt, der in einem Unternehmen mehr Diskussion auslöst als die Installation selbst. Native Installationen aktualisieren sich im Hintergrund, und zwar oft.

Wir haben am 15. September 2026 den Auslieferungsserver von Anthropic und die npm-Registry ausgelesen. Ergebnis: Im Kanal latest stand Version 2.1.272, veröffentlicht am 14. September. Im Kanal stable stand 2.1.236 vom 19. August. Dazwischen liegen 28 Versionen und 26 Tage. In den 30 Tagen vor dieser Messung erschienen 31 Versionen, in den letzten sieben Tagen acht.

Zwei Dinge lassen sich daraus ablesen. Erstens: Claude Code veröffentlicht im Schnitt ungefähr eine Version pro Tag. Wer seine Arbeitsplätze auf dem Standardkanal lässt, hat jede Woche ein anderes Werkzeug auf dem Rechner. Zweitens: Die Dokumentation beschreibt stable als „typischerweise etwa eine Woche” hinter latest. Am Tag unserer Messung waren es 26 Tage. Das passt zur Logik des Kanals, der Versionen mit größeren Regressionen überspringt, es widerspricht aber der Erwartung, die die Formulierung weckt. Wer stable wählt, sollte mit mehreren Wochen Rückstand planen.

Gesteuert wird das über die settings.json:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.236"
}

autoUpdatesChannel wählt den Kanal, minimumVersion zieht einen Boden ein: Weder ein Hintergrund-Update noch claude update installiert etwas darunter. Das verhindert, dass ein Wechsel von latest auf stable die Arbeitsplätze auf eine ältere Version zurücksetzt. In den verwalteten Einstellungen kommen requiredMinimumVersion und requiredMaximumVersion dazu, die einen Versionskorridor erzwingen, außerhalb dessen Claude Code gar nicht erst startet. Wer die automatische Aktualisierung ganz abschalten will, setzt DISABLE_AUTOUPDATER auf "1", für alle Wege einschließlich manueller Updates DISABLE_UPDATES.

Für die meisten Mittelständler ist stable plus ein gesetzter Boden die passende Kombination. Teams, die neue Funktionen testen sollen, bleiben auf latest. Diese Entscheidung gehört in dieselbe Runde, in der ihr festlegt, welche Ordner das Werkzeug überhaupt sehen darf.

Was die deutschen Anleitungen offenlassen

Wir haben am 15. September 2026 vier deutschsprachige Anleitungen zur Claude-Code-Installation gegen die Anthropic-Dokumentation geprüft: gradually.ai (Stand 28.05.2026), flowki-club.de (12.08.2026), findskill.ai (04.05.2026) und die deutsche Seite von kimi.ai (12.08.2026).

Das Ergebnis in Zahlen: Die korrekte macOS-Mindestversion 13.0 nennt eine von vier Seiten. Die Windows-Voraussetzung ab Build 1809 ebenfalls eine von vier, eine weitere nennt fälschlich Build 1903. Die Node-Angabe ist auf drei von vier Seiten veraltet oder falsch, eine davon führt Node.js 18 sogar als Voraussetzung der nativen Installation, die überhaupt kein Node braucht. Dass Git for Windows optional ist, schreibt keine der vier Seiten. Dass der einzige belegbare Grund für WSL 2 die Sandbox-Ausführung ist, ebenfalls keine; eine Seite empfiehlt WSL pauschal, weil Claude Code darüber „besser funktioniere”. Die zwei Homebrew-Casks und die signierten Paketquellen tauchen nirgends auf, und Team, Enterprise und Console fehlen in der Aufzählung der Pläne, die Claude Code enthalten.

Der Grund liegt im Tempo: Bei 31 Versionen im Monat veraltet eine Anleitung binnen Wochen. Genau deshalb steht in diesem Artikel hinter jeder Angabe ein Prüfdatum, und genau deshalb aktualisieren wir diese Seite, statt eine zweite zu schreiben.

Der nächste Schritt nach der Installation: Öffne ein Projekt, in dem wiederkehrende Handarbeit steckt, etwa eine Ordnerstruktur voller Angebote oder Exporte, und lass Claude Code die erste Aufgabe daraus erledigen. Welche Aufgaben sich dafür eignen, auch in Teams ohne Entwickler, zeigen wir in Claude Code für Nicht-Programmierer; den Überblick über das ganze Werkzeug gibt der Hub Claude.

Florian Wessling

CEO, Collective Brain GmbH · Hamburg

Florian Wessling ist CEO der Collective Brain GmbH in Hamburg und bringt seit über 15 Jahren Marken, Content-Strategie und KI-gestütztes Marketing in Mittelstand und Konzerne. Was Collective Brain verkauft, betreibt er zuerst selbst: Sechs eigene KI-Marken dienen als Testfeld, von der automatisierten Content-Pipeline bis zum täglich aktualisierten AI Leaderboard. Er ist eingetragener BAFA-Berater und führt mit Collective Brain eine Google-Partner-Agentur.

LinkedIn Beratung anfragen