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

Die Installation von Claude Code ist ein einziger Befehl. Davor lohnt die Frage, ob du das Terminal-Werkzeug überhaupt brauchst oder ob die Desktop-App reicht. Danach geht es um das Konto, die Fehlermeldungen des ersten Starts und darum, 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

Claude Desktop oder Claude Code: was willst du installieren?

Wer „Claude installieren“ sucht, meint oft eines von zwei Programmen. Claude Desktop ist die App für Mac und Windows, unter Linux als Beta, mit den Bereichen Chat, Cowork und Code. Claude Code ist das Werkzeug, das in einem Projektordner Dateien liest, ändert und Befehle ausführt. Es läuft im Terminal, in der Entwicklungsumgebung, im Browser und auch in der Desktop-App.

Für viele Teams ist die Desktop-App der einfachere Einstieg. Sie bringt Claude Code im Reiter Code mit, ohne Node.js und ohne das Terminal-Werkzeug. Team- und Enterprise-Nutzern empfiehlt Anthropic im Hilfe-Center diesen Weg inzwischen ausdrücklich zuerst. Wie du die App auf Mac und Windows einrichtest, steht in Claude Desktop einrichten.

Das Terminal-Werkzeug brauchst du, wenn ihr Claude Code in Skripten, auf Servern oder aus der Entwicklungsumgebung heraus nutzt. Die Tabelle ordnet die gängigen Fälle zu.

Ein Unterschied fällt unter Windows auf. Das Terminal-Werkzeug installierst du ohne Administratorrechte. Die Desktop-App braucht sie für den Hintergrunddienst, in dem Cowork läuft; wer keine Freigabe bekommt, kann die App ohne Cowork installieren. Auch die Suche nach „claude exe“ hat zwei Antworten: Der Installer der Desktop-App heißt ClaudeSetup.exe, das Terminal-Werkzeug liegt nach der Installation als claude.exe unter %USERPROFILE%.local\bin.

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, Ultra, Team oder Enterprise, alternativ ein Console-Konto, das nach Token abrechnet. Ultra ist der frühere Plan Max 20x, Anthropic hat ihn ohne Preisänderung umbenannt. 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 in jedem Standard-Sitz, der 20 US-Dollar im Monat im Jahresabo kostet und 25 US-Dollar bei monatlicher Zahlung. Die Behauptung, es brauche dafür einen Premium-Sitz, ist überholt. Laut den Release Notes von Anthropic kam Claude Code am 20. August 2025 mit dem Premium-Sitz in den Team-Plan, am 16. Januar 2026 folgte der Standard-Sitz. Der Premium-Sitz zu 100 US-Dollar im Jahresabo bringt heute die fünffache Nutzungsmenge eines Standard-Sitzes. Die monatlichen API-Guthaben des Team-Plans gelten laut Hilfe-Center übrigens nicht in Claude Code. 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, die Pläne im Vergleich stehen im Claude-Abo-Vergleich.

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 Ventura. In vielen Anleitungen steht noch macOS 11 Big Sur, auch unsere erste Fassung vom September nannte diese Zahl für die grafische Desktop-App. Heute nennt das Hilfe-Center von Anthropic auch für die App macOS 13, beide Wege brauchen also dieselbe Version. Auf einem MacBook, das noch auf Monterey steht, hilft deshalb nur ein Systemupdate.

Mac: ein Befehl, zwei Kontrollen

Terminal öffnen, Befehl einfügen, Enter. Während des Downloads zeigt der Befehl keinen Fortschritt, das ist normal.

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

Danach ein neues Terminalfenster öffnen, in den Ordner wechseln, mit dem du arbeiten willst, und claude eingeben. Beim ersten Start öffnet sich der Browser zur Anmeldung. Du meldest dich mit denselben Zugangsdaten an wie bei Claude, damit ist dein Abo mit Claude Code verknüpft. In einem Ordner, dem du noch nicht vertraut hast, fragt Claude Code vor dem Arbeiten nach.

Ist die Umgebungsvariable ANTHROPIC_API_KEY gesetzt, fragt Claude Code einmalig, ob dieser Schlüssel verwendet werden soll. Bestätigst du, rechnet Claude Code laut Hilfe-Center über die API ab und nutzt das Kontingent deines Abos nicht. Wer ein Abo hat und trotzdem eine API-Rechnung bekommt, sollte deshalb zuerst nach dieser Variable sehen. Wie du so einen Schlüssel anlegst und mit einem Ausgabenlimit absicherst, steht in Claude API Key erstellen.

Zwei Kontrollen lohnen sich direkt nach der Installation:

claude --version
claude doctor

Der erste Befehl gibt eine Versionsnummer aus, am 12. November etwa 2.1.322 (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 mit Lösungsvorschlag 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 in den Ordner ~/.local/share/claude/versions. Dort behält er die zwei neuesten Versionen und löscht ältere. Fehlt ~/.local/bin im Suchpfad, meldet der Installer das am Ende unter „Setup notes“, ändert den Pfad aber nicht selbst. Beim Start kommt dann zsh: command not found: claude, und diese zwei Zeilen helfen:

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

Die Programmdatei landet unter %USERPROFILE%\.local\bin\claude.exe. 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 heißt nur, dass der Befehl in der falschen Konsole gelandet ist.

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, Anthropic empfiehlt es unter nativem Windows aber. Es bringt die Git Bash mit, die das Bash-Werkzeug und das Monitor-Werkzeug von Claude Code brauchen. Ohne Git arbeitet Claude Code mit PowerShell als Shell; ist Git installiert, steht das PowerShell-Werkzeug zusätzlich bereit. 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. Claude Code ignoriert die Variable dann und sucht die Git Bash selbst, die Warnung dazu sieht nur, wer mit --debug startet.

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: Dort stehen zwei Casks bereit, die sich gegenseitig ausschließen. 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, und bekommt laut Dokumentation die Meldung Error: Cask 'claude-code@latest' is not installed.

Zu npm noch eine Korrektur, weil die Angabe „Node.js 18 oder höher” in vielen deutschen Anleitungen steht: Laut npm-Registry verlangt das Paket seit Version 2.1.198 vom 1. Juli 2026 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 eine native Programmdatei lädt und zur Laufzeit gar kein Node benutzt.

Neu ist eine Hürde mit npm 12. Diese Version überspringt ohne eigene Freigabe den Installationsschritt, der die Programmdatei an ihren Platz legt, und claude meldet danach Error: claude native binary not installed. Abhilfe ist der native Installer oder ab npm 12.1 die Freigabe mit npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user. Aktualisiert wird eine npm-Installation mit npm install -g @anthropic-ai/claude-code@latest, von npm update -g rät die Dokumentation ab. Ausdrücklich warnt sie vor sudo npm install -g, weil das Rechteprobleme und ein Sicherheitsrisiko schafft; eine solche Installation kann sich außerdem nicht selbst aktualisieren.

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

— Anthropic, Claude Code Advanced Setup, abgerufen am 12.11.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, jeweils mit einem Kanal stable und einem Kanal latest; die Befehle der Dokumentation richten stable ein. 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

Die Fehlertabelle in Anthropics Dokumentation ist lang geworden. Die folgende Auswahl ordnet die Meldungen, die beim ersten Versuch am häufigsten auftauchen, 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.

Claude Code wieder entfernen

Eine native Installation entfernst du unter macOS, Linux und WSL mit zwei Zeilen:

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

Unter Windows erledigen das in PowerShell Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force und Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force. Bei Homebrew heißt der Befehl brew uninstall --cask claude-code, bei WinGet winget uninstall Anthropic.ClaudeCode. Einstellungen, freigegebene Werkzeuge und den Sitzungsverlauf löschst du getrennt davon im Ordner ~/.claude und in der Datei ~/.claude.json. Die VS-Code-Erweiterung, das JetBrains-Plugin und die Desktop-App schreiben ebenfalls nach ~/.claude und legen den Ordner beim nächsten Start neu an. Wer Claude Code ganz loswerden will, entfernt sie deshalb zuerst.

Der Update-Takt: 22 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: Claude Code prüft beim Start und während der Arbeit auf neue Versionen, lädt sie herunter und nutzt sie ab dem nächsten Start. Mit claude update holst du eine neue Version sofort.

Wir messen den Takt bei jedem Update dieser Anleitung auf dem Auslieferungsserver von Anthropic und in der npm-Registry. Am 12. November 2026 stand im Kanal latest Version 2.1.322 vom 10. November, im Kanal stable 2.1.311 vom 26. Oktober. Dazwischen liegen 9 veröffentlichte Versionen und 15 Tage. In den 30 Tagen vor der Messung erschienen 22 Versionen, in den letzten sieben Tagen drei. Seit unserer ersten Messung am 15. September sind 45 Versionen dazugekommen.

Daten nach den Zeitstempeln der npm-Registry in UTC.

Zwei Dinge lassen sich daraus ablesen. Erstens: Das Tempo ist etwas gesunken, von rund einer auf rund 0,7 Versionen am Tag. Wer seine Arbeitsplätze auf dem Standardkanal lässt, hat trotzdem jede Woche ein anderes Werkzeug auf dem Rechner. Zweitens: Die Dokumentation beschreibt stable als Version, die „typischerweise etwa eine Woche“ alt ist. Gemessen lagen die beiden Kanäle im September 26 Tage auseinander, im November 15 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 zwei bis vier Wochen Rückstand planen.

Neu steht in der Dokumentation ein Hinweis, der genau diesen Rückstand betrifft: Ein gerade eingeführtes Modell kann eine neuere Claude-Code-Version brauchen, als der Kanal stable liefert. Wer ein neues Modell am Starttag nutzen will, wechselt dafür auf latest.

Gesteuert wird das über die settings.json:

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

autoUpdatesChannel wählt den Kanal, das geht auch über /config unter „Auto-update channel“. 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; wer über /config wechselt, wird gefragt, ob er auf der aktuellen Version bleiben will, und bekommt diesen Boden dann automatisch gesetzt. Wer von Anfang an auf stable starten will, installiert mit curl -fsSL https://claude.ai/install.sh | bash -s stable, der gewählte Kanal gilt danach auch für die Updates. Bei Homebrew entscheidet der Name des Casks über den Kanal und bei den Linux-Paketquellen das Repository, dort wirkt der Schlüssel nicht.

In den verwalteten Einstellungen kommen requiredMinimumVersion und requiredMaximumVersion dazu, die einen Versionskorridor erzwingen, außerhalb dessen Claude Code gar nicht erst startet. Beide brauchen Claude Code 2.1.163 oder neuer und wirken nur in den verwalteten Einstellungen. claude update, claude install und claude doctor laufen auch außerhalb des Korridors, damit sich Nutzer selbst helfen können. Wer die automatische Aktualisierung ganz abschalten will, setzt DISABLE_AUTOUPDATER auf "1", für alle Wege einschließlich manueller Updates DISABLE_UPDATES. Ob das greift, zeigt claude doctor in der Zeile „Auto-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 im September offenließen

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 nannte eine von vier Seiten. Die Windows-Voraussetzung ab Build 1809 ebenfalls eine von vier, eine weitere nannte fälschlich Build 1903. Die Node-Angabe war auf drei von vier Seiten veraltet oder falsch, eine davon führte Node.js 18 sogar als Voraussetzung der nativen Installation, die überhaupt kein Node braucht. Dass Git for Windows optional ist, schrieb keine der vier Seiten. Dass der einzige belegbare Grund für WSL 2 die Sandbox-Ausführung ist, ebenfalls keine; eine Seite empfahl WSL pauschal, weil Claude Code darüber „besser funktioniere”. Die zwei Homebrew-Casks und die signierten Paketquellen tauchten nirgends auf, und Team, Enterprise und Console fehlten in der Aufzählung der Pläne, die Claude Code enthalten.

Der Grund liegt im Tempo: Bei 22 bis 31 Versionen im Monat veraltet eine Anleitung binnen Wochen. Auch unsere eigene Fassung vom September hatte nach acht Wochen zwei überholte Stellen, die macOS-Angabe der Desktop-App und die Liste der Konten ohne Ultra. 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. Wer noch zwischen Claude Code und dem Coding-Agenten von OpenAI abwägt, findet den Vergleich in Codex vs. Claude Code; 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