Claude Code installieren Windows-Nutzer mit PowerShell, CMD oder WinGet

Claude Code installieren Terminal-Nutzer als Programm für ihre Projekte#

Das Terminal macht fast allen Angst, die ohne Hintergrund in der Softwareentwicklung mit Vibe Coding anfangen. Es sieht aus wie ein schwarzes Fenster aus Hackerfilmen, ist in Wirklichkeit aber nur eine Zeile, in die du Befehle eingibst. Claude Code braucht es genau dafür: Es kann deine Dateien öffnen und ändern sowie Prüfungen selbst ausführen, während du die Aufgabe in Worten beschreibst.

Anthropic beschreibt das Produkt so.

Der Unterschied zu einem gewohnten Chat ist einfach. Im Browser kopierst du den Code von Hand hin und her zwischen dem Fenster und deinem Editor. Claude Code geht selbst in den Projektordner, liest die benötigten Dateien, nimmt die Änderung vor und zeigt dir, was es geändert hat. Du entscheidest und genehmigst weiterhin; die mechanische Arbeit übernimmt es für dich.

Wenn du das Terminal wirklich nicht verwenden möchtest, bietet Anthropic eine Desktop-App mit einem normalen Fenster und eine Webversion unter claude.ai/code, die direkt im Browser läuft. Die leistungsfähigste und flexibelste Option ist jedoch die Terminalversion; um sie geht es in diesem ganzen Artikel.

Wo ist die offizielle Claude-Code-Website, und was solltest du herunterladen?#

Die erste Unklarheit für Einsteiger ist, wo sich die offizielle Claude-Code-Website befindet und worauf man klicken muss, um das Programm herunterzuladen. Hier ist eine Tabelle mit allen offiziellen Anthropic-Adressen, damit du nicht raten musst.

Du lädst keinen Installer von der Website herunter, wie du es von einem gewöhnlichen Programm kennst – das entspricht nicht den Erwartungen. Stattdessen installierst du das Programm mit einem Terminalbefehl, der anschließend die passende Version für dein System herunterlädt. Dieser Artikel enthält die genauen Befehle für Mac, Windows und Linux.

Eine häufige Falle ist der Name: Viele schreiben ihn versehentlich als clode code, clade code, слод код oder clode design. Das Produkt heißt Claude Code, mit au. Denk daran, wenn du nach der offiziellen Website suchst: Domains mit ähnlicher Schreibweise gehören jemand anderem.

Auch der genaue Name des npm-Pakets ist wichtig. Das kanonische Paket heißt @anthropic-ai/claude-code, mit dem Präfix @anthropic-ai/. Anthropic selbst besitzt den kurzen Namen claude-code ohne Präfix – das ist der offizielle Verweis auf dasselbe Paket. Die einfache Regel: Als Herausgeber sollte Anthropic angegeben sein; für die Installation verwendest du den Namen mit Präfix.

Ubuntu Claude Code installieren: Systemanforderungen und Voraussetzungen#

Die Anforderungen von Claude Code sind bescheiden: Die schwere Arbeit erledigen die Server von Anthropic; dein Rechner sendet und empfängt lediglich Anfragen.

Eine gesonderte Anmerkung zu Node.js, denn darum ranken sich die meisten Mythen. Der native Installer – den Anthropic selbst empfiehlt – braucht überhaupt kein Node.js: Er wird als einzelne, eigenständige Datei installiert. Node.js ist nur erforderlich, wenn du Claude Code über npm installierst; dann brauchst du Version 22 oder neuer. In älteren Artikeln steht „Node 18 und neuer“ – das ist veraltet; orientiere dich an 22+.

Für die Hauptversion brauchst du ein Terminal. Wenn du keines verwenden möchtest, installiere die Desktop-App mit ihrem normalen Fenster oder nutze die Webversion unter claude.ai/code. Die Terminalversion bietet weiterhin mehr Funktionen; im Rest dieses Artikels erfährst du, wie du sie installierst.

Claude Code zu installieren ist, als würdest du ein Werkzeug in die Hand bekommen. Für sich genommen halluziniert es jedoch oft: Es vergisst dein Projekt, denkt sich Dinge aus und verliert mitten in einer Aufgabe den Faden. Zuverlässig wird es durch die Kombination aus drei Dingen: einem KI-Klon, einem Second Brain und Context Engineering. Das sind die drei Säulen, die KI vor Halluzinationen bewahren.

Claude Code installieren auf Mac: nativer Installer und Homebrew#

Öffne Terminal (es ist auf jedem Mac vorhanden: Drücke Cmd+Space für Spotlight und gib „Terminal“ ein) und füge diese eine Zeile ein:

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

Der Befehl lädt den Installer von der offiziellen Anthropic-Adresse herunter und installiert Claude Code. Node.js ist nicht erforderlich. Praktisch ist die native Methode auch wegen ihrer Updates.

Wenn du bereits Homebrew verwendest, gibt es eine zweite Möglichkeit:

brew install --cask claude-code

Der Unterschied liegt bei den Updates: Der native Installer aktualisiert sich selbst, Homebrew hingegen nicht – du musst es mit dem Befehl brew upgrade claude-code manuell aktualisieren. Das Programm selbst ist dasselbe; wähle also die Methode, die du gewohnt bist. Wenn du dir unsicher bist, nimm die erste.

Claude Code installieren PowerShell-Nutzer mit dem Windows-Befehl#

Finde zuerst heraus, wo du dich befindest. Windows hat zwei Shells, und jede hat ihren eigenen Befehl. Öffne ein Fenster und sieh dir den Anfang der Eingabeaufforderung an: PS C:\> steht für PowerShell, während C:\> ohne PS die Eingabeaufforderung (CMD) bedeutet.

Für PowerShell (am einfachsten öffnest du sie, indem du mit der rechten Maustaste auf die Schaltfläche „Start“ klickst und „Terminal“ auswählst):

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

Für die Eingabeaufforderung (CMD):

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

Eine dritte Möglichkeit ist der integrierte Paketmanager WinGet:

winget install Anthropic.ClaudeCode

Wenn du bereits eine funktionierende Umgebung in WSL (Linux in Windows) hast, installiere Claude Code direkt in WSL mit demselben Befehl wie unter Linux. Bei WSL gibt es eine Besonderheit mit Node; darauf gehe ich weiter unten im Abschnitt über häufige Fehler ein.

Claude Code installieren Linux-Nutzer mit dem nativen Installer#

Die grundlegende Methode ist für alle gängigen Distributionen dieselbe: der eigenständige Installer:

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

Node.js ist nicht erforderlich; das Programm wird als einzelne Datei bereitgestellt und aktualisiert sich von da an selbst.

Wenn du Programme ausschließlich über den Systempaketmanager installierst, kannst du die offiziellen Anthropic-Repositories hinzufügen: apt für Debian und Ubuntu, dnf für Fedora und RHEL sowie apk für Alpine. Sie sind mit einem Schlüssel signiert und bieten stabile und neueste Kanäle. Für Einsteiger ist das übertrieben aufwendig; die Einzelheiten findest du in der Dokumentation im Quellenabschnitt. Standardmäßig empfehle ich den obigen Befehl.

Auf günstigen Servern kann es einen Stolperstein geben. Wenn der Rechner nur sehr wenig freien Arbeitsspeicher hat, wird die Installation möglicherweise mit dem Wort Killed (Code 137) abgebrochen – das System hat den Prozess beendet, weil der Speicher knapp wurde. Abhilfe schafft eine Swap-Datei: Für die Installation braucht Claude Code etwa 512 MB freien Arbeitsspeicher.

Wie startest du Claude Code zum ersten Mal?#

Der erste Start dauert ein paar Minuten. So läuft er ab.

1. Zum Projektordner wechseln

   Wechsle im Terminal mit dem Befehl cd path-to-project in den Ordner, mit dem du arbeiten möchtest, und gib dann claude ein.

2. Bei deinem Konto anmelden

   Ein Browser mit einem Anmeldefenster wird geöffnet. Falls er sich nicht automatisch öffnet, drücke c, um den Link zu kopieren, und füge ihn manuell in einen Browser ein. Wenn der Browser einen Code anzeigt (das kann bei WSL und auf Remote-Servern vorkommen), füge diesen Code wieder im Terminal ein.

3. Auf die Bestätigung warten

   Nach der Anmeldung zeigt das Terminal Login successful an und fordert dich auf, Enter zu drücken.

4. Deine erste Frage stellen

   Stelle eine einfache Frage zum Projekt, zum Beispiel „Was macht dieses Projekt?“. Claude liest die Dateien und antwortet.

5. Die erste Änderung genehmigen

   Wenn du Claude bittest, etwas zu ändern, zeigt es dir die vorgeschlagenen Änderungen und bittet um Bestätigung. Mit Shift+Tab kannst du zwischen den Zugriffsmodi wechseln.

Es lohnt sich, gleich zu Beginn ein paar grundlegende Befehle in der Sitzung kennenzulernen: /help listet die Befehle auf, /clear löscht den Gesprächsverlauf und /exit beendet die Sitzung (zweimal Ctrl+D bewirkt dasselbe). Wenn du /help eingibst, zeigt Claude dir all das selbst.

Anmeldung mit einem Abonnement oder API-Schlüssel: Was solltest du wählen?#

Diese Frage stellt sich meist als Erstes bei der Anmeldung.

Es gibt zwei Anmeldemöglichkeiten; sie unterscheiden sich darin, wie du bezahlst.

Für die Anmeldung mit einem Abonnement verwendest du einfach dein Claude.ai-Konto. Für die Anmeldung mit einem API-Schlüssel rufst du einen Schlüssel über Claude Console ab (platform.claude.com); während deiner Arbeit werden die Kosten von deinem vorausbezahlten Guthaben abgezogen. Setze den Schlüssel in der Umgebungsvariable ANTHROPIC_API_KEY, damit Claude Code nicht jedes Mal den Browser öffnet.

Innerhalb einer Sitzung kannst du mit /login das Konto wechseln und dich mit /logout abmelden.

Ohne kostenpflichtigen Zugang startet Claude Code jedoch nicht. Falls du noch kein Konto hast, informiere dich zuerst, welche E-Mail-Adresse du für die Registrierung verwenden solltest: Du kannst sie später nicht mehr ändern.

Wie prüfst du, ob alles korrekt installiert wurde?#

Drei Befehle solltest du von Anfang an kennen.

Der erste prüft die Version:

claude --version

Bei einer funktionierenden Installation wird eine Nummer im Format X.Y.Z (Claude Code) ausgegeben. Die konkreten Ziffern ändern sich mit jeder Version; wichtig ist, dass überhaupt eine Versionsnummer erscheint. Die Meldung „command not found“ bedeutet etwas anderes – darum geht es im nächsten Abschnitt.

Der zweite dient der Diagnose, wenn etwas schiefgeht.

Der dritte ist /status innerhalb einer Sitzung: Er zeigt, wie du dich angemeldet hast, welche E-Mail-Adresse oder Organisation verknüpft ist und ob dein Zugang abgelaufen ist. Mit claude update installierst du das neueste Update sofort, statt auf die Aktualisierung im Hintergrund zu warten.

Warum wird der Befehl claude nach der Installation nicht gefunden?#

Das ist die häufigste Beschwerde von Einsteigern und klingt schlimmer, als es ist. Das Terminal durchsucht nicht den ganzen Computer nach Befehlen, sondern nur die Ordner in PATH. Claude Code legt sich unter ~/.local/bin/claude (auf Mac und Linux) oder %USERPROFILE%\\.local\\bin\\claude.exe (unter Windows) ab. Wenn dieser Ordner nicht in PATH steht, kann das Terminal das Programm einfach nicht finden.

Füge den Ordner auf Mac und Linux zur Liste hinzu. Öffne die Einstellungsdatei deiner Shell (~/.zshrc für Zsh, ~/.bashrc für Bash) und füge diese Zeile am Ende ein:

export PATH="$HOME/.local/bin:$PATH"

Schließe anschließend das Terminal und öffne es erneut (oder führe source ~/.zshrc aus). Danach wird claude gefunden.

Häufige Fehler bei der Installation und beim ersten Start#

Gehen wir sie der Reihe nach durch; alle stammen aus dem offiziellen Fehlerbehebungshandbuch von Anthropic.

1. Veraltetes Node bei der Installation über npm. Das Paket @anthropic-ai/claude-code erfordert Node.js 22 oder neuer. Unter Windows kann npm mit einer Meldung über deaktivierte Skripts fehlschlagen – die PowerShell-Richtlinie verhindert ihre Ausführung. Unter WSL lautet ein häufiger Fehler exec: node: not found: WSL verwendet Windows-Node statt Linux-Node. Wenn npm Probleme macht, wechsle zum nativen Installer; er braucht kein Node.
2. Falscher Installer für die Shell. 'irm' is not recognized bedeutet, dass du einen PowerShell-Befehl in die Eingabeaufforderung kopiert hast. The token '&&' is not a valid statement separator bedeutet, dass du umgekehrt einen CMD-Befehl in PowerShell ausgeführt hast. A parameter cannot be found that matches parameter name 'fsSL' bedeutet, dass du den Mac/Linux-Befehl in PowerShell ausgeführt hast. Prüfe den Anfang der Eingabeaufforderung: PS C:\ steht für PowerShell, C:\ für CMD.
3. Ein alter API-Schlüssel überschreibt das Abonnement. Wenn dein Abonnement aktiv ist, aber noch ein alter Schlüssel in deiner Umgebung gesetzt ist, erscheint die Meldung API Error: 400 ... This organization has been disabled. Der Schlüssel hat Vorrang vor der Anmeldung mit einem Abonnement. Entferne ihn mit unset ANTHROPIC_API_KEY (in PowerShell verwendest du Remove-Item Env:ANTHROPIC_API_KEY), prüfe ~/.zshrc und ~/.bashrc und gib anschließend /status ein.
4. Zu wenig Arbeitsspeicher auf einem schwachen Server. Die Installation wird mit dem Wort Killed und Code 137 abgebrochen – das bedeutet, dass nicht genug RAM vorhanden ist. Du brauchst etwa 512 MB freien Speicher; durch Hinzufügen von Swap-Speicher lässt sich das Problem beheben.
5. Der Installer hat etwas anderes zurückgegeben. Der Fehler syntax error near unexpected token '<' oder ein Verweis auf <!DOCTYPE html> bedeutet, dass die Installations-URL statt des Installationsskripts eine Webseite zurückgegeben hat – meist wegen deiner Region, einer Unternehmens-Firewall oder eines vorübergehenden Ausfalls. Versuche eine andere Methode (Homebrew, WinGet) oder probiere es in ein paar Minuten erneut.

Bei all diesen Fehlern ist der erste Schritt derselbe: Führe claude doctor aus. Das Tool zeigt dir, was nicht funktioniert, und schlägt vor, wo du nachsehen solltest.

Hier gibt es eine Besonderheit bei der Diagnose: Ein bloßes 403 während der Installation kann auch von einer Unternehmens-Firewall oder einem Proxy kommen. Wenn du also in einem Büronetzwerk bist, prüfe zuerst, ob der Zugriff blockiert wird.

Was tun nach der Installation: erste Schritte#

Die Installation ist nur der Anfang. Die eigentliche Arbeit beginnt danach, und als Erstes stößt man auf das Gedächtnis. Ein Sprachmodell erinnert sich nicht zwischen Gesprächen an dich: In einem neuen Chat kennt es nur, was du in seinen Kontext aufgenommen hast.

Der erste praktische Schritt nach der Installation ist daher, eine Datei CLAUDE.md im Stammverzeichnis deines Projekts anzulegen. Sie enthält Projektregeln und Kontext, die Claude Code bei jedem Start liest. Beschreibe einmal, was du machst, wie das Projekt organisiert ist und worauf es ankommt – dann musst du es nicht in jedem Gespräch wiederholen.

In einer separaten Anleitung erkläre ich, wie du die Datei erstellst und Claude anpasst: Claude anpassen. Außerdem habe ich eine allgemeine Übersicht über Vibe-Coding-Tools für 2026 zusammengestellt.

Was wird sonst noch gefragt?#

Das vollständige Vibe-Coding-Framework: KI-Klon + Second Brain + Context Engineering.