Zum Hauptinhalt springen

Systemanforderungen

  • Betriebssysteme: macOS 10.15+, Ubuntu 20.04+/Debian 10+ oder Windows 10+ (mit WSL 1, WSL 2 oder Git für Windows)
  • Hardware: 4GB+ RAM
  • Software: Node.js 18+ (nur für NPM-Installation erforderlich)
  • Netzwerk: Internetverbindung erforderlich für Authentifizierung und KI-Verarbeitung
  • Shell: Funktioniert am besten in Bash, Zsh oder Fish
  • Standort: Von Anthropic unterstützte Länder

Zusätzliche Abhängigkeiten

Standardinstallation

To install Claude Code, use one of the following methods:
Einige Benutzer werden möglicherweise automatisch zu einer verbesserten Installationsmethode migriert.
Nach Abschluss des Installationsvorgangs navigieren Sie zu Ihrem Projekt und starten Claude Code:
cd your-awesome-project
claude
Claude Code bietet die folgenden Authentifizierungsoptionen:
  1. Claude Console: Die Standardoption. Verbinden Sie sich über die Claude Console und schließen Sie den OAuth-Prozess ab. Erfordert aktive Abrechnung unter console.anthropic.com. Ein „Claude Code”-Arbeitsbereich wird automatisch für Nutzungsverfolgung und Kostenverwaltung erstellt. Beachten Sie, dass Sie keine API-Schlüssel für den Claude Code-Arbeitsbereich erstellen können – er ist ausschließlich für die Claude Code-Nutzung vorgesehen.
  2. Claude App (mit Pro- oder Max-Plan): Abonnieren Sie Claude’s Pro- oder Max-Plan für ein einheitliches Abonnement, das sowohl Claude Code als auch die Weboberfläche umfasst. Erhalten Sie mehr Wert zum gleichen Preis und verwalten Sie Ihr Konto an einem Ort. Melden Sie sich mit Ihrem Claude.ai-Konto an. Wählen Sie beim Start die Option, die Ihrem Abonnementtyp entspricht.
  3. Enterprise-Plattformen: Konfigurieren Sie Claude Code für die Verwendung von Amazon Bedrock oder Google Vertex AI für Enterprise-Bereitstellungen mit Ihrer vorhandenen Cloud-Infrastruktur.
Claude Code speichert Ihre Anmeldedaten sicher. Weitere Informationen finden Sie unter Credential Management.

Windows-Setup

Option 1: Claude Code innerhalb von WSL
  • Sowohl WSL 1 als auch WSL 2 werden unterstützt
Option 2: Claude Code auf nativem Windows mit Git Bash
  • Erfordert Git für Windows
  • Für tragbare Git-Installationen geben Sie den Pfad zu Ihrer bash.exe an:
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
    

Alternative Installationsmethoden

Claude Code bietet mehrere Installationsmethoden für verschiedene Umgebungen. Wenn Sie während der Installation auf Probleme stoßen, konsultieren Sie die Fehlerbehebungsanleitung.
Führen Sie claude doctor nach der Installation aus, um Ihren Installationstyp und die Version zu überprüfen.

Native Installationsoptionen

Die native Installation ist die empfohlene Methode und bietet mehrere Vorteile:
  • Eine eigenständige ausführbare Datei
  • Keine Node.js-Abhängigkeit
  • Verbesserte Stabilität des Auto-Updaters
Wenn Sie bereits eine Installation von Claude Code haben, verwenden Sie claude install, um zur nativen Binärinstallation zu migrieren. Für erweiterte Installationsoptionen mit dem nativen Installer: macOS, Linux, WSL:
# Stabile Version installieren (Standard)
curl -fsSL https://claude.ai/install.sh | bash

# Neueste Version installieren
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Spezifische Versionsnummer installieren
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
Alpine Linux und andere musl/uClibc-basierte Distributionen: Der native Build erfordert die Installation von libgcc, libstdc++ und ripgrep. Installieren Sie (Alpine: apk add libgcc libstdc++ ripgrep) und setzen Sie USE_BUILTIN_RIPGREP=0.
Claude Code, das über Homebrew installiert wird, wird automatisch außerhalb des Brew-Verzeichnisses aktualisiert, es sei denn, es wird explizit mit der Umgebungsvariablen DISABLE_AUTOUPDATER deaktiviert (siehe Abschnitt Auto-Updates).
Windows PowerShell:
# Stabile Version installieren (Standard)
irm https://claude.ai/install.ps1 | iex

# Neueste Version installieren
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# Spezifische Versionsnummer installieren
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
Windows CMD:
REM Stabile Version installieren (Standard)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

REM Neueste Version installieren
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd

REM Spezifische Versionsnummer installieren
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd
Stellen Sie sicher, dass Sie alle veralteten Aliase oder Symlinks vor der Installation entfernen.

NPM-Installation

Für Umgebungen, in denen NPM bevorzugt oder erforderlich ist:
npm install -g @anthropic-ai/claude-code
Verwenden Sie NICHT sudo npm install -g, da dies zu Berechtigungsproblemen und Sicherheitsrisiken führen kann. Wenn Sie auf Berechtigungsfehler stoßen, siehe Claude Code konfigurieren für empfohlene Lösungen.

Lokale Installation

  • Nach globaler Installation über npm verwenden Sie claude migrate-installer, um zur lokalen Installation zu wechseln
  • Vermeidet Probleme mit Auto-Updater-npm-Berechtigungen
  • Einige Benutzer werden möglicherweise automatisch zu dieser Methode migriert

Ausführung auf AWS oder GCP

Standardmäßig verwendet Claude Code die Claude API. Weitere Informationen zur Ausführung von Claude Code auf AWS oder GCP finden Sie unter Integrationen von Drittanbietern.

Claude Code aktualisieren

Auto-Updates

Claude Code aktualisiert sich automatisch, um sicherzustellen, dass Sie die neuesten Funktionen und Sicherheitspatches haben.
  • Update-Überprüfungen: Werden beim Start und regelmäßig während der Ausführung durchgeführt
  • Update-Prozess: Downloads und Installationen erfolgen automatisch im Hintergrund
  • Benachrichtigungen: Sie erhalten eine Benachrichtigung, wenn Updates installiert werden
  • Anwendung von Updates: Updates werden beim nächsten Start von Claude Code wirksam
Auto-Updates deaktivieren: Setzen Sie die Umgebungsvariable DISABLE_AUTOUPDATER in Ihrer Shell oder settings.json-Datei:
export DISABLE_AUTOUPDATER=1

Manuell aktualisieren

claude update