Claude Code installieren: In 5 Minuten einsatzbereit (Schritt für Schritt)

Das Setup von Claude Code dauert tatsächlich fünf Minuten — wenn man weiß, was man tut. Der häufigste Stolperstein ist nicht die Installation selbst, sondern ein falsch eingefügter API-Key. Wer dabei einen Tippfehler macht oder den Key aus dem falschen Bereich kopiert, verbringt leicht 30 Minuten mit kryptischen Fehlermeldungen, bevor er den echten Fehler findet.

Diese Anleitung führt dich Schritt für Schritt durch die Installation von Claude Code: Voraussetzungen prüfen, installieren, API-Key einrichten, ersten Test durchführen. Und am Ende: die häufigsten Fehler und ihre Fixes, damit du sie nicht selbst durchleiden musst.

Schritt 1: Voraussetzungen prüfen

Claude Code läuft auf Node.js 18 oder neuer. Das ist die einzige harte Anforderung. Prüfe deine Version zuerst:

node --version

Gibt das v18.x.x oder höher aus, bist du bereit. Siehst du v16 oder darunter — oder bekommst du den Fehler "command not found" — musst du Node.js zuerst installieren.

Node.js installieren nach Betriebssystem

macOS: Der einfachste Weg ist Homebrew:

brew install node

Linux (Ubuntu/Debian):

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

Windows: Claude Code läuft unter Windows am zuverlässigsten über WSL 2 (Windows Subsystem for Linux). Installiere WSL zuerst:

wsl --install

Danach öffne die WSL-Shell (Ubuntu) und folge den Linux-Schritten oben. Direkte Windows-Installation via Node.js-Installer funktioniert ebenfalls, aber WSL ist die empfohlene Umgebung für professionellen Einsatz.

Schritt 2: Claude Code in einem Befehl installieren

Wenn Node.js eingerichtet ist, reicht ein einziger Befehl, um Claude Code global zu installieren:

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

Das -g-Flag installiert das Paket global, sodass claude danach in jedem Verzeichnis als Befehl verfügbar ist. Die Installation dauert je nach Verbindung 30–60 Sekunden.

Verifiziere die Installation anschließend:

claude --version

Siehst du eine Versionsnummer wie 1.x.x, ist Claude Code korrekt installiert.

Schritt 3: API-Key einrichten

Claude Code benötigt einen Anthropic-API-Key. Den bekommst du unter console.anthropic.com — Account erstellen, Zahlungsmethode hinterlegen, dann unter API Keys einen neuen Key anlegen. Der Key beginnt mit sk-ant-.

Option A: Interaktiver Login

Der einfachste Weg ist der eingebaute Login-Befehl:

claude login

Claude Code öffnet einen Browser-Tab zur Anthropic Console. Nach der Anmeldung wird der API-Key automatisch gespeichert. Das ist die empfohlene Methode für die lokale Entwicklung.

Option B: Umgebungsvariable setzen

Für Serverumgebungen oder wenn du den Key manuell verwalten willst, setzt du die Umgebungsvariable direkt:

export ANTHROPIC_API_KEY="sk-ant-dein-key-hier"

Damit die Variable dauerhaft verfügbar ist, trag sie in deine Shell-Konfiguration ein:

# In ~/.bashrc oder ~/.zshrc hinzufügen:
export ANTHROPIC_API_KEY="sk-ant-dein-key-hier"

Danach source ~/.bashrc (oder source ~/.zshrc) ausführen, damit die Änderung sofort wirksam wird.

Schritt 4: Erster Test

Alles eingerichtet — jetzt der Realitätscheck. Zuerst die Version prüfen:

claude --version

Und dann direkt ein einfaches Beispiel: Claude Code erklärt Code im Terminal:

claude "erkläre mir print('Hallo')"

Claude Code sollte innerhalb weniger Sekunden mit einer Erklärung antworten. Klappt das, ist dein Setup vollständig funktionsfähig. Du kannst Claude Code jetzt in jedem Projektverzeichnis starten und es hat direkten Zugriff auf deine Dateien.

Für den echten Einstieg: Navigiere in ein bestehendes Projekt und starte Claude Code dort:

cd /dein/projekt
claude

Im interaktiven Modus kann Claude Code deine Dateien lesen, editieren, Befehle ausführen und dir beim Coden helfen — direkt im Terminal, ohne Browser-Tab.

Schritt 5: Häufige Fehler und ihre Fixes

Permission error beim npm install

Auf manchen Systemen schlägt npm install -g mit einem Berechtigungsfehler fehl. Das passiert, wenn npm in ein systemweites Verzeichnis schreiben will, für das dein Benutzer keine Rechte hat.

Fix 1 (empfohlen): npm-Verzeichnis in den Home-Ordner verschieben:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

Fix 2 (einfacher, aber weniger sauber):

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

Node-Version zu alt

Fehlermeldungen wie "SyntaxError: Unexpected token" oder "Engine node >=18 required" bedeuten, dass deine Node-Version zu alt ist.

# Mit nvm auf Node 20 wechseln:
nvm install 20
nvm use 20
nvm alias default 20

API-Key-Fehler: "Invalid API Key"

Bekommst du nach dem ersten Befehl den Fehler "Invalid API key" oder "Authentication error", sind das die häufigsten Ursachen:

• Führende oder nachfolgende Leerzeichen im Key — beim manuellen Kopieren passiert das leicht. Nochmals kopieren, diesmal sorgfältig.
• Key aus falschem Bereich kopiert — der Key muss mit sk-ant- beginnen. Alles andere ist kein API-Key.
• Kein Guthaben auf dem Account — neue Anthropic-Accounts brauchen eine Zahlungsmethode und mindestens $5 Guthaben, bevor die API funktioniert.
• Key wurde rotiert oder deaktiviert — in der Console prüfen, ob der Key noch aktiv ist.

# Key-Variable prüfen:
echo $ANTHROPIC_API_KEY

# Startet mit sk-ant-? Enthält keine Leerzeichen? Dann ist der Key korrekt gesetzt.

Was jetzt? Der nächste Schritt

Claude Code ist installiert und läuft. Der nächste sinnvolle Schritt ist, es in einem echten Projekt einzusetzen — und dabei zu verstehen, was Claude Code von einem normalen Chatbot unterscheidet: Es hat direkten Zugriff auf dein Filesystem, kann Befehle ausführen und kennt den Kontext deines Projekts.

Zwei Artikel, die direkt auf dieser Installation aufbauen:

• Claude Code MCP-Server einrichten — wie du Claude Code mit externen Tools und APIs verbindest
• Claude Code Hooks einrichten — wie du automatisch Code-Qualität, Git-Schutz und Logging einbaust

Wer Claude Code wirklich produktiv einsetzen will — nicht nur für einzelne Fragen, sondern für ganze Entwicklungsabläufe und autonome Agents — braucht mehr als eine Installationsanleitung. Dafür haben wir den Kurs Claude Code Mastery gebaut.