Claude Code Download und Installation: Windows, macOS, Linux
Claude Code läuft im Terminal, in unterstützten IDEs, in der Desktop-App und im Browser. Für die CLI empfiehlt Anthropic eine native Installation; macOS, Linux, Windows und WSL haben dokumentierte Wege. Diese Anleitung führt durch Zugang, Installation und den ersten sicheren Projekttest.
Was du vor dem Download wissen solltest
Claude Code ist für Entwickler gedacht, die Claude direkt im Projektverzeichnis arbeiten lassen wollen. Die offizielle Grundlage ist die Claude-Code-Dokumentation.
Stand 3. November 2026 nennt die offizielle Setup-Anleitung diese Voraussetzungen: macOS 13.0 oder neuer, Windows 10 ab Version 1809 oder Windows Server 2019, Ubuntu 20.04, Debian 10 oder Alpine 3.19 und neuer, mindestens 4 GB RAM sowie eine Internetverbindung. Du brauchst ein Pro-, Max-, Ultra-, Team-, Enterprise- oder Console-Konto; der kostenlose Claude-Plan enthält keinen Zugang zu Claude Code.
Vor der Installation solltest du klären: Welcher Claude-Plan wird genutzt, welche Repos sind erlaubt, wie wird mit Secrets umgegangen, welche Tests müssen nach Änderungen laufen und wer reviewed die Ergebnisse?
Installation nach Betriebssystem
Anthropic empfiehlt die native CLI-Installation. Die offizielle Übersicht enthält die aktuellen Befehle und Alternativen:
- macOS und Linux: natives Installationsskript oder auf macOS Homebrew.
- Windows: natives PowerShell-/CMD-Skript oder WinGet; Git for Windows unterstützt die Bash-Nutzung. WSL bleibt eine weitere Option.
- Browser und Desktop: Claude Code kann dort auch ohne separat installierte Terminal-CLI genutzt werden; Oberfläche und Tarif prüfen.
Die nativen Installationsbefehle laut Setup-Anleitung (Stand 3. November 2026):
- macOS, Linux und WSL:
curl -fsSL https://claude.ai/install.sh | bash - Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Für die Windows-Eingabeaufforderung (CMD) und für Homebrew, WinGet oder Linux-Paketmanager stehen die Varianten in derselben Anleitung. Kopiere Befehle immer von dort, falls sie sich ändern. Nach der Installation im Projektverzeichnis claude starten, anmelden und zuerst eine kleine lesende Aufgabe ausführen. Die native CLI aktualisiert sich automatisch; Homebrew und WinGet benötigen laut Anthropic eigene Update-Schritte.
Troubleshooting: die häufigsten Installationsfehler
- Befehl nicht gefunden: Installationspfad und Shell-PATH prüfen, danach das Terminal vollständig neu starten.
- Login öffnet nicht: Standardbrowser, Pop-up-Blocker, VPN und Unternehmens-Proxy kontrollieren.
- Windows-Pfade brechen: In der nativen Installation zuerst Git for Windows, Shell-Auswahl und Projektpfad prüfen. Wer WSL2 nutzt, sollte Projekt, Git und Claude Code vollständig innerhalb derselben WSL-Umgebung halten.
- Permission denied: Keine pauschalen Admin-Rechte vergeben; Besitzer und Rechte des Projektordners gezielt korrigieren.
- Node/npm-Konflikt: Nur den aktuell dokumentierten Installationsweg verwenden und alte globale Installationen sauber entfernen.
- Repo wird nicht verstanden: Im Projekt-Root starten und eine kurze
CLAUDE.mdmit Build-, Test- und Architekturhinweisen anlegen. - MCP startet nicht: Server zunächst einzeln, read-only und mit absoluten Pfaden testen; Logs auf fehlende Umgebungsvariablen prüfen.
Nach jeder Installation folgt ein Smoke Test: Repo lesen, eine harmlose Änderung auf einem Branch erzeugen, Tests starten und den Diff manuell prüfen.
Erste Projektdateien: CLAUDE.md und Permissions
Nach dem Login ist die wichtigste Datei nicht Code, sondern CLAUDE.md. Dort stehen Architektur, Build-Kommandos, Testregeln, Branching, Stil und Grenzen.
Zusätzlich sollten Permissions eng starten: lesen, analysieren und kleine Änderungen sind okay. Riskante Befehle, Deployments, Secret-Zugriffe und produktive Systeme brauchen Freigabe.
Team-Installation professionell aufsetzen
Bei Teams reicht eine Installationsanleitung nicht. Sinnvoll sind ein Standard-Setup, geteilte Slash-Commands, Hooks, Security-Regeln, Kostenkontrolle und MCP-Verbindungen zu GitHub, Jira oder Linear.
Den kompletten Team-Standard beschreiben wir hier: Claude Code für Teams.
Installations-Checkliste für Teams
- Der offiziell empfohlene native Installationsweg ist auf allen Entwicklerrechnern dokumentiert und getestet; npm ist dafür keine Voraussetzung.
- Windows-Nutzer wählen PowerShell, CMD oder WinGet für native Installation; Git for Windows ist für das Bash-Tool empfohlen. WSL bleibt eine eigenständige Alternative.
- Jedes Repo enthält eine gepflegte
CLAUDE.mdmit Build-, Test- und Review-Regeln. - Secrets liegen in Env-Variablen oder Secret-Managern, nicht im Repo.
- Riskante Befehle wie Deploy, Datenbankmigration und Datei-Löschung brauchen Freigabe.
Smoke Test nach der Installation
Nach der Installation sollte Claude Code nicht direkt große Refactors bekommen. Ein sinnvoller Smoke Test ist klein und überprüfbar:
- Projektordner öffnen und Claude die Architektur zusammenfassen lassen.
- Build- und Test-Kommandos aus
package.jsonoder Doku erkennen lassen. - Eine kleine README- oder Kommentarverbesserung vorschlagen lassen.
- Diff prüfen, Tests laufen lassen, Änderung verwerfen oder committen.
Wenn Claude schon hier falsche Annahmen trifft, fehlt Projektkontext in CLAUDE.md.
Standard-Setup, das wir in jedem Repo hinterlegen
| Baustein | Zweck |
|---|---|
CLAUDE.md | Architektur, Regeln, Tests, No-Go-Bereiche. |
| Slash-Commands | Wiederholbare Aufgaben wie Review, Test-Fix, Migration, Release Notes. |
| Hooks | Formatter, Secret-Checks, Test-Hinweise, riskante Aktionen markieren. |
| MCP | GitHub, Issues, interne Docs und Projektwissen gezielt bereitstellen. |
Quellen und Produktstand
Produktangaben wurden am 3. November 2026 geprüft. Der Zugang kann je nach Tarif und Rollout abweichen.