Claude Code Tutorialreihe 5: Wie installiert man Claude Code?

Wie installiert man Claude Code

Die Installation von Claude Code erfolgt ohne grafische Oberfläche und komplett über die Kommandozeile. Wenn du bereits mit npm arbeitest, dauert der gesamte Vorgang nicht länger als zwei Minuten.

Voraussetzungen

Bevor du beginnst, stelle sicher, dass Folgendes vorhanden ist:

Node.js 18 oder höher
Überprüfung: Führe im Terminal node -v aus. Falls die Version unter 18 liegt, aktualisiere Node.js mit nvm, fnm oder direkt von nodejs.org.
Ein Anthropic-Konto
Die Registrierung erfolgt unter https://console.anthropic.com. Das Konto stellt einen API-Schlüssel bereit, der nach der Installation benötigt wird. Die Registrierung ist kostenlos, die tatsächlichen Kosten richten sich nach der Nutzung.
Netzwerkzugriff auf die Anthropic-API-Endpunkte
Der Standard-Domainname ist api.anthropic.com. Falls deine Umgebung einen Proxy benötigt, setze im Terminal die Umgebungsvariablen HTTP_PROXY oder HTTPS_PROXY.

Installationsmethode 1: Globale npm-Installation

Dies ist die gängigste Methode – einmal installiert, überall nutzbar.

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

Führe anschließend claude --version aus. Wenn eine Versionsnummer ausgegeben wird, war die Installation erfolgreich. Nach der globalen Installation kann der Befehl claude in jedem Verzeichnis direkt aufgerufen werden.

Sollte ein Berechtigungsfehler auftreten (häufig unter macOS im Verzeichnis /usr/local/lib), gibt es zwei Möglichkeiten:

Installation mit sudo (bequem, aber sicherheitskritisch).
Konfiguriere npm so, dass es ein Benutzerverzeichnis verwendet, um sudo zu vermeiden:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Füge anschließend ~/.npm-global/bin zur PATH-Variable hinzu und starte das Terminal neu.

Installationsmethode 2: Nutzung mit npx (On-the-fly)

Wenn du nichts global installieren möchtest oder nur einen kurzen Test durchführen willst, ist npx die direktere Wahl.

npx @anthropic-ai/claude-code

npx lädt das neueste Paket temporär herunter und hinterlässt nach der Ausführung keinen globalen Befehl. Bei jeder Verwendung wird auf Updates geprüft, sodass du immer die aktuelle Version erhältst. Nachteil: Es ist etwas langsamer (jedes Mal wird heruntergeladen) und nicht für automatisierte Skripte mit häufigen Aufrufen geeignet.

Ideale Anwendungsfälle: Erste Erfahrungen sammeln, kurze Nutzung auf fremden Rechnern oder gelegentliche Nutzung.

Überprüfen des ordnungsgemäßen Starts

Führe vor der Authentifizierung einen einfachen Befehl aus, um zu sehen, ob das Tool startet:

claude --help

Wenn eine Hilfeseite angezeigt wird, ist die Binärdatei in Ordnung. Im nächsten Schritt wird die Verbindung zu deinem Konto hergestellt – dazu später mehr.

Beide Installationsmethoden liefern denselben Kern; die anschließende Authentifizierung und Nutzung sind identisch. Wähle die Methode, die dir am angenehmsten ist.

Häufige Probleme

Node-Version zu niedrig
Versionen unter 18 führen sofort zu einem Fehler, nicht nur zu einer Warnung. Ein Update von Node.js ist die einfachste Lösung.
Netzwerk-Timeout
Sowohl beim npm-Pull als auch bei der späteren API-Verbindung können Proxy- oder Firewall-Probleme auftreten. Stelle zunächst sicher, dass curl https://api.anthropic.com erreichbar ist, bevor du weitere Schritte unternimmst.
Windows: Direkte Verwendung der nativen cmd
Obwohl theoretisch möglich, wird die Verwendung von Git Bash, WSL2 oder Windows Terminal empfohlen, um seltsame Pfad- und Escape-Probleme zu vermeiden.