Kurze Zusammenfassung: Claude Code kann über native Installer unter macOS, Windows und Linux von der offiziellen Claude Code-Website installiert werden. Windows-Benutzer müssen zuerst WSL2 installieren, bevor sie Claude Code ausführen. Nach der Installation authentifizieren Sie sich mit Ihrem Claude-Konto, wenn Claude Code ein Browserfenster öffnet, in dem Sie sich beim ersten Start anmelden können, um direkt von Ihrem Terminal oder Ihrer Desktop-App aus mit KI-Unterstützung zu codieren.
Claude Code repräsentiert Anthropic's Vorstoß in generative KI-Entwicklungswerkzeuge. Dieser Kommandozeilenassistent liest Codebasen, bearbeitet Dateien, führt Befehle aus und integriert sich in Entwicklungsworkflows.
Aber die Installation ist nicht immer einfach. Unterschiedliche Plattformen erfordern unterschiedliche Ansätze. Windows erfordert zusätzliche Einrichtung. Und die Dokumentation kann zwar umfassend sein, aber Neulinge überfordern.
Diese Anleitung durchdringt die Komplexität. Sie deckt Systemanforderungen, plattformspezifische Installationsschritte, Authentifizierung und Verifizierung ab – alles, was benötigt wird, um Claude Code richtig zum Laufen zu bringen.
Systemvoraussetzungen vor der Installation
Laut der offiziellen Claude Code-Dokumentation unterstützt das Tool macOS, Windows und Linux. Jede Plattform hat jedoch spezifische Voraussetzungen.
Für macOS sind die Anforderungen minimal. Das System benötigt macOS 13.0 oder neuer. Sowohl Intel- als auch Apple Silicon-Chips funktionieren einwandfrei.
Windows stellt mehr Komplexität dar. Das Betriebssystem muss Windows 10 Build 19041 oder neuer oder Windows 11 sein. Aber hier liegt der Haken – Claude Code läuft nicht nativ unter Windows.
Windows Subsystem for Linux 2 (WSL2) ist zwingend erforderlich. Dies erstellt eine Linux-Umgebung, in der Claude Code tatsächlich ausgeführt wird. Ohne WSL2 schlägt die Installation fehl.
Linux-Benutzer benötigen eine 64-Bit-Distribution. Die offizielle Dokumentation bestätigt die Unterstützung für Ubuntu, Debian, Fedora und andere gängige Distributionen. Alpine Linux und musl-basierte Systeme erfordern zusätzliche Konfiguration.
Alle Plattformen benötigen während der Installation eine stabile Internetverbindung. Die Downloadgrößen variieren, liegen aber typischerweise zwischen 50 MB und 500 MB, abhängig davon, was bereits installiert ist.
| Plattform | Mindestversion | Spezielle Anforderungen |
|---|---|---|
| macOS | 13.0 | Keine |
| Windows | 10 Build 19041 oder 11 | WSL2 erforderlich |
| Linux | 64-Bit-Distribution | glibc-basiert bevorzugt |
Installation von Claude Code unter macOS
Der macOS-Installationsprozess verwendet einen nativen Installer. Dies ist der einfachste Weg unter allen Plattformen.
Laden Sie zuerst den Installer von der offiziellen Claude Code-Website herunter. Die Downloadseite erkennt automatisch macOS und bietet das entsprechende Paket an.
Öffnen Sie die heruntergeladene .dmg-Datei. Ziehen Sie die Claude Code-Anwendung in den Ordner Programme (Applications). Standard-macOS-Installation – nichts Ungewöhnliches hier.
Einige Benutzer stoßen beim ersten Start auf eine Sicherheitsaufforderung. macOS blockiert standardmäßig Apps von nicht identifizierten Entwicklern. Klicken Sie mit der rechten Maustaste auf die Claude Code-Anwendung und wählen Sie "Öffnen", um diese einmalige Warnung zu umgehen.
Das Kommandozeilentool wird automatisch mit der Desktop-Anwendung installiert. Öffnen Sie das Terminal und geben Sie „claude –version“ ein, um dies zu überprüfen. Wenn die Versionsnummer angezeigt wird, war die Installation erfolgreich.
Verifizierung der macOS-Installation
Führen Sie diese Befehle aus, um zu bestätigen, dass alles funktioniert:
| claude –version claude –help |
Beide Befehle sollten ohne Fehler eine Ausgabe zurückgeben. Der Versionsbefehl zeigt die installierte Claude Code-Version an. Der Hilfe-Befehl zeigt verfügbare Optionen und Befehle an.
Das Erstellen eines Testverzeichnisses hilft, die volle Funktionalität zu überprüfen. Navigieren Sie zu einem Projektordner und führen Sie „claude“ aus, um eine interaktive Sitzung zu starten. Das Tool sollte sich initialisieren und zur Authentifizierung auffordern, falls noch nicht angemeldet.
Windows-Installation mit WSL2
Die Windows-Installation erfordert mehrere Schritte. Der Prozess dauert länger als bei macOS, bleibt aber überschaubar.
WSL2 muss zuerst installiert werden. Öffnen Sie PowerShell als Administrator und führen Sie Folgendes aus:
| wsl –install |
Dieser Befehl installiert standardmäßig WSL2 und Ubuntu. Das System erfordert einen Neustart. Nach dem Neustart wird Ubuntu automatisch gestartet, um die Ersteinrichtung abzuschließen.
Erstellen Sie bei Aufforderung einen Unix-Benutzernamen und ein Passwort. Diese Anmeldedaten sind getrennt von den Windows-Anmeldedaten.
Sobald WSL2 läuft, gilt der Installationsprozess für Linux. Öffnen Sie das Ubuntu-Terminal (mit WSL2 installiert) und laden Sie den Claude Code-Installer für Linux herunter.
Installation von Claude Code in WSL2
Laut offizieller Dokumentation lädt der Installationsbefehl den nativen Installer herunter und führt ihn aus:
| curl -o- raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash |
Dieses Skript kümmert sich automatisch um Abhängigkeiten. Es installiert Node.js, falls erforderlich, richtet die Claude Code-Binärdatei ein und konfiguriert PATH-Variablen.
Die Installation dauert einige Minuten. Fortschrittsbalken und Statusmeldungen zeigen an, was gerade geschieht. Wenn abgeschlossen, schließen und öffnen Sie das Terminal, um die Umgebungsvariablen zu aktualisieren.
Das Testen der Installation folgt demselben Prozess wie unter macOS. Führen Sie „claude –version“ aus, um dies zu überprüfen.
Linux-Installationsprozess
Linux-Benutzer haben den geradlinigsten Installationsweg. Der native Installer funktioniert direkt, ohne zusätzliche Schichten wie WSL2.
Laden Sie das Installationsskript herunter und führen Sie es aus:
| curl -fsSL claude.ai/install.sh | bash |
Dies lädt die Claude Code-Binärdatei herunter, installiert Abhängigkeiten und konfiguriert die Shell-Umgebung. Das Skript erkennt die Distribution und passt sich entsprechend an.
Für Ubuntu und Debian-basierte Systeme konfiguriert das Skript die Installation. Die offizielle Dokumentation bestätigt die Unterstützung für Ubuntu 20.04+, Debian 10+ und andere Distributionen.
Überlegungen zu Alpine Linux
Alpine Linux und musl-basierte Distributionen erfordern zusätzliche Schritte. Die offizielle Dokumentation weist darauf hin, dass diese Systeme eine manuelle Konfiguration erfordern.
Der Standard-Installer kann unter Alpine fehlschlagen. Laden Sie stattdessen die musl-kompatible Binärdatei direkt von der Releases-Seite herunter. Extrahieren Sie sie in ein Verzeichnis im System-PATH, typischerweise /usr/local/bin.
Setzen Sie ausführbare Berechtigungen:
| chmod +x /usr/local/bin/claude |
Alpine-Benutzer sollten die Kompatibilität überprüfen, bevor sie fortfahren. Einige Funktionen funktionieren möglicherweise nicht identisch wie bei glibc-basierten Distributionen.
Authentifizierung und Konto-Einrichtung
Nach der Installation von Claude Code führen Sie „claude“ in Ihrem Terminal aus. Beim ersten Start öffnet Claude Code ein Browserfenster, in dem Sie sich anmelden können.
Dies öffnet die Claude-Authentifizierungsseite. Melden Sie sich mit einem bestehenden Claude-Konto an oder erstellen Sie ein neues.
Der Browser zeigt einen Autorisierungscode an. Kopieren Sie diesen Code und kehren Sie zum Terminal zurück. Fügen Sie den Code ein, wenn Sie dazu aufgefordert werden.
Die erfolgreiche Authentifizierung speichert Anmeldeinformationen lokal. Zukünftige Sitzungen erfordern keine Anmeldung, es sei denn, die Anmeldeinformationen laufen ab oder werden manuell gelöscht.
Team- und Unternehmensauthentifizierung
Laut der offiziellen Authentifizierungsdokumentation haben Teams, die Claude für Teams oder Enterprise nutzen, zusätzliche Optionen. Organisationen können Single Sign-On (SSO) oder die Authentifizierung über Cloud-Anbieter konfigurieren.
Die SSO-Einrichtung erfordert eine Administrator-Konfiguration. Einzelne Entwickler authentifizieren sich dann über den Identitätsanbieter ihrer Organisation anstelle von persönlichen Claude-Konten.
Die Authentifizierung über Cloud-Anbieter funktioniert für AWS-, Google Cloud- und Azure-Bereitstellungen. Diese Methode verwendet bestehende Cloud-Anmeldedaten anstelle separater Claude-Konten.
| Authentifizierungsmethode | Anwendungsfall | Einrichtungskomplexität |
|---|---|---|
| Persönliches Konto | Einzelne Entwickler | Einfach |
| Teams/Enterprise SSO | Organisationen | Erfordert Admin |
| Cloud-Anbieter | AWS/GCP/Azure-Benutzer | Mittel |
Installation der Desktop-App
Claude Code bietet sowohl Kommandozeilen- als auch Desktop-Anwendungen. Die Desktop-App bietet eine grafische Benutzeroberfläche und behält gleichzeitig die volle Terminal-Funktionalität.
Laden Sie den Desktop-Installer von der offiziellen Claude-Website herunter. Die Seite bietet Versionen für macOS, Windows und Windows ARM64. Wählen Sie die entsprechende Version für das System aus.
Die macOS-Installation folgt demselben .dmg-Prozess, der zuvor beschrieben wurde. Windows-Benutzer können die Desktop-App für eine grafische Benutzeroberfläche herunterladen, ohne WSL2-Einrichtung.
Die Desktop-App enthält einen integrierten Terminalzugang. Sie kann Claude Code-Sitzungen starten, ohne zu externen Terminalanwendungen wechseln zu müssen.
Ein Vorteil der Desktop-App ist die Hintergrundverfügbarkeit. Laut der offiziellen Download-Seite bleibt die App „im Hintergrund einsatzbereit“ und kann von jeder App aufgerufen werden, ohne Fenster wechseln oder den Fokus verlieren zu müssen.
Nutzen Sie Get AI Perks, um Credits für Ihren Claude Code-Stack zu finden
Die Installation ist der einfache Teil. Die eigentlichen Kosten entstehen meist durch alles drumherum: Infrastruktur, unterstützende Tools und bezahlte Dienste, die während der Einrichtung und beim Testen verwendet werden. Get AI Perks kann helfen, indem es Startup-Credits und Rabatte an einem Ort auflistet, zusammen mit Anleitungen zur Beantragung.
Mit Get AI Perks können Sie:
- Credits für Cloud- und KI-bezogene Tools finden
- Perk-Bedingungen prüfen, bevor Sie sich bewerben
- Zeitverschwendung bei Angeboten vermeiden, für die Sie möglicherweise nicht qualifiziert sind
- Die Kosten für die Einrichtung Ihres Systems senken
Besuchen Sie Get AI Perks, um zu sehen, ob die verfügbaren Angebote mit den Tools übereinstimmen, die Sie mit Claude Code verwenden möchten.
IDE-Erweiterungen und Integrationen
Neben der eigenständigen Installation integriert sich Claude Code in beliebte Entwicklungsumgebungen. Es gibt Erweiterungen für Visual Studio Code und JetBrains IDEs.
Die VS Code-Erweiterung wird über den Marketplace installiert. Suchen Sie im Erweiterungsbereich nach „Claude Code“ und klicken Sie auf Installieren. Die Erweiterung erfordert, dass das Kommandozeilentool zuerst installiert ist.
Einige Benutzer berichten von Problemen mit der gebündelten VS Code-Erweiterungsdatei. Wenn die automatische Installation mit dem Fehler „End of central directory record signature not found“ fehlschlägt, ist die gebündelte .vsix-Datei möglicherweise beschädigt.
Die Lösung besteht darin, die Erweiterung manuell aus dem VS Code Marketplace zu installieren, anstatt sich auf die vom CLI gebündelte Version zu verlassen. Dies trennt die beiden Komponenten und verhindert Installationskonflikte.
Die JetBrains-Integration funktioniert ähnlich. Installieren Sie das Plugin aus dem JetBrains Marketplace innerhalb von IntelliJ IDEA, PyCharm, WebStorm oder anderen JetBrains-Produkten.
Überprüfung des Installationserfolgs
Eine ordnungsgemäße Überprüfung stellt sicher, dass Claude Code korrekt funktioniert, bevor tatsächliche Entwicklungsaufgaben ausgeführt werden.
Einfache Überprüfungen testen die Verfügbarkeit von Befehlen:
| claude –help claude –version |
Diese Befehle sollten ohne Fehler ausgeführt werden. Der Hilfe-Befehl listet verfügbare Optionen auf. Der Versionsbefehl zeigt die installierte Version an.
Funktionstests erfordern den Start einer Sitzung. Erstellen Sie ein Testverzeichnis:
| mkdir test-project cd test-project claude |
Dies initialisiert eine interaktive Claude Code-Sitzung. Das Tool sollte das Verzeichnis (in diesem Fall leer) analysieren und eine Eingabeaufforderung anzeigen.
Versuchen Sie, einfache Befehle innerhalb der Sitzung auszuführen. Geben Sie „help“ ein, um verfügbare Aktionen anzuzeigen. Fordern Sie einfache Aufgaben an, wie „Erstelle eine README-Datei“ oder „Erkläre, was du tun kannst“.
Erfolgreiche Antworten deuten auf eine korrekte Installation hin. Wenn Fehler auftreten, beziehen sie sich typischerweise auf Authentifizierung, Netzwerkverbindung oder fehlende Abhängigkeiten.
Update und Versionsverwaltung
Claude Code aktualisiert sich standardmäßig automatisch. Die offizielle Dokumentation erklärt, dass das Tool nach neuen Versionen sucht und diese ohne Benutzereingriff installiert.
Das Update-Verhalten kann über die Claude Code-Einstellungen konfiguriert werden. Die offizielle Dokumentation behandelt die Konfiguration von Release-Kanälen und manuelle Update-Optionen.
Manuelle Updates erfordern erneut das Ausführen des Installationsskripts. Derselbe Befehl, der für die Erstinstallation verwendet wurde, lädt die neueste Version herunter:
| curl -fsSL claude.ai/install.sh | bash |
Die Installation spezifischer Versionen ist für Test- oder Kompatibilitätszwecke möglich. Die erweiterte Einrichtungsdokumentation behandelt die Versionsfixierung und die Konfiguration von Release-Kanälen.
Zu den Release-Kanälen gehören Stable, Beta und Nightly. Stable wird für produktive Arbeiten empfohlen. Beta- und Nightly-Kanäle bieten frühen Zugriff auf neue Funktionen, können aber Fehler enthalten.
Häufige Installationsprobleme
Mehrere Probleme treten häufig in Community-Diskussionen zur Installation von Claude Code auf.
Die PATH-Konfiguration verursacht viele Probleme. Wenn der Befehl „claude“ nach der Installation nicht gefunden wird, ist das Verzeichnis der Binärdatei nicht im System-PATH enthalten.
Unter macOS und Linux beinhaltet das Hinzufügen des Verzeichnisses zum PATH normalerweise die Bearbeitung von ~/.bashrc, ~/.zshrc oder ähnlichen Shell-Konfigurationsdateien. Das Installationsskript erledigt dies normalerweise automatisch, aber eine manuelle Überprüfung hilft bei der Fehlerbehebung.
Windows-Benutzer in WSL2 müssen möglicherweise das Terminal nach der Installation schließen und wieder öffnen. Die Umgebungsvariablen werden in bestehenden Sitzungen nicht aktualisiert.
Netzwerkbeschränkungen blockieren einige Installationen. Firmen-Firewalls oder Proxyserver können das Herunterladen des Installers oder die Verbindung zu Authentifizierungsservern verhindern.
Die Proxy-Konfiguration erfordert Umgebungsvariablen:
| export HTTP_PROXY= proxy.example.com:8080 export HTTPS_PROXY= proxy.example.com:8080 |
Berechtigungsfehler treten bei der Installation in geschützten Verzeichnissen auf. Der Installer benötigt Schreibzugriff auf /usr/local/bin oder entsprechende Speicherorte. Die Ausführung mit sudo löst dies, sollte aber vermieden werden, es sei denn, es ist notwendig.
Häufig gestellte Fragen
Kann Claude Code ohne Internetverbindung ausgeführt werden?
Nein. Claude Code benötigt Internetverbindung, um zu funktionieren. Das Tool sendet Code und Anfragen an die Server von Anthropic zur Verarbeitung. Lokales Caching kann es ermöglichen, dass einige Operationen vorübergehend offline funktionieren, aber die volle Funktionalität erfordert eine aktive Verbindung.
Funktioniert Claude Code mit bestehenden KI-Coding-Tools?
Ja. Claude Code kann neben GitHub Copilot, Cursor oder anderen KI-Entwicklungstools ausgeführt werden. Sie funktionieren unabhängig und geraten nicht in Konflikt. Die gleichzeitige Nutzung mehrerer KI-Assistenten kann jedoch zu Verwirrung darüber führen, welches Tool welche Aufgabe übernimmt.
Wird WSL2 für alle Windows-Funktionen benötigt?
Das Kommandozeilentool benötigt WSL2 unter Windows. Die Desktop-Anwendung läuft jedoch nativ unter Windows ohne WSL2. Die Desktop-App bietet ähnliche Funktionalität über eine grafische Benutzeroberfläche anstelle einer reinen Kommandozeileninteraktion.
Wie viel kostet die Nutzung von Claude Code?
Die Preise variieren je nach Nutzung und Abonnementstufe. Überprüfen Sie die offizielle Claude-Website für aktuelle Preise, da sich Kosten und Planstrukturen im Laufe der Zeit ändern. Einige Funktionen erfordern Claude Pro- oder Enterprise-Abonnements.
Kann Claude Code Dateien außerhalb des Projektverzeichnisses bearbeiten?
Standardmäßig beschränkt Claude Code aus Sicherheitsgründen den Dateizugriff auf das aktuelle Projektverzeichnis. Konfigurationseinstellungen können Berechtigungen erweitern, dies erfordert jedoch eine ausdrückliche Genehmigung. Die Sandboxing-Dokumentation behandelt das Berechtigungsmanagement detailliert.
Was ist der Unterschied zwischen Claude Code und der Claude API?
Claude Code ist ein Entwicklungswerkzeug für interaktive Code-Unterstützung. Die Claude API bietet programmatischen Zugriff zum Erstellen von Anwendungen, die die KI-Funktionen von Claude nutzen. Sie dienen unterschiedlichen Zwecken – eines für Entwickler, die Code schreiben, das andere für Anwendungen, die KI-Funktionen integrieren.
Entfernt die Deinstallation alle Claude Code-Daten?
Die Deinstallation entfernt die Anwendungsbinärdatei, kann aber Konfigurationsdateien und Cache-Daten hinterlassen. Eine vollständige Entfernung erfordert das manuelle Löschen des Verzeichnisses ~/.claude unter macOS und Linux oder des entsprechenden AppData-Speicherorts unter Windows.
Erste Schritte nach der Installation
Nachdem Claude Code installiert und verifiziert wurde, ist der nächste Schritt, zu verstehen, wie man es effektiv nutzt.
Die Schnellstart-Dokumentation empfiehlt, mit einfachen Aufgaben zu beginnen. Navigieren Sie zu einem bestehenden Projekt und führen Sie „claude“ aus, um eine interaktive Sitzung zu starten.
Bitten Sie Claude, die Projektstruktur zu erklären. Fordern Sie eine Zusammenfassung dessen an, was die Codebasis tut. Diese explorativen Abfragen helfen zu verstehen, wie das Tool Code interpretiert.
Versuchen Sie, kleine Änderungen vorzunehmen. Bitten Sie Claude, Kommentare zu Funktionen hinzuzufügen, einfache Testdateien zu erstellen oder grundlegende Codeblöcke zu refaktorieren. Diese Aufgaben demonstrieren Bearbeitungsfähigkeiten ohne Risiko.
Die Git-Integration funktioniert automatisch, wenn das Projekt Versionskontrolle verwendet. Claude Code kann Commits erstellen, Änderungen erklären und basierend auf den Änderungen Verbesserungen vorschlagen.
Die offizielle Dokumentation enthält Workflow-Beispiele für gängige Entwicklungsaufgaben. Diese decken Fehlerbehebung, Feature-Implementierung, Code-Überprüfung und automatisierte Tests ab.
Claude Code ist ein sich entwickelndes Tool. Die Installation ist nur die Grundlage. Das Verständnis seiner Fähigkeiten, Einschränkungen und Best Practices erfordert Experimentierfreude und Übung.
Bereit, Claude Code zu installieren? Laden Sie den entsprechenden Installer für Ihre Plattform von der offiziellen Website herunter und folgen Sie den in dieser Anleitung beschriebenen Schritten. Authentifizieren Sie sich mit Ihrem Claude-Konto, überprüfen Sie die korrekte Installation und beginnen Sie mit der Erkundung der KI-gestützten Entwicklung.
