Claude Code installieren: Anleitung für Mac und Windows (2026)
Claude Code installieren auf Mac oder Windows mit dem offiziellen Installer: anmelden, eine sichere erste Aufgabe starten und die typischen Fehler beheben.
Von Yotam DahanAktualisiert 11 Min. LesezeitClaude Code
Auf dieser Seite
- Bevor du anfängst
- Option 1: die Desktop-App, ganz ohne Terminal
- Option 2: Claude Code auf dem Mac installieren
- Option 3: Claude Code unter Windows installieren
- Zum ersten Mal anmelden
- Eine sichere erste Aufgabe
- Claude Code aktuell halten
- Fehlerbehebung: die Fehler, die wirklich auftreten
- Dein nächster Schritt
Um Claude Code zu installieren, öffnest du auf dem Mac das Terminal oder unter Windows PowerShell, fügst den einzeiligen Installer von Anthropic ein, tippst dann claude und meldest dich im Browser mit einem bezahlten Claude-Konto an. Das dauert ein paar Minuten, und programmieren musst du dafür nicht können. Wenn du nie ein Terminal anfassen willst, installierst du stattdessen die Claude-Desktop-App: Claude Code steckt dort im Code-Tab.
Diese Anleitung folgt der offiziellen Setup-Doku von Anthropic, Stand Oktober 2026. Wenn du noch überlegst, ob du Claude Code überhaupt brauchst, lies zuerst, was Claude Code ist.
Terminal öffnen
Terminal auf dem Mac, PowerShell unter Windows
Installer einfügen
Eine offizielle Zeile von claude.ai
Version prüfen
claude --version zeigt eine Nummer an
Anmelden
claude in einem Projektordner starten und einloggen
Bevor du anfängst
Geh zuerst diese Checkliste durch. Die meisten Installationen scheitern an einem dieser fünf Punkte:
0 von 5 erledigt
Dann wählst du deine Methode:
| Methode | Am besten für | So bleibt sie aktuell |
|---|---|---|
| Nativer Installer (empfohlen) | Die meisten, auf Mac oder Windows | Aktualisiert sich selbst im Hintergrund |
| Claude-Desktop-App | Alle, die nie ein Terminal öffnen wollen | Die App hält ihre eigene Kopie aktuell |
| Homebrew (Mac) | Alle, die Homebrew schon nutzen | Manuell, mit brew upgrade claude-code |
| WinGet (Windows) | Alle, die Apps mit WinGet verwalten | Manuell, mit winget upgrade Anthropic.ClaudeCode |
Option 1: die Desktop-App, ganz ohne Terminal
- Lade die App herunter. Du bekommst sie auf Anthropics Schnellstartseite für die Desktop-App. Die Mac-Version läuft auf Intel und Apple Silicon, für Windows gibt es Versionen für x64 und ARM64, und eine Beta für Ubuntu und Debian installierst du mit apt.
- Installier sie und meld dich an. Öffne Claude und logg dich mit dem Konto ein, das deinen bezahlten Plan hat.
- Öffne den Code-Tab. Fordert er dich zum Upgrade auf, steckt das verwendete Konto im kostenlosen Plan.
- Wähl einen Ordner. Wähle Lokal (Local), klick auf Ordner auswählen (Select folder) und nimm einen leeren Ordner, den du zum Testen angelegt hast.
- Bitte um etwas. Tipp eine Anfrage in das Feld und drück Enter.
Die App hält ihre eigene Kopie von Claude Code aktuell, über Claude > Nach Updates suchen auf dem Mac oder Hilfe > Nach Updates suchen unter Windows (in der englischen Oberfläche heißt der Punkt Check for Updates). Wenn du Hebräisch liest: ai school bietet außerdem einen kostenlosen Ein-Klick-Installer für Mac und Windows an, der die Desktop-App für dich einrichtet.
Option 2: Claude Code auf dem Mac installieren
Schritt 1: Terminal öffnen
Drück Cmd + Leertaste, tipp Terminal und drück Enter. Es öffnet sich ein Fenster mit einem blinkenden Cursor, und dort tippst du Befehle ein.
Schritt 2: den offiziellen Installer ausführen
Kopier diese Zeile, füg sie mit Cmd + V ein und drück Enter:
curl -fsSL https://claude.ai/install.sh | bash
Sie lädt den Installer von Anthropic von claude.ai herunter und führt ihn aus. Eine Weile scheint nichts zu passieren, weil kein Fortschritt angezeigt wird. Lass das Fenster einfach in Ruhe, bis du Claude Code successfully installed! siehst.
Schritt 3: prüfen, ob es geklappt hat
Schließ das Fenster, öffne ein neues Terminalfenster, damit es das neue Programm findet, und führ das hier aus:
claude --version
Eine Versionsnummer gefolgt von (Claude Code) heißt: Du bist startklar. Siehst du stattdessen command not found: claude, spring zur Tabelle mit den Fehlerlösungen weiter unten.
Option 3: Claude Code unter Windows installieren
Schritt 1 (optional): Git for Windows installieren
Git for Windows gibt Claude Code eine Bash-Shell, in der er Befehle ausführen kann. Ohne Git nutzt Claude Code stattdessen PowerShell, und das reicht den meisten Einsteigern völlig. Wenn du Git installierst, klick dich in jedem Fenster mit Next durch: Die Standardeinstellungen, inklusive der empfohlenen PATH-Option, sind genau das, was du brauchst.
Schritt 2: PowerShell öffnen
Drück Win + X und wähle Windows PowerShell oder Terminal. Prüf, dass jede Zeile mit PS C:\ beginnt. Steht dort nur C:\ ohne PS, bist du in der Eingabeaufforderung (Command Prompt), und die braucht einen anderen Befehl.
Schritt 3: den offiziellen Installer ausführen
Füg diese Zeile mit Strg + V oder per Rechtsklick ein und drück Enter:
irm https://claude.ai/install.ps1 | iex
irm lädt den Installer herunter und iex führt ihn aus. Du musst PowerShell nicht als Administrator starten, und du bist fertig, wenn du Claude Code successfully installed! siehst.
Falls du stattdessen in der Eingabeaufforderung bist, nimm diese Version:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Schritt 4: prüfen, ob es geklappt hat
Öffne ein neues PowerShell-Fenster und führ claude --version aus. Eine Versionsnummer heißt: Du bist startklar.
Zum ersten Mal anmelden
Leg einen Testordner an und starte Claude Code darin. Ein eigener Ordner ist wichtig, weil Claude Code alles in dem Ordner lesen kann, in dem du ihn startest.
Auf dem Mac:
mkdir -p ~/claude-projects/first-test
cd ~/claude-projects/first-test
claude
Unter Windows, in PowerShell:
mkdir -Force "$HOME\claude-projects\first-test"
cd "$HOME\claude-projects\first-test"
claude
Dann passiert Folgendes:
- Einrichtung und Browser. Claude Code führt eine kurze Ersteinrichtung durch und öffnet deinen Browser zur Anmeldung.
- Anmelden. Nimm das Konto mit deinem bezahlten Plan. Wenn sich der Browser nicht öffnet, drück
c, um den Login-Link zu kopieren, und füg ihn selbst im Browser ein. - Bestätigen. Wenn das Terminal
Login successfulzeigt, drück Enter. - Dem Ordner vertrauen. Claude Code fragt, ob du diesem Ordner vertraust. Du hast ihn gerade selbst angelegt, also stimm zu.
- Loslegen. Das Eingabefeld von Claude Code erscheint, darüber stehen Version, Modell und Ordner. Tipp
/help, um die Befehle zu sehen.
Eine sichere erste Aufgabe
Fang mit einer Frage an, die nichts verändert:
Welche Dateien liegen in diesem Ordner, und bei welchen Aufgaben könntest du mir hier helfen? Leg noch nichts an und ändere nichts.Dann eine winzige Änderung, die du sehen kannst:
Erstelle eine Datei namens hello.html: eine einfache Seite mit der Überschrift „Meine erste Claude-Code-Seite“ und einem kurzen Absatz, der erklärt, was du gerade gemacht hast. Sag mir dann, wie ich sie öffne.Aktuelle Versionen starten Terminal-Sitzungen im Auto-Modus. Dort prüft ein Sicherheitscheck im Hintergrund jede Aktion, statt dich zu fragen. Solange du lernst, drückst du Shift+Tab, bis die Zeile unter dem Eingabefeld manual mode on zeigt. Dann fragt Claude Code vor jeder Datei, die er anlegt, und vor jedem Befehl, den er ausführt.
Lies jede Anfrage und wähle Yes, wenn sie zu deiner Bitte passt. Wenn er fertig ist, öffnest du hello.html per Doppelklick im Finder oder Datei-Explorer in deinem Browser.
Claude Code aktuell halten
- Native Installationen aktualisieren sich selbst im Hintergrund. Die neue Version greift beim nächsten Start von Claude Code.
claude updateinstalliert die neueste Version sofort.claude doctormacht einen reinen Lese-Check deiner Installation und Einstellungen, ohne eine Sitzung zu starten.- Installationen über Homebrew und WinGet aktualisieren sich nicht selbst. Nutze die Upgrade-Befehle aus der Tabelle mit den Methoden.
Fehlerbehebung: die Fehler, die wirklich auftreten
Such die Meldung, die du siehst, und nimm die passende Lösung. Die Liste stammt von Anthropics Seite zur Fehlerbehebung bei der Installation, die auch seltenere Fälle aufführt. Unter einem deutschen Windows zeigen PowerShell und die Eingabeaufforderung ihre eigenen Meldungen auf Deutsch an, etwa Die Benennung "claude" wurde nicht als Name eines Cmdlet ... erkannt statt 'claude' is not recognized. Die Lösung bleibt dieselbe.
| Was du siehst | Was es bedeutet | Lösung |
|---|---|---|
zsh: command not found: claude (Mac) | Die Installation hat geklappt, aber dein Terminal findet das Programm noch nicht | Öffne ein neues Terminalfenster. Klappt es immer noch nicht? Führ die PATH-Zeilen für den Mac unten aus |
'claude' is not recognized (Windows) | Dasselbe Problem unter Windows | Öffne ein neues Fenster. Klappt es immer noch nicht? Führ die PATH-Zeilen für Windows unten aus |
syntax error near unexpected token '<' | Die Installationsadresse hat eine Webseite statt des Installers geschickt | Versuch es in ein paar Minuten noch einmal. Steht in der Ausgabe „App unavailable in region“, wird Claude Code in deinem Land nicht angeboten. Sonst installierst du mit Homebrew oder WinGet |
curl: (22) The requested URL returned error: 403 | Ein Netzwerkfilter, ein Proxy oder eine Ländersperre | Probier ein anderes Netzwerk oder bitte deine IT, Downloads von downloads.claude.ai zu erlauben |
'irm' is not recognized | Du bist in der Eingabeaufforderung, nicht in PowerShell | Öffne PowerShell oder nimm die Installationszeile für die Eingabeaufforderung |
The token '&&' is not a valid statement separator | Du hast die Zeile für die Eingabeaufforderung in PowerShell ausgeführt | Nimm die PowerShell-Zeile aus Schritt 3 |
A parameter cannot be found that matches parameter name 'fsSL' | Du hast den Mac-Befehl in PowerShell eingefügt | Nimm die PowerShell-Zeile aus Schritt 3 |
Claude Code does not support 32-bit Windows | Du hast Windows PowerShell (x86) geöffnet | Schließ es und öffne Windows PowerShell ohne „(x86)“ |
Claude Code on Windows requires either Git for Windows (for bash) or PowerShell | Er hat keine der beiden Shells gefunden | Installier Git for Windows und wähl dabei „Add to PATH“ |
Could not create SSL/TLS secure channel | Eine ältere Windows-10-Installation nutzt kein TLS 1.2 | Führ [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 aus und dann im selben Fenster den Installer |
dyld: cannot load oder Symbol not found (Mac) | Dein macOS ist älter als Version 13 | Aktualisier macOS und führ den Installer noch einmal aus |
OAuth error: Invalid code | Der Login-Code ist abgelaufen oder wurde abgeschnitten | Drück Enter für einen neuen Versuch und schließ den Schritt im Browser zügig ab |
API Error: 403 Request not allowed | Dieses Konto hat keinen aktiven bezahlten Plan | Prüf deinen Plan unter claude.ai/settings und führ dann /login aus |
Credit balance is too low, obwohl du ein Abo hast | Claude Code nutzt einen API-Schlüssel statt deines Plans | Führ /status aus, entferne ANTHROPIC_API_KEY aus deiner Umgebung, starte neu und führ /login aus |
Um den PATH auf dem Mac zu reparieren, der standardmäßig die Zsh-Shell nutzt, führst du diese zwei Zeilen aus und öffnest dann ein neues Fenster:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Um den PATH unter Windows zu reparieren, führst du diese zwei Zeilen in PowerShell aus, schließt PowerShell und öffnest es neu:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
Wenn claude --version funktioniert, aber etwas anderes nicht rund läuft, führ claude doctor aus und lies die Warnungen. Zu jeder gibt es einen Lösungsvorschlag.
Kurzer Check0 von 3 richtig
Du fügst die Installationszeile unter Windows ein, und die Meldung sagt, dass irm nicht erkannt wird. Was ist passiert?
Nicht ganz.
irm ist ein PowerShell-Befehl. Öffne PowerShell oder nimm stattdessen die Installationszeile für die Eingabeaufforderung.
Die Installation ist fertig, aber dein Mac meldet „command not found: claude“. Was probierst du zuerst?
Nicht ganz.
Ein Fenster, das schon offen war, behält seinen alten PATH. Findet auch ein neues Fenster das Programm nicht, nimmst du ~/.local/bin in deinen PATH auf.
Warum startest du Claude Code in einem eigenen Projektordner?
Nicht ganz.
Ein kleiner Projektordner hält deine übrigen Dateien außer Reichweite, und anders als beim Benutzerordner wird das Vertrauen für ihn gespeichert.
Dein nächster Schritt
Verbring deine erste Stunde mit kleinen, sicheren Aufgaben, damit du die Steuerung kennst, bevor du Claude Code auf etwas Wichtiges loslässt. Das Claude-Code-Tutorial für Einsteiger führt dich durch ein komplettes erstes Projekt, und die Anleitung zur CLAUDE.md-Datei zeigt, wie du deine Vorlieben speicherst, damit du sie nicht ständig wiederholst. Lass den Claude-Code-Spickzettel für Befehle und Tastenkürzel in einem Tab offen. Und wenn du den ganzen Weg an einem Ort willst: Der Claude-Code-Kurs beginnt mit der Installation und endet mit Projekten, die du in deinem Unternehmen nutzen kannst.
Prompt-Paket für deine erste Woche zum Kopieren
12 Prompts für deine erste Woche mit Claude Code, von sicheren Fragen, die nur lesen, bis zu einem kleinen Projekt, jeweils mit dem, was du in der Antwort prüfst.
Gib deine E-Mail ein und der ganze Abschnitt öffnet sich direkt hier. Dazu bekommst du eine kostenlose Lektion aus dem Kurs.
Häufige Fragen
Brauche ich Administratorrechte, um Claude Code zu installieren?
Nein. Der native Installer legt Claude Code in deinem eigenen Benutzerordner ab (~/.local/bin auf dem Mac, %USERPROFILE%\.local\bin unter Windows). Du musst ihn also weder als Administrator ausführen noch sudo verwenden.
Wie deinstalliere ich Claude Code?
Bei einer nativen Installation auf dem Mac führst du im Terminal rm -f ~/.local/bin/claude und danach rm -rf ~/.local/share/claude aus. Unter Windows löschst du claude.exe aus %USERPROFILE%\.local\bin und den Ordner %USERPROFILE%\.local\share\claude. Installationen über Homebrew und WinGet entfernst du mit brew uninstall --cask claude-code oder winget uninstall Anthropic.ClaudeCode.
Kann ich Claude Code auch mit npm installieren?
Ja. npm install -g @anthropic-ai/claude-code installiert dasselbe Programm, wenn du Node.js 22 oder neuer hast. Anthropic empfiehlt aber den nativen Installer, der sich selbst aktualisiert, und den npm-Befehl solltest du nie mit sudo ausführen.
Läuft Claude Code auch unter Linux?
Ja. Anthropic unterstützt Ubuntu ab 20.04, Debian ab 10 und Alpine Linux ab 3.19, entweder mit demselben curl-Befehl wie auf dem Mac oder mit signierten apt-, dnf- und apk-Paketen.
Wie wechsle ich in Claude Code zu einem anderen Claude-Konto?
Tipp in Claude Code /login, um dich mit einem anderen Konto anzumelden, oder /logout, um dich ganz abzumelden, damit der nächste Start wieder nach der Anmeldung fragt. Wenn du ein Arbeits- und ein Privatkonto parallel nutzen willst, zeigt die Doku von Anthropic zur Authentifizierung, wie jedes Konto einen eigenen Konfigurationsordner bekommt.
Weiterlesen
Was ist Claude Code? Der KI-Agent einfach erklärt (2026)
Was ist Claude Code? Der KI-Agent von Anthropic einfach erklärt: worauf er auf deinem Computer zugreift, was er kostet und 6 Aufgaben, die er gut erledigt.
Claude Code · 10 Min. LesezeitClaude-Code-Tutorial: Dein erstes Projekt am Wochenende (2026)
Claude-Code-Tutorial für Einsteiger: Bau eine Website für ein lokales Geschäft und lerne Berechtigungen, Plan-Modus, Rückgängig und 10 Zeitspar-Tipps.
Claude Code · 10 Min. Lesezeit