Claude Code installieren: Schritt-für-Schritt-Anleitung für Windows, Mac und Linux

Claude Code ist ein leistungsstarkes KI-gestütztes Entwicklerwerkzeug von Anthropic, das direkt im Terminal läuft. Mit wenigen Befehlen kannst du es auf Windows, Mac oder Linux einrichten und sofort mit der KI-unterstützten Entwicklung beginnen. Diese Anleitung führt dich Schritt für Schritt durch die vollständige Installation.

Welche Voraussetzungen brauchst du vor der Claude-Code-Installation?

Bevor du mit dem claude code install-Prozess beginnst, solltest du sicherstellen, dass dein System die notwendigen Anforderungen erfüllt. Die Installation ist unkompliziert, setzt aber einige Grundlagen voraus.

Du benötigst zunächst Node.js in Version 18 oder höher. Claude Code wird über den Node Package Manager (npm) bereitgestellt und läuft als natives CLI-Tool in deinem Terminal. Außerdem brauchst du ein aktives Anthropic-Konto mit einem gültigen API-Key.

• Node.js: Version 18 oder höher – prüfe mit node --version
• npm: Wird automatisch mit Node.js installiert, Version 8+ empfohlen
• Anthropic-Konto: Registrierung unter console.anthropic.com erforderlich
• API-Key: Generiere ihn im Anthropic Console Dashboard
• Betriebssystem: macOS, Linux oder Windows (mit WSL2 oder PowerShell)

Node.js lässt sich am einfachsten über die offizielle Website oder einen Paketmanager wie Homebrew (macOS) bzw. winget (Windows) installieren. Nach der Installation kannst du mit dem eigentlichen Prozess beginnen.

Schritt 1: Claude Code installieren (npm / curl)

Die Installation von Claude Code erfolgt über npm – den Paketmanager von Node.js. Der Befehl ist auf allen Plattformen identisch und installiert das Tool global auf deinem System.

Öffne dein Terminal (macOS/Linux) oder deine Eingabeaufforderung und führe folgenden Befehl aus:

npm install -g @anthropic-ai/claude-code

Das Flag -g sorgt dafür, dass Claude Code systemweit verfügbar ist – du kannst es also aus jedem Verzeichnis heraus aufrufen. Nach dem npm install-Prozess wird das Paket heruntergeladen und eingerichtet. Auf manchen Linux-Systemen ist sudo notwendig:

sudo npm install -g @anthropic-ai/claude-code

Alternativ kannst du auch mit curl über https die neueste Version direkt herunterladen, falls du kein npm verwenden möchtest. Die offizielle Installationsmethode über npm ist jedoch die empfohlene Variante, da sie automatische Updates über den Paketmanager ermöglicht.

Nach der Installation prüfst du die version mit:

claude --version

Schritt 2: Anmeldung bei deinem Anthropic-Konto

Nach der Installation der Claude CLI musst du dich mit deinem Anthropic-Konto verbinden. Dazu benötigst du deinen API-Key aus dem Anthropic Console Dashboard.

Setze den API-Key als Umgebungsvariable. Unter macOS und Linux fügst du folgende Zeile in deine ~/.bashrc oder ~/.zshrc ein:

export ANTHROPIC_API_KEY="dein-api-key-hier"

Danach lädst du die Konfiguration neu:

source ~/.zshrc

Alternativ kannst du den Key direkt beim Start von Claude Code angeben oder ihn über den integrierten Login-Befehl setzen. Claude Code erkennt den Key automatisch, sobald er korrekt als Umgebungsvariable gesetzt ist. Wenn du mehr über KI-Assistenten für den professionellen Einsatz erfahren möchtest, findest du bei KI-Chatbot-Lösungen für Unternehmen einen hilfreichen Überblick.

Schritt 3: Erste Session starten

Sobald der API-Key gesetzt ist, kannst du Claude Code in einem beliebigen Projektverzeichnis starten. Navigiere zunächst in deinen Projektordner:

cd /pfad/zu/deinem/projekt
claude

Claude Code liest beim Start automatisch dein Projektverzeichnis ein. Es analysiert vorhandene Dateien wie package.json, das Projekt-manifest oder README-Dateien, um Kontext über dein Projekt zu gewinnen. Diese native Kontexterfassung ist eines der stärksten Merkmale des Tools.

Beim ersten Start fragt Claude Code nach der Bestätigung der Nutzungsbedingungen. Bestätige diese mit yes, und die interaktive Session öffnet sich im Terminal.

Schritt 4: Deine erste Frage stellen

In der interaktiven Session kannst du Claude Code direkt in natürlicher Sprache ansprechen. Das Tool versteht den Kontext deines Projekts und kann gezielt auf deine Codebasis eingehen.

Ein typischer erster Befehl könnte so aussehen:

Erkläre mir die Struktur dieses Projekts

Claude Code durchsucht dein Verzeichnis, liest relevante Dateien und gibt eine strukturierte Antwort. Du kannst konkrete Fragen zu Funktionen, Fehlern oder der Architektur stellen – das Tool liefert dabei direkt umsetzbare Antworten. Für einen tieferen Einblick in Open-Source-KI-Assistenten empfiehlt sich auch ein Blick auf den OpenClaude-Leitfaden.

Schritt 5: Erste Code-Änderung vornehmen

Claude Code kann nicht nur Fragen beantworten, sondern auch direkt Code schreiben und bestehende Dateien anpassen. Wenn du eine Änderung anforderst, zeigt das Tool dir zuerst eine Vorschau an.

Beispiel für eine Änderungsanfrage:

Füge in der Datei index.js eine Fehlerbehandlung für den API-Aufruf hinzu

Claude Code präsentiert den vorgeschlagenen Diff und fragt nach Bestätigung, bevor es die Änderung tatsächlich schreibt. Dieses Sicherheitsnetz verhindert unbeabsichtigte Modifikationen. Du behältst jederzeit die Kontrolle über alle Änderungen an deinem Code.

Wie nutzt du Git zusammen mit Claude Code?

Claude Code integriert sich nahtlos mit Git und kann dir bei der gesamten Versionskontrolle helfen. Das Tool erkennt automatisch den Status deines Repositories und kann sinnvolle Commit-Messages generieren.

Nützliche Git-bezogene Anfragen an Claude Code:

• Commit-Message: Erstelle eine aussagekräftige Commit-Message für meine Änderungen
• Branch-Analyse: Zeige mir die Unterschiede zwischen main und feature-branch
• Merge-Konflikte: Hilf mir, den Konflikt in dieser Datei zu lösen
• PR-Beschreibung: Generiere eine Pull-Request-Beschreibung für diese Änderungen

Claude Code führt Git-Befehle in deinem Namen aus, sobald du die Aktionen bestätigst. Das beschleunigt typische Entwickler-Workflows erheblich und reduziert manuelle Tipparbeit.

Wie installierst du Claude Code unter Windows mit PowerShell?

Unter Windows gibt es zwei empfohlene Wege für die Installation: über PowerShell mit WSL2 (Windows Subsystem for Linux) oder direkt in der nativen Windows-Umgebung. Für die beste Erfahrung empfiehlt Anthropic die Verwendung von WSL2.

Zunächst installierst du WSL2, falls noch nicht vorhanden. Öffne PowerShell als Administrator und führe aus:

wsl --install

Nach einem Neustart richtest du Node.js innerhalb von WSL2 ein:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Danach funktioniert das npm install genau wie unter Linux:

npm install -g @anthropic-ai/claude-code

Für die native Windows-Installation ohne WSL2 kannst du Node.js direkt von nodejs.org herunterladen und in PowerShell installieren. Der npm-Befehl bleibt identisch. Setze den API-Key in PowerShell als Umgebungsvariable:

$env:ANTHROPIC_API_KEY = "dein-api-key-hier"

Damit der Key dauerhaft gesetzt bleibt, fügst du ihn in die Windows-Systemumgebungsvariablen ein oder trägst ihn in dein PowerShell-Profil ein:

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "dein-key", "User")

Welche Installationsprobleme treten häufig auf — und wie löst du sie?

Bei der Installation von Claude Code können gelegentlich Fehler auftreten. Die meisten lassen sich schnell beheben, wenn man die häufigsten Ursachen kennt.

Permission-Fehler bei npm install

Wenn npm über fehlende Berechtigungen klagt, liegt das meist an einer systemweiten Node.js-Installation. Die sauberste Lösung ist die Verwendung von nvm (Node Version Manager), der Node.js im Benutzerverzeichnis installiert:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20
nvm use 20
npm install -g @anthropic-ai/claude-code

API-Key wird nicht erkannt

Falls Claude Code den API-Key nicht findet, prüfe zunächst, ob die Umgebungsvariable korrekt gesetzt ist:

echo $ANTHROPIC_API_KEY

Wenn die Ausgabe leer ist, hast du die Konfigurationsdatei möglicherweise noch nicht neu geladen. Führe source ~/.zshrc oder source ~/.bashrc aus und starte Claude Code erneut.

Node.js-Version zu alt

Claude Code erfordert mindestens Node.js 18. Prüfe deine aktuelle version mit node --version. Ist diese niedriger, aktualisiere Node.js über nvm oder den jeweiligen Paketmanager deines Systems.

Fehler mit package.json oder manifest

Wenn Claude Code beim Start Fehler im Zusammenhang mit deiner package.json oder einem Projekt-manifest meldet, prüfe, ob die Datei valides JSON enthält. Ein Syntaxfehler in der Konfiguration kann den Ladevorgang unterbrechen. Mit einem JSON-Validator lässt sich das schnell klären.

Claude Code lässt sich auch hervorragend in größere KI-gestützte Workflows integrieren. Wenn du professionelle Unterstützung bei der Einbindung in deine Prozesse suchst, hilft dir die KI-Unterstützung von Automated weiter.

FAQ: Claude Code Installation

Ist Claude Code kostenlos?

Claude Code selbst ist als Tool kostenlos über npm verfügbar. Für die Nutzung benötigst du jedoch einen Anthropic-API-Key, der je nach Nutzungsvolumen kostenpflichtig ist. Anthropic bietet ein kostenloses Guthaben für neue Nutzer an.

Funktioniert Claude Code ohne Internetverbindung?

Nein, Claude Code benötigt eine aktive Internetverbindung, da alle KI-Anfragen über die Anthropic-API verarbeitet werden. Eine vollständig lokale Nutzung ist aktuell nicht vorgesehen.

Kann ich Claude Code in VS Code verwenden?

Claude Code läuft primär als Terminal-Tool, lässt sich aber im integrierten Terminal von VS Code verwenden. Es gibt zudem eine offizielle VS-Code-Extension, die eine noch tiefere Integration ermöglicht.

Welche Programmiersprachen unterstützt Claude Code?

Claude Code unterstützt alle gängigen Programmiersprachen – darunter Python, JavaScript, TypeScript, Rust, Go, Java und viele mehr. Das Tool arbeitet sprachunabhängig mit dem Kontext deines Projekts.

Wie aktualisiere ich Claude Code auf die neueste Version?

Da Claude Code über npm installiert wurde, aktualisierst du es mit folgendem Befehl:

npm update -g @anthropic-ai/claude-code

Mit claude --version prüfst du anschließend, ob die aktuellste Version installiert ist.

Ist Claude Code sicher für produktive Projekte?

Claude Code fragt vor jeder Dateiänderung nach Bestätigung, was unbeabsichtigte Modifikationen verhindert. Dennoch empfiehlt es sich, in einem Git-Repository zu arbeiten, damit alle Änderungen nachvollziehbar und rückgängig machbar sind.