Zum Inhalt springen

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
  1. Bevor du anfängst
  2. Option 1: die Desktop-App, ganz ohne Terminal
  3. Option 2: Claude Code auf dem Mac installieren
  4. Option 3: Claude Code unter Windows installieren
  5. Zum ersten Mal anmelden
  6. Eine sichere erste Aufgabe
  7. Claude Code aktuell halten
  8. Fehlerbehebung: die Fehler, die wirklich auftreten
  9. 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.

Die ganze Installation in vier Schritten
  1. Terminal öffnen

    Terminal auf dem Mac, PowerShell unter Windows

  2. Installer einfügen

    Eine offizielle Zeile von claude.ai

  3. Version prüfen

    claude --version zeigt eine Nummer an

  4. 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:

MethodeAm besten fürSo bleibt sie aktuell
Nativer Installer (empfohlen)Die meisten, auf Mac oder WindowsAktualisiert sich selbst im Hintergrund
Claude-Desktop-AppAlle, die nie ein Terminal öffnen wollenDie App hält ihre eigene Kopie aktuell
Homebrew (Mac)Alle, die Homebrew schon nutzenManuell, mit brew upgrade claude-code
WinGet (Windows)Alle, die Apps mit WinGet verwaltenManuell, mit winget upgrade Anthropic.ClaudeCode

Option 1: die Desktop-App, ganz ohne Terminal

  1. 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.
  2. Installier sie und meld dich an. Öffne Claude und logg dich mit dem Konto ein, das deinen bezahlten Plan hat.
  3. Öffne den Code-Tab. Fordert er dich zum Upgrade auf, steckt das verwendete Konto im kostenlosen Plan.
  4. 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.
  5. 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:

Terminal
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:

Terminal
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:

PowerShell
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:

Command Prompt
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:

Terminal
mkdir -p ~/claude-projects/first-test
cd ~/claude-projects/first-test
claude

Unter Windows, in PowerShell:

PowerShell
mkdir -Force "$HOME\claude-projects\first-test"
cd "$HOME\claude-projects\first-test"
claude

Dann passiert Folgendes:

  1. Einrichtung und Browser. Claude Code führt eine kurze Ersteinrichtung durch und öffnet deinen Browser zur Anmeldung.
  2. 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.
  3. Bestätigen. Wenn das Terminal Login successful zeigt, drück Enter.
  4. Dem Ordner vertrauen. Claude Code fragt, ob du diesem Ordner vertraust. Du hast ihn gerade selbst angelegt, also stimm zu.
  5. 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:

Erste Frage, ändert nichts
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:

Erste sichtbare Änderung
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 update installiert die neueste Version sofort.
  • claude doctor macht 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 siehstWas es bedeutetLö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 geschicktVersuch 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: 403Ein Netzwerkfilter, ein Proxy oder eine LändersperreProbier ein anderes Netzwerk oder bitte deine IT, Downloads von downloads.claude.ai zu erlauben
'irm' is not recognizedDu bist in der Eingabeaufforderung, nicht in PowerShellÖffne PowerShell oder nimm die Installationszeile für die Eingabeaufforderung
The token '&&' is not a valid statement separatorDu hast die Zeile für die Eingabeaufforderung in PowerShell ausgeführtNimm die PowerShell-Zeile aus Schritt 3
A parameter cannot be found that matches parameter name 'fsSL'Du hast den Mac-Befehl in PowerShell eingefügtNimm die PowerShell-Zeile aus Schritt 3
Claude Code does not support 32-bit WindowsDu hast Windows PowerShell (x86) geöffnetSchließ es und öffne Windows PowerShell ohne „(x86)“
Claude Code on Windows requires either Git for Windows (for bash) or PowerShellEr hat keine der beiden Shells gefundenInstallier Git for Windows und wähl dabei „Add to PATH“
Could not create SSL/TLS secure channelEine ältere Windows-10-Installation nutzt kein TLS 1.2Fü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 13Aktualisier macOS und führ den Installer noch einmal aus
OAuth error: Invalid codeDer Login-Code ist abgelaufen oder wurde abgeschnittenDrück Enter für einen neuen Versuch und schließ den Schritt im Browser zügig ab
API Error: 403 Request not allowedDieses Konto hat keinen aktiven bezahlten PlanPrüf deinen Plan unter claude.ai/settings und führ dann /login aus
Credit balance is too low, obwohl du ein Abo hastClaude Code nutzt einen API-Schlüssel statt deines PlansFü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:

Terminal
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:

PowerShell
$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?

Die Installation ist fertig, aber dein Mac meldet „command not found: claude“. Was probierst du zuerst?

Warum startest du Claude Code in einem eigenen Projektordner?

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.

Kein Spam. Abmeldung mit einem Klick. Wir nutzen deine E-Mail, um dir den Kurs und KI-Tipps zu schicken.

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