Claude Code installieren dauert auf einem aktuellen Rechner wenige Minuten: ein Befehl im Terminal, danach die Anmeldung im Browser. Ich zeige dir hier die Befehle für Mac, Windows und Linux genau so, wie sie Ende Oktober 2026 in der offiziellen Dokumentation von Anthropic stehen. Dazu kommen die Alternativen über Homebrew, WinGet, npm und die Desktop-App, die Anmeldung, das Update und die Deinstallation.
Danach geht es um die ersten Schritte im Projekt (Git, CLAUDE.md, Rechte-Stufen) und um die häufigsten Fehler samt Lösung.
Was ist Claude Code?
Claude Code ist ein Coding-Agent von Anthropic. Laut Dokumentation liest er deine Codebasis, bearbeitet Dateien, führt Befehle aus und arbeitet mit deinen Entwicklungswerkzeugen zusammen. Anders als im Chatfenster arbeitet Claude Code direkt in deinem Projektordner. Du beschreibst eine Aufgabe, der Agent sucht die passenden Dateien, schlägt Änderungen vor und setzt sie um.
Claude Code gibt es im Terminal, als Desktop-App, im Browser und als Erweiterung für Entwicklungsumgebungen wie VS Code und JetBrains. Hier geht es um das Terminal, das den vollen Funktionsumfang hat, und um die Desktop-App.
Voraussetzungen: System, Abo und Konto
Die Systemanforderungen laut offizieller Dokumentation:
| Bereich | Anforderung |
|---|---|
| Betriebssystem | macOS 13.0, Windows 10 ab Version 1809, Windows Server 2019, Ubuntu 20.04, Debian 10 oder Alpine Linux 3.19, jeweils oder neuer |
| Hardware | mindestens 4 GB Arbeitsspeicher, Prozessor mit x64 oder ARM64 |
| Shell | Bash, Zsh, PowerShell oder CMD |
| Netzwerk | Internetverbindung, Standort in einem von Anthropic unterstützten Land |
| Node.js | nur für die Installation über npm, dann Version 22 oder neuer |
Dazu brauchst du ein passendes Konto. Claude Code setzt ein Abo Pro, Max, Team oder Enterprise voraus oder ein Konto in der Claude Console, also API-Zugang mit vorab gekauftem Guthaben. Der kostenlose Tarif von claude.ai enthält Claude Code nicht. Unternehmen mit eigenem Cloud-Vertrag können Claude Code auch über Amazon Bedrock oder Google Cloud nutzen. Was die Tarife kosten und welcher zu dir passt, steht im Beitrag zu den Kosten von Claude.
Für den Einstieg empfehle ich, wie die Dokumentation, ein Abo statt der Console: fester Betrag, kein Guthaben im Blick behalten.
Claude Code installieren auf macOS und Linux
Anthropic empfiehlt den nativen Installer. Er lädt ein fertiges Programm herunter, braucht kein Node.js und hält Claude Code im Hintergrund aktuell. Öffne das Terminal (auf dem Mac über Spotlight, Suchbegriff „Terminal“) und füge diesen Befehl ein:
curl -fsSL https://claude.ai/install.sh | bashDer Befehl zeigt keinen Fortschritt an, das ist normal. Öffne danach ein neues Terminalfenster und prüfe die Installation:
claude --versionErscheint eine Versionsnummer mit dem Zusatz „(Claude Code)“, hat alles geklappt. Im npm-Verzeichnis ist Ende Oktober 2026 die Version 2.1.312 vom 27. Oktober als aktuellste markiert. Der Installer legt das Programm unter ~/.local/bin/claude ab. Meldet das Terminal, dass claude nicht gefunden wird, fehlt dieser Ordner im Suchpfad. Die Lösung steht weiter unten bei den Fehlern.
Derselbe Befehl gilt auch für WSL, das Linux-Subsystem unter Windows.
Claude Code unter Windows installieren
Unter Windows hast du zwei Wege: Claude Code direkt unter Windows oder innerhalb von WSL. Für die native Installation brauchst du keine Administratorrechte. Wichtig ist nur, dass du den Befehl für die richtige Shell nimmst. Steht vor deiner Eingabezeile PS C:\, bist du in der PowerShell. Steht dort nur C:\, ist es die Eingabeaufforderung CMD.
In der PowerShell:
irm https://claude.ai/install.ps1 | iexIn der Eingabeaufforderung CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdInstalliere außerdem Git for Windows. Die Dokumentation empfiehlt das, weil Claude Code dann die mitgelieferte Git Bash für Befehle nutzt. Ohne Git for Windows weicht Claude Code auf die PowerShell aus.
Wann WSL die bessere Wahl ist:
| Variante | Voraussetzung | Sandbox | Passt für |
|---|---|---|---|
| Windows nativ | keine, Git for Windows optional | nein | Projekte und Werkzeuge, die unter Windows laufen |
| WSL 2 | WSL 2 aktiviert | ja | Linux-Werkzeuge und abgeschottete Befehlsausführung |
| WSL 1 | WSL 1 aktiviert | nein | nur, wenn WSL 2 nicht verfügbar ist |
In WSL öffnest du deine Linux-Distribution und führst dort den Linux-Befehl von oben aus. Gestartet wird Claude Code dann ebenfalls im WSL-Terminal, nicht in der PowerShell.
Weitere Wege: Homebrew, WinGet, npm und Linux-Paketmanager
| Weg | Befehl | Updates |
|---|---|---|
| Homebrew (Mac) | brew install --cask claude-code | manuell |
| WinGet (Windows) | winget install Anthropic.ClaudeCode | manuell |
| npm | npm install -g @anthropic-ai/claude-code | automatisch, wenn der globale npm-Ordner beschreibbar ist |
| apt, dnf, apk | über signierte Paketquellen von Anthropic | mit dem normalen Systemupdate |
Bei Homebrew gibt es zwei Varianten. claude-code folgt dem stabilen Kanal, der meist etwa eine Woche hinterherläuft und Versionen mit größeren Fehlern überspringt. claude-code@latest bekommt jede neue Version sofort. Für npm brauchst du Node.js 22 oder neuer. Installiere nie mit sudo npm install -g, davor warnt Anthropic ausdrücklich wegen Rechteproblemen und Sicherheitsrisiken.
Meine Empfehlung: Nimm den nativen Installer, außer du verwaltest auf deinem Rechner ohnehin alles über Homebrew oder WinGet. Dann musst du selbst an die Updates denken. Die Paketquellen für apt, dnf und apk lohnen sich auf zentral verwalteten Servern, die Befehle stehen in der Setup-Dokumentation.
Claude Code Desktop: ohne Terminal
Wer nicht im Terminal arbeiten will, nimmt die Desktop-App von Claude. Claude Code steckt dort im Tab „Code“ oben in der Seitenleiste. Laut Dokumentation bringt die App Claude Code mit, du brauchst weder Node.js noch die Kommandozeile.
- macOS. Eine Version für Intel und Apple Silicon.
- Windows. Ein Installer für x64 und ein eigener für ARM64.
- Linux. Als Beta über apt oder als .deb-Paket für Ubuntu und Debian.
Nach der Installation meldest du dich an, öffnest den Tab „Code“, wählst unter dem Eingabefeld die Umgebung „Local“ und über „Open folder…“ deinen Projektordner. Für den Code-Tab brauchst du ein Abo Pro, Max, Team oder Enterprise. Sitzungen können auch in der Cloud, per SSH auf einem eigenen Server oder unter Windows in WSL laufen.
Für Einsteiger ist die App der angenehmere Start, weil du Änderungen als Diff siehst und per Klick freigibst.
Erster Start und Anmeldung
Wechsle im Terminal in deinen Projektordner und starte Claude Code:
cd /pfad/zu/deinem/projekt
claudeBeim ersten Start fragt Claude Code nach der Anmeldung und öffnet den Browser. Zur Wahl stehen:
- Claude-Abo. Pro, Max, Team oder Enterprise, du meldest dich mit deinem normalen Claude-Konto an.
- Claude Console. API-Zugang mit vorab gekauftem Guthaben, abgerechnet nach Verbrauch. Beim ersten Login legt die Console automatisch einen Arbeitsbereich „Claude Code“ an, damit du die Kosten getrennt siehst.
- Cloud-Anbieter. Amazon Bedrock, Google Cloud und weitere, gedacht für Unternehmen mit bestehendem Cloud-Vertrag.
Die Anmeldung bleibt gespeichert. Mit /login wechselst du das Konto, /status zeigt die aktive Anmeldung.
Auf einem Server ohne Browser, per SSH oder in WSL drückst du an der Login-Abfrage c, um den Link zu kopieren. Öffne ihn im Browser deines eigenen Rechners und füge den angezeigten Code im Terminal ein. Alternativ geht das mit claude auth login. Wie du Claude Code dauerhaft auf einem eigenen Server betreibst, zeigt Claude Code auf einem VPS einrichten.
Claude Code Installation prüfen: claude --version und claude doctor
claude --version zeigt nur die Versionsnummer. Gründlicher ist dieser Befehl:
claude doctorEr startet keine Sitzung, sondern prüft Installation und Einstellungsdateien und zeigt Warnungen mit Lösungsvorschlägen sowie das Ergebnis des letzten Update-Versuchs. Wenn etwas nicht rund läuft, ist das mein erster Befehl.
Claude Code Update: so bleibst du aktuell
Die native Installation aktualisiert sich selbst. Claude Code sucht beim Start und regelmäßig während der Arbeit nach neuen Versionen, lädt sie im Hintergrund und nutzt sie ab dem nächsten Start. Sofort aktualisieren kannst du so:
claude updateEs gibt zwei Kanäle. „latest“ ist die Voreinstellung und liefert neue Funktionen sofort. „stable“ liefert eine Version, die meist etwa eine Woche alt ist, und überspringt Versionen mit größeren Fehlern. Im npm-Verzeichnis ist Ende Oktober 2026 die Version 2.1.308 als stable markiert. Umstellen kannst du den Kanal in Claude Code über /config oder in der Datei settings.json:
{
"autoUpdatesChannel": "stable"
}Arbeiten in deinem Betrieb mehrere Leute mit Claude Code, empfehle ich stable. Der Haken: Ein neues Modell kann eine neuere Version voraussetzen, dann wechselst du kurz auf latest.
Homebrew, WinGet und die Linux-Paketmanager aktualisieren sich standardmäßig nicht. Je nach Installationsweg nimmst du einen dieser Befehle:
brew upgrade claude-code
winget upgrade Anthropic.ClaudeCode
npm install -g @anthropic-ai/claude-code@latestBei npm rät Anthropic von npm update -g ab, weil das nicht unbedingt auf die neueste Version springt.
Die ersten Schritte im Projekt
- Git einrichten, bevor der Agent loslegt. Claude Code ändert Dateien. Mit Git siehst du jede Änderung und kannst sie zurückdrehen. Läuft dein Projekt noch ohne Versionskontrolle, ist das der erste Schritt. Warum, steht in Git für KI-Agenten.
- Mit /init eine CLAUDE.md anlegen. Tippe in der Sitzung
/init. Claude analysiert die Codebasis und schreibt eine CLAUDE.md mit Build-Befehlen, Testanweisungen und den Konventionen, die es findet. Gibt es die Datei schon, schlägt/initVerbesserungen vor, statt sie zu überschreiben. Ergänze danach, was Claude nicht selbst herausfinden kann: wer die Software nutzt, was nie geändert werden darf, wie ihr Dinge benennt. Anthropic empfiehlt, unter 200 Zeilen pro Datei zu bleiben. Längere Dateien kosten Kontext und werden schlechter befolgt. - Erst lesen lassen, dann ändern. Frag zum Einstieg „Was macht dieses Projekt?“. Claude Code liest die nötigen Dateien selbst, du musst nichts hineinkopieren.
- Die Rechte-Stufe bewusst wählen. Dazu gleich mehr.
Die Rechte-Stufen von Claude Code
Wie viel Claude Code ohne Rückfrage tun darf, regelt der Permission Mode. Mit Shift+Tab wechselst du ihn während der Sitzung, die Statuszeile zeigt den aktiven Modus.
| Modus | Was ohne Rückfrage läuft |
|---|---|
| Manual | nur Lesen; vor Änderungen, Befehlen und Netzwerkzugriff fragt Claude |
| Edit automatically | Lesen, Dateiänderungen und einfache Dateibefehle im Projektordner |
| Plan | nur Recherche und Lesen; Änderungen erst, wenn du den Plan freigibst |
| Auto | alles, ein separates Prüfmodell bewertet jede Aktion vorher |
| Bypass permissions | alles ohne Prüfung; laut Anthropic nur für abgeschottete Container und virtuelle Maschinen |
Seit Version 2.1.283 startet eine Sitzung im Terminal standardmäßig im Auto-Modus. Das ist bequem: Das Prüfmodell blockiert riskante Aktionen, statt dich zu fragen, und geschützte Pfade wie .git oder .claude gibt es nie automatisch frei. Trotzdem empfehle ich für die ersten Sitzungen in einem echten Firmenprojekt den Plan-Modus:
claude --permission-mode planSo siehst du zuerst, was Claude vorhat, und lernst, wie der Agent eine Aufgabe zerlegt. Wenn du danach tiefer einsteigen willst, helfen dir die wichtigsten Claude-Code-Befehle und der Beitrag über Mods in Claude Code.
Häufige Fehler und ihre Lösung
„command not found: claude“ nach der Installation
Der Installer hat Claude Code abgelegt, aber der Ordner fehlt im Suchpfad (PATH). Auf dem Mac mit Zsh, der Standard-Shell, behebst du das so:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcUnter Linux mit Bash schreibst du dieselbe Zeile in ~/.bashrc. Unter Windows ergänzt du in der PowerShell den Benutzer-PATH:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')Danach immer ein neues Terminal öffnen. Ein Terminal innerhalb eines Editors übernimmt den Pfad vom Editor, dann startest du den Editor neu.
„irm is not recognized“ oder „The token '&&' is not a valid statement separator“
Falsche Shell. Die erste Meldung heißt: Du bist in CMD und hast den PowerShell-Befehl genommen. Die zweite heißt: Du bist in der PowerShell und hast den CMD-Befehl genommen. Nimm den passenden Befehl aus dem Windows-Abschnitt.
„syntax error near unexpected token '<'“ oder Fehler 403
Statt des Installationsskripts kam eine Webseite oder eine Fehlermeldung zurück. Mögliche Ursachen laut Anthropic: Claude Code ist in deinem Land nicht verfügbar, ein Proxy oder eine Firewall blockiert den Download, oder es gibt eine kurze Störung. Warte ein paar Minuten und versuch es erneut. Als Ausweg nennt die Dokumentation Homebrew auf dem Mac und WinGet unter Windows.
Firmennetz mit Proxy
Hinter einem Proxy setzt du vor der Installation beide Proxy-Variablen. Die echte Adresse bekommst du von deiner IT:
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash„Killed“ bei der Installation auf einem kleinen Server
Dem Server ist der Arbeitsspeicher ausgegangen. Die Installation braucht rund 512 MB freien Speicher, der Betrieb laut Systemanforderungen mindestens 4 GB. Abhilfe schafft eine Swap-Datei oder ein größerer Server.
„This organization has been disabled“ trotz aktivem Abo
Ist noch die Variable ANTHROPIC_API_KEY aus einem alten Projekt gesetzt und hast du sie beim Start bestätigt, nutzt Claude Code diesen Schlüssel statt deines Abos. Entferne die Variable mit unset ANTHROPIC_API_KEY und lösche die passende Zeile aus ~/.zshrc, ~/.bashrc oder ~/.profile.
Claude Code deinstallieren
Für die native Installation auf Mac, Linux und WSL:
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claudeUnter Windows in der PowerShell:
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -ForceBei den anderen Wegen nimmst du den Befehl des jeweiligen Paketmanagers: brew uninstall --cask claude-code, winget uninstall Anthropic.ClaudeCode oder npm uninstall -g @anthropic-ai/claude-code.
Einstellungen, MCP-Server und Sitzungsverlauf liegen in ~/.claude und ~/.claude.json. Lösch sie nur, wenn du wirklich alles entfernen willst.
Häufige Fragen
Ist Claude Code kostenlos?
Nein. Du brauchst ein Abo Pro, Max, Team oder Enterprise oder ein Console-Konto mit Guthaben. Der kostenlose Tarif enthält Claude Code nicht.
Brauche ich Node.js für Claude Code?
Nur bei der Installation über npm, dann in Version 22 oder neuer. Der native Installer, Homebrew, WinGet und die Desktop-App kommen ohne Node.js aus.
Läuft Claude Code unter Windows ohne WSL?
Ja. Claude Code läuft nativ ab Windows 10 Version 1809, installiert über PowerShell, CMD oder WinGet. Git for Windows ist empfohlen. WSL 2 brauchst du nur für Linux-Werkzeuge oder die Sandbox.
Wie mache ich ein Claude Code Update?
Die native Installation aktualisiert sich selbst, sofort geht es mit claude update. Homebrew und WinGet aktualisierst du mit deren Upgrade-Befehl.
Was ist der Unterschied zwischen Claude Code und Claude Desktop?
Die Desktop-App enthält Claude Code im Tab „Code“, mit grafischer Oberfläche und Diff-Ansicht. Den Befehl claude fürs Terminal installierst du separat. Beides kannst du nebeneinander am selben Projekt nutzen.
Fazit
Claude Code installieren ist meist ein einziger Befehl. Nimm den nativen Installer, dann kümmert sich Claude Code selbst um Updates. Wer kein Terminal mag, startet mit der Desktop-App. Prüf danach mit claude doctor, leg mit /init eine CLAUDE.md an und arbeite die ersten Sitzungen im Plan-Modus in einem Projekt unter Git.
Die Installation ist der leichte Teil. Schwieriger ist, Claude Code so einzusetzen, dass am Ende wartbare Software entsteht. Wenn du das nicht selbst aufbauen willst, übernehme ich das in der KI-gestützten Softwareentwicklung. Soll dein Team lernen, sauber mit Claude Code zu arbeiten, passt ein KI-Workshop.
Quellen: Systemanforderungen, Installationsbefehle, Git for Windows, WSL, Homebrew, WinGet, npm und Node.js 22, Linux-Paketquellen, Auto-Update, Kanäle latest und stable, claude doctor, Kontoarten und Deinstallation nach der Setup-Dokumentation von Claude Code. Erster Start, Anmeldung, Console-Arbeitsbereich und Abo als empfohlene Anmeldung nach dem Quickstart. PATH, falsche Shell, Fehler 403, Proxy, Speicherbedarf bei der Installation, Login per SSH und Konflikt mit ANTHROPIC_API_KEY nach Troubleshoot installation and login. Rechte-Stufen und Auto-Modus als Standard ab Version 2.1.283 nach Permission modes. /init und Empfehlung unter 200 Zeilen nach How Claude remembers your project. Desktop-App nach Get started with the desktop app. Beschreibung von Claude Code nach der Übersicht. Versionen 2.1.312 (latest, 27. Oktober 2026) und 2.1.308 (stable) nach dem npm-Verzeichnis, abgerufen am 29. Oktober 2026. Stand: Oktober 2026.