Claude Code Praxiseinstieg
Installation und Setup
Einrichten von Claude Code
In diesem Artikel richten wir Claude Code ein, das Kommandozeilen-Tool (CLI) von Anthropic. Wir gehen davon aus, dass Sie mit den Grundlagen vertraut sind, und konzentrieren uns direkt auf die technischen Schritte. Bevor wir beginnen, stellen Sie sicher, dass Sie zwei Dinge zur Hand haben: Node.js Version 18 oder höher ist auf Ihrem System installiert und Sie haben einen Anthropic API-Schlüssel.
Systemvoraussetzungen
Claude Code ist für die gängigsten Entwicklungsumgebungen konzipiert. Die wichtigste Anforderung ist Node.js 18+.
- macOS: Läuft nativ. Stellen Sie sicher, dass Ihre Node.js-Version aktuell ist.
- Linux: Läuft nativ auf den meisten gängigen Distributionen (wie Ubuntu, Fedora oder Arch).
- Windows: Erfordert das Windows Subsystem for Linux (WSL), um eine Linux-Umgebung für die Ausführung von Claude Code bereitzustellen.
Installation und Authentifizierung
Die Installation erfolgt global über den Node Package Manager (npm), der zusammen mit Node.js geliefert wird. Durch die globale Installation ist der claude-Befehl von jedem beliebigen Verzeichnis in Ihrem Terminal aus zugänglich.
npm install -g @anthropic-ai/claude-code
Nach Abschluss der Installation können Sie überprüfen, ob sie erfolgreich war, indem Sie die Version abfragen.
claude --version
Wenn Sie Claude Code zum ersten Mal ausführen, werden Sie zur Authentifizierung aufgefordert. Sie müssen Ihren von Anthropic eingeben. Dieser Schlüssel wird lokal auf Ihrem System gespeichert, sodass Sie ihn nicht bei jeder Sitzung erneut eingeben müssen. Sie finden Ihren Schlüssel in den Einstellungen Ihres Anthropic-Kontos.
Behandeln Sie Ihren API-Schlüssel wie ein Passwort. Geben Sie ihn nicht weiter und laden Sie ihn nicht in öffentliche Repositories hoch.
Erster Start und Fehlerbehebung
Um mit Claude Code zu arbeiten, navigieren Sie in Ihrem Terminal zum Verzeichnis Ihres Projekts. Starten Sie dann einfach das Tool.
# Wechseln Sie in Ihr Projektverzeichnis
cd ihr-projektordner
# Starten Sie Claude Code
claude
Bei einem erfolgreichen Start werden Sie von einer Claude-Eingabeaufforderung begrüßt, die bereit ist, Ihre Anweisungen entgegenzunehmen. Sollte etwas schiefgehen, sind hier einige häufige Probleme und deren Lösungen:
-
Befehl
claudenicht gefunden: Dies geschieht meistens, wenn das globale Verzeichnis von npm nicht in derPATH-Umgebungsvariable Ihres Systems enthalten ist. Eine Neuinstallation von Node.js oder die manuelle Konfiguration IhresPATHkann dies beheben. -
Authentifizierungsfehler: Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist und über genügend Guthaben verfügt. Manchmal kann ein Tippfehler oder ein abgelaufener Testzugang die Ursache sein.
-
Falsche Node.js-Version: Wenn Sie an mehreren Projekten mit unterschiedlichen Node.js-Anforderungen arbeiten, kann ein Versionskonflikt auftreten. Ein Werkzeug wie (Node Version Manager) ist hierfür die beste Lösung. Es ermöglicht Ihnen, schnell zwischen verschiedenen installierten Node.js-Versionen zu wechseln.
Mit einer korrekt installierten und authentifizierten Claude Code-Instanz sind Sie nun bereit, die KI direkt in Ihrem Terminal für Ihre Entwicklungsaufgaben zu nutzen.