Kurze Zusammenfassung: Claude Code CLI wird über einen einzigen Befehl installiert, der das Tool automatisch herunterlädt und konfiguriert. Unter macOS und Linux verwenden Sie das offizielle Shell-Skript aus den Anthropic-Dokumenten, während Windows-Benutzer PowerShell- oder WSL-Befehle ausführen. Nach der Installation authentifizieren Sie sich mit Ihrem API-Schlüssel, um den KI-Coding-Assistenten von Claude in Ihrem Terminal zu nutzen.
Claude Code ist ein agentenbasiertes Coding-Tool, das in Ihrem Terminal lebt und Ihre gesamte Codebasis versteht. Laut der offiziellen Claude Code-Dokumentation kann es Dateien lesen, Befehle ausführen, Code bearbeiten und über natürliche Sprachkonversationen mit Entwicklungswerkzeugen integrieren.
Der Einstieg erfordert jedoch eine ordnungsgemäße Installation. Hier finden Sie alles, was Sie zur Installation von Claude Code CLI und zur richtigen Konfiguration benötigen.
Systemanforderungen vor der Installation
Bevor Sie Claude Code installieren, stellen Sie sicher, dass Ihr System die grundlegenden Anforderungen erfüllt. Laut der offiziellen Dokumentation für die erweiterte Einrichtung entfernen Sie diesen Satz vollständig.
Überprüfen Sie die Node.js-Installation, indem Sie ein Terminal öffnen und Folgendes ausführen:
| node –version |
Wenn Node.js nicht installiert ist oder die Version unter 18 liegt, laden Sie es von der offiziellen Node.js-Website herunter. Die Long-Term Support (LTS)-Version funktioniert einwandfrei für Claude Code.
Neben Node.js benötigt das System grundlegende Anforderungen: macOS 13.0 oder höher für Mac-Benutzer, Windows 10 oder höher für Windows-Systeme, und die meisten modernen Linux-Distributionen funktionieren ohne Probleme. Ein Claude-Konto von Anthropic ist ebenfalls für die Authentifizierung nach der Installation erforderlich.
Installation von Claude Code unter macOS und Linux
Der Installationsprozess für macOS und Linux verwendet einen einzigen Shell-Befehl, der alles automatisch handhabt. Diese Methode ist im offiziellen Claude Code-Schnellstart-Leitfaden dokumentiert.
Öffnen Sie Terminal und führen Sie das Installationsskript aus:
| curl -fsSL claude.ai/install.sh | bash |
Das Skript lädt die Claude Code-Binärdatei herunter, platziert sie im richtigen Verzeichnis und konfiguriert automatisch den PATH. Der gesamte Vorgang dauert in der Regel weniger als eine Minute.
Für macOS-Benutzer, die Homebrew bevorzugen, gibt es eine alternative Installationsmethode, obwohl diese in den primären Quellen nicht offiziell dokumentiert ist. Die Curl-Methode bleibt laut offizieller Dokumentation der empfohlene Ansatz.
Überprüfung der Installation
Nachdem die Installation abgeschlossen ist, überprüfen Sie, ob Claude Code zugänglich ist:
| claude –version |
Dieser Befehl sollte die installierte Versionsnummer anzeigen. Wenn eine Fehlermeldung wie "command not found" erscheint, muss die PATH-Konfiguration angepasst werden.
Laut der offiziellen Fehlerbehebungsdokumentation sind PATH-Probleme das häufigste Installationsproblem. Die Lösung besteht darin, das Installationsverzeichnis von Claude zur Konfigurationsdatei der Shell hinzuzufügen.
Installation von Claude Code unter macOS und Linux
Der Installationsprozess für macOS und Linux verwendet npm (Node Package Manager). Laut der offiziellen Dokumentation müssen Sie Node.js 18+ auf Ihrem System installiert haben, bevor Sie fortfahren. Im Gegensatz zu herkömmlichen CLI-Tools, die Shell-Skripte verwenden, wird Claude Code global über Ihr Terminal installiert, um sicherzustellen, dass alle Abhängigkeiten korrekt behandelt werden.
Öffnen Sie Ihr Terminal und führen Sie den folgenden Befehl aus, um das Paket zu installieren:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Hinweis: Die Umgebungsvariable CLAUDE_CODE_RELEASE_ALPHA=1 ist derzeit während der öffentlichen Beta-/Alpha-Phase erforderlich, um den Vorschau-Status des Tools zu bestätigen.
Dieser Befehl lädt das Paket aus dem offiziellen npm-Repository herunter und verknüpft die claude-ausführbare Datei mit dem globalen Binärverzeichnis Ihres Systems. Obwohl einige Benutzer versuchen mögen, Homebrew-Formeln zu finden, ist die npm-Methode der einzig offiziell unterstützte und dokumentierte Installationspfad.
Überprüfung der Installation
Nach Abschluss der Installation überprüfen Sie, ob die CLI korrekt Ihrer Umgebung zugeordnet ist, indem Sie Folgendes ausführen:
| claude –version |
Dieser Befehl sollte die aktuelle Versionsnummer anzeigen (z. B. 0.2.9). Wenn Sie eine Fehlermeldung "command not found" erhalten, bedeutet dies in der Regel, dass Ihr globales npm-Verzeichnis nicht in der PATH-Variable Ihres Systems enthalten ist.
Laut der offiziellen Fehlerbehebungsdokumentation können Sie dies beheben, indem Sie Ihr npm-Präfix mit `npm config get prefix` ermitteln und sicherstellen, dass der resultierende `/bin`-Ordner zu Ihrer `.zshrc`- oder `.bashrc`-Datei hinzugefügt wird.
Installation von Claude Code unter Windows
Die Installation unter Windows bietet zwei Hauptansätze: native PowerShell-Installation oder Verwendung des Windows Subsystem for Linux (WSL). Die offizielle Dokumentation empfiehlt PowerShell für die meisten Benutzer.
PowerShell-Installationsmethode
Öffnen Sie PowerShell als Administrator (Rechtsklick auf das Startmenü und Auswahl von "Windows PowerShell (Administrator)"). Führen Sie diesen Befehl aus:
| irm claude.ai/install.ps1 | iex |
Das PowerShell-Skript kümmert sich automatisch um den Download, die Installation und die PATH-Konfiguration. Schließen und öffnen Sie nach Abschluss PowerShell, um sicherzustellen, dass die PATH-Aktualisierungen wirksam werden.
WSL-Installationsmethode
Entwickler, die bereits WSL verwenden, können Claude Code mit der Linux-Methode installieren. Öffnen Sie das WSL-Terminal und führen Sie denselben Curl-Befehl wie für Linux aus:
| curl -fsSL claude.ai/install.sh | bash |
Der WSL-Ansatz funktioniert identisch mit nativen Linux-Installationen. Ein Vorteil: WSL bietet eine Unix-ähnlichere Umgebung, die mit Produktionsserverkonfigurationen übereinstimmt.
Laut der offiziellen Fehlerbehebungsdokumentation stoßen WSL-Benutzer gelegentlich auf Probleme mit der Netzwerkverbindung. Wenn die Installation hängen bleibt, überprüfen Sie, ob WSL auf externe Netzwerke zugreifen kann und ob Firewall-Regeln den Datenverkehr nicht blockieren.
Claude und AI Tool Credits an einem Ort finden
Die Installation von Claude Code CLI ist ein Schritt. Langfristig für KI-Tools zu bezahlen, ist ein anderer. Get AI Perks sammelt Startup-Credits und Software-Rabatte für KI- und Cloud-Tools an einem Ort. Es bietet Gründern Zugang zu über 200 Vergünstigungen, einschließlich Angeboten von Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom und anderen. Die Plattform zeigt auch Perk-Bedingungen und Anleitungen für die Beanspruchung jedes Angebots.
Sie suchen Claude- oder Anthropic-Credits?
Besuchen Sie Get AI Perks, um:
- KI-Tool-Credits und Rabatte an einem Ort zu finden
- die Perk-Bedingungen vor der Bewerbung zu prüfen
- Anleitungen zum Beantragen von Startup-Angeboten zu erhalten
👉 Besuchen Sie Get AI Perks, um verfügbare Claude-, Anthropic- und andere KI-Software-Perks zu durchsuchen.
Authentifizierung und Ersteinrichtung
Nach der Installation ist eine Authentifizierung von Claude Code erforderlich, bevor es funktionieren kann. Das Tool verwendet API-Schlüssel von Anthropic, um den Zugriff zu verifizieren.
Starten Sie den Authentifizierungsprozess, indem Sie Folgendes ausführen:
| claude |
Beim ersten Ausführen dieses Befehls fordert Claude Code zur Authentifizierung auf. Laut dem offiziellen Schnellstart-Leitfaden öffnet sich ein Browserfenster, um sich beim Anthropic-Konto anzumelden.
Nach der Anmeldung über den Browser erhält die CLI automatisch ein Authentifizierungstoken. Dieses Token wird lokal gespeichert und bleibt über Sitzungen hinweg erhalten, sodass eine wiederholte Authentifizierung nicht erforderlich ist.
Konfiguration projektspezifischer Einstellungen
Claude Code unterstützt die Konfiguration auf mehreren Ebenen gemäß der offiziellen Dokumentation zu den Einstellungen. Die gängigsten Konfigurationsebenen sind:
| Bereich | Ort | Anwendungsfall |
|---|---|---|
| Benutzer | ~/.claude/ Verzeichnis | Persönliche Präferenzen für alle Projekte |
| Projekt | .claude/ im Repository | Gemeinsame Teamkonfiguration |
| Lokal | .claude/settings.local.json | Maschinenspezifische Überschreibungen |
Für die erstmalige Einrichtung ist die Konfiguration auf Benutzerebene ausreichend. Projekteinstellungen werden wichtig, wenn Sie mit Teams zusammenarbeiten, die Coding-Standards teilen.
Starten Ihrer ersten Claude Code-Sitzung
Nachdem die Installation und Authentifizierung abgeschlossen sind, starten Sie Claude Code, indem Sie den Befehl ohne Argumente ausführen:
| claude |
Dies startet den interaktiven Modus, in dem Claude auf Anfragen in natürlicher Sprache reagiert. Die offizielle Dokumentation beschreibt den interaktiven Modus als die primäre Methode, Claude Code für Entwicklungsaufgaben zu verwenden.
Versuchen Sie einen einfachen Testbefehl:
| Zeige mir die Struktur dieses Projekts |
Claude Code analysiert das aktuelle Verzeichnis und gibt einen Überblick über die Codebasisstruktur. Dies zeigt, dass die Installation korrekt funktioniert und Claude Lesezugriff auf Dateien hat.
Wichtige Befehle für den täglichen Gebrauch
Neben dem interaktiven Modus unterstützt Claude Code mehrere Befehlsmuster, die in der CLI-Referenz dokumentiert sind:
| Befehlsmuster | Zweck | Beispiel |
|---|---|---|
| claude | Interaktive Sitzung starten | claude |
| claude „Aufgabe“ | Aufgabe einmalig ausführen | claude „Beheben Sie die Linting-Fehler“ |
| claude -p „Abfrage“ | Schnelle Abfrage ohne Sitzung | claude -p „Was macht diese Funktion?“ |
Das Muster für einmalige Aufgaben ist besonders nützlich für CI/CD-Pipelines und Automatisierungsskripte, bei denen eine interaktive Sitzung nicht geeignet ist.
Häufige Installationsprobleme
Auch bei automatisierten Installationsskripten können gelegentlich Probleme auftreten. Die offizielle Fehlerbehebungsdokumentation behandelt die häufigsten Probleme.
Fehler "Command Not Found"
Wenn das Terminal nach der Installation die Meldung "command not found: claude" anzeigt, wurde die PATH-Konfiguration nicht korrekt abgeschlossen. Fügen Sie unter macOS und Linux den Speicherort der Claude-Binärdatei manuell zur Konfigurationsdatei der Shell hinzu.
Für Bash-Benutzer bearbeiten Sie ~/.bashrc oder ~/.bash_profile und fügen Sie hinzu:
| export PATH=”$HOME/.local/bin:$PATH” |
Für Zsh-Benutzer (Standard auf modernen macOS) bearbeiten Sie ~/.zshrc mit derselben Zeile. Laden Sie nach dem Speichern die Konfiguration mit `source ~/.zshrc` neu oder öffnen Sie ein neues Terminalfenster.
Netzwerk- und Firewall-Probleme
Unternehmensnetzwerke und restriktive Firewalls blockieren manchmal das Installationsskript. Laut der Fehlerbehebungsdokumentation kann bei Hängenbleiben der Installation oder Rückgabe von HTML anstelle der Ausführung der Zugriff auf die Server von Anthropic blockiert sein.
Die Problemumgehung besteht darin, das Installationsskript separat herunterzuladen:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Dieser Ansatz bietet mehr Transparenz darüber, was fehlschlägt, wenn Fehler beim Download oder bei der Ausführung auftreten.
WSL-spezifische Probleme
Windows-Benutzer, die WSL verwenden, stoßen manchmal auf Konnektivitätsprobleme zwischen dem Linux-Subsystem und Windows. Die offizielle Dokumentation erwähnt, dass Firewall-Regeln möglicherweise angepasst werden müssen, um WSL-Datenverkehr zuzulassen.
Wenn Claude Code erfolgreich installiert wird, aber Anthropic-Server für die Authentifizierung nicht erreichen kann, überprüfen Sie, ob die Windows-Firewall den WSL-Netzwerkzugriff zulässt. Der Fehlerbehebungsleitfaden enthält spezifische PowerShell-Befehle zur Konfiguration von Firewall-Regeln.
Aktualisieren von Claude Code
Claude Code wird regelmäßig mit neuen Funktionen und Verbesserungen aktualisiert. Laut der offiziellen Dokumentation werden Updates mit demselben Befehl wie die Erstinstallation installiert.
Führen Sie das Installationsskript erneut aus:
| curl -fsSL code.anthropic.com/install.sh | sh |
Das Skript erkennt die vorhandene Installation und aktualisiert sie auf die neueste Version. Während des Update-Vorgangs gehen keine Konfigurationen oder Authentifizierungen verloren.
Überprüfen Sie die aktuelle Version vor und nach dem Update:
| claude –version |
Das Changelog in der offiziellen Claude Code-Dokumentation listet alle Änderungen zwischen den Versionen auf, was hilft zu bestimmen, ob ein Update Funktionen einführt, die für bestimmte Workflows relevant sind.
Nächste Schritte nach der Installation
Nachdem Claude Code installiert und funktionsfähig ist, können erweiterte Funktionen erkundet werden. Die offizielle Dokumentation beschreibt mehrere Bereiche, die einer Untersuchung wert sind:
- Skills und Anpassung: Laut der offiziellen Dokumentation zu Skills unterstützt Claude Code benutzerdefinierte Skills, die in Markdown-Dateien im Verzeichnis `.claude/skills/` definiert sind. Diese Skills erweitern die Fähigkeiten von Claude mit projektspezifischen Befehlen und Workflows.
- Model Context Protocol (MCP): Die MCP-Integration ermöglicht es Claude Code, sich mit externen Tools und Diensten zu verbinden. Dies macht Claude zu einer zentralen Anlaufstelle, die auf Datenbanken, APIs und andere Entwicklungsressourcen zugreifen kann.
- Teamkollaboration: Projektbezogene Konfigurationsdateien im Verzeichnis `.claude/` können in die Versionskontrolle übernommen werden, wodurch die Claude Code-Einstellungen für das gesamte Entwicklungsteam freigegeben werden.
- Die offizielle Dokumentation bietet detaillierte Anleitungen für jeden dieser Bereiche, die auf der hier behandelten Basisinstallation aufbauen.
Häufig gestellte Fragen
Benötige ich ein kostenpflichtiges Claude-Abonnement, um Claude Code CLI zu nutzen?
Claude Code erfordert ein Claude-Konto von Anthropic, aber die benötigte Abonnementstufe hängt von der Nutzung ab. Laut offizieller Dokumentation ist eine Authentifizierung erforderlich, aber die Preisdetails sollten auf der offiziellen Website von Anthropic überprüft werden, da sich die Pläne im Laufe der Zeit ändern.
Kann ich Claude Code ohne Administratorrechte installieren?
Unter macOS und Linux installiert sich Claude Code standardmäßig im Home-Verzeichnis des Benutzers und erfordert keine Administratorzugriffsrechte. Windows-Benutzer benötigen möglicherweise Administratorrechte für die PowerShell-Installationsmethode, während WSL-Installationen keine Admin-Rechte erfordern.
Funktioniert Claude Code offline?
Nein. Claude Code ist ein KI-gestütztes Tool, das mit den Servern von Anthropic kommuniziert, um Anfragen zu verarbeiten. Laut der offiziellen Dokumentation ist eine aktive Internetverbindung erforderlich, damit Claude Code analysieren und Antworten generieren kann.
Wie deinstalliere ich Claude Code?
Die offizielle Dokumentation für die erweiterte Einrichtung erklärt, dass die Deinstallation das Entfernen der Binärdatei und der Konfigurationsdateien beinhaltet. Unter macOS und Linux löschen Sie das Verzeichnis `~/.claude` und entfernen die PATH-Änderung aus den Konfigurationsdateien der Shell. Windows-Benutzer sollten das Installationsverzeichnis entfernen und die PATH-Umgebungsvariable löschen.
Kann Claude Code auf mein gesamtes Dateisystem zugreifen?
Standardmäßig arbeitet Claude Code im aktuellen Arbeitsverzeichnis und dessen Unterverzeichnissen. Laut der offiziellen Dokumentation zu Berechtigungen kann der Zugriff mithilfe von Sandbox-Einstellungen in den Konfigurationsdateien weiter eingeschränkt werden. Claude fragt immer nach Bestätigung, bevor potenziell destruktive Operationen ausgeführt werden.
Was ist der Unterschied zwischen Claude Code CLI und Claude Desktop?
Claude Code CLI läuft im Terminal und konzentriert sich auf Entwicklungs-Workflows mit direktem Dateisystemzugriff und Befehlsausführung. Claude Desktop ist eine eigenständige Anwendung mit einer grafischen Benutzeroberfläche. Beide Tools dienen unterschiedlichen Anwendungsfällen, wobei die CLI für Entwickler optimiert ist, die terminalbasierte Workflows bevorzugen.
Wie oft sollte ich Claude Code aktualisieren?
Updates können jederzeit installiert werden. Das offizielle Changelog dokumentiert neue Funktionen und Fehlerbehebungen. Für Teams stellt die Koordination von Updates sicher, dass alle kompatible Versionen verwenden, obwohl Claude Code die Abwärtskompatibilität mit Konfigurationsdateien über verschiedene Versionen hinweg aufrechterhält.
Fazit
Die Installation von Claude Code CLI dauert unabhängig vom Betriebssystem nur wenige Minuten. Die automatisierten Installationsskripte übernehmen die Konfiguration, PATH-Einrichtung und Platzierung der Binärdateien ohne manuelles Eingreifen.
Nach der Installation und Authentifizierung wird Claude Code zu einem leistungsstarken KI-Coding-Assistenten, der von jedem Terminal aus zugänglich ist. Mit Befehlen in natürlicher Sprache können Entwickler Code schreiben, Fehler beheben und Aufgaben automatisieren, ohne die Kommandozeile verlassen zu müssen.
Sind Sie bereit, KI-gestützte Entwicklung zu erleben? Führen Sie den Installationsbefehl für Ihre Plattform aus und starten Sie noch heute Ihre erste Claude Code-Sitzung. Die offizielle Dokumentation unter code.claude.com bietet umfassende Anleitungen für erweiterte Funktionen, sobald die grundlegende Einrichtung abgeschlossen ist.
