​
Systemanforderungen

  • Betriebssysteme: macOS 10.15+, Ubuntu 20.04+/Debian 10+, oder Windows über WSL
  • Hardware: 4GB RAM mindestens
  • Software:
    • Node.js 18+
    • git 2.23+ (optional)
    • GitHub oder GitLab CLI für PR-Workflows (optional)
  • Netzwerk: Internetverbindung erforderlich für Authentifizierung und KI-Verarbeitung
  • Standort: Nur in unterstützten Ländern verfügbar

​
Installieren und authentifizieren

1

Claude Code installieren

Install NodeJS 18+, then run:

npm install -g @anthropic-ai/claude-code

Do NOT use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see configure Claude Code for recommended solutions.

2

Zu Ihrem Projekt navigieren

cd your-project-directory
3

Claude Code starten

claude
4

Authentifizierung abschließen

Claude Code bietet mehrere Authentifizierungsoptionen:

  1. Anthropic Console: Die Standardoption. Verbinden Sie sich über die Anthropic Console und schließen Sie den OAuth-Prozess ab. Erfordert aktive Abrechnung bei console.anthropic.com.
  2. Claude App (mit Pro oder Max Plan): Abonnieren Sie Claudes Pro oder Max Plan für ein einheitliches Abonnement, das sowohl Claude Code als auch die Web-Oberflä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 während des Starts die Option, die zu Ihrem Abonnementtyp passt.
  3. Enterprise-Plattformen: Konfigurieren Sie Claude Code für die Verwendung von Amazon Bedrock oder Google Vertex AI für Enterprise-Bereitstellungen mit Ihrer bestehenden Cloud-Infrastruktur.

​
Ihr Projekt initialisieren

Für Erstbenutzer empfehlen wir:

1

Claude Code starten

claude
2

Einen einfachen Befehl ausführen

> summarize this project
3

Eine CLAUDE.md Projektanleitung generieren

/init
4

Die generierte CLAUDE.md-Datei committen

Bitten Sie Claude, die generierte CLAUDE.md-Datei in Ihr Repository zu committen.

​
Fehlerbehebung

​
Fehlerbehebung bei WSL-Installation

Derzeit läuft Claude Code nicht direkt unter Windows und erfordert stattdessen WSL.

Sie könnten auf die folgenden Probleme in WSL stoßen:

OS/Plattform-Erkennungsprobleme: Wenn Sie während der Installation einen Fehler erhalten, verwendet WSL möglicherweise Windows npm. Versuchen Sie:

  • Führen Sie npm config set os linux vor der Installation aus
  • Installieren Sie mit npm install -g @anthropic-ai/claude-code --force --no-os-check (Verwenden Sie NICHT sudo)

Node nicht gefunden Fehler: Wenn Sie exec: node: not found beim Ausführen von claude sehen, verwendet Ihre WSL-Umgebung möglicherweise eine Windows-Installation von Node.js. Sie können dies mit which npm und which node bestätigen, die auf Linux-Pfade zeigen sollten, die mit /usr/ beginnen, anstatt mit /mnt/c/. Um dies zu beheben, versuchen Sie Node über den Paketmanager Ihrer Linux-Distribution oder über nvm zu installieren.

​
Ihre Terminal-Einrichtung optimieren

Claude Code funktioniert am besten, wenn Ihr Terminal ordnungsgemäß konfiguriert ist. Befolgen Sie diese Richtlinien, um Ihre Erfahrung zu optimieren.

Unterstützte Shells:

  • Bash
  • Zsh
  • Fish

​
Themes und Erscheinungsbild

Claude kann das Theme Ihres Terminals nicht steuern. Das wird von Ihrer Terminal-Anwendung gehandhabt. Sie können das Theme von Claude Code während des Onboardings oder jederzeit über den /config-Befehl an Ihr Terminal anpassen

​
Zeilenumbrüche

Sie haben mehrere Optionen, um Zeilenumbrüche in Claude Code einzugeben:

  • Schnelles Escape: Geben Sie \ gefolgt von Enter ein, um eine neue Zeile zu erstellen
  • Tastenkombination: Drücken Sie Option+Enter (Meta+Enter) mit ordnungsgemäßer Konfiguration

Um Option+Enter in Ihrem Terminal einzurichten:

Für Mac Terminal.app:

  1. Öffnen Sie Einstellungen → Profile → Tastatur
  2. Aktivieren Sie “Option als Meta-Taste verwenden”

Für iTerm2 und VSCode Terminal:

  1. Öffnen Sie Einstellungen → Profile → Tasten
  2. Unter Allgemein, setzen Sie die linke/rechte Option-Taste auf “Esc+”

Tipp für iTerm2 und VSCode-Benutzer: Führen Sie /terminal-setup innerhalb von Claude Code aus, um automatisch Shift+Enter als intuitivere Alternative zu konfigurieren.

​
Benachrichtigungseinrichtung

Verpassen Sie nie, wenn Claude eine Aufgabe mit ordnungsgemäßer Benachrichtigungskonfiguration abschließt:

​
Terminal-Glocken-Benachrichtigungen

Aktivieren Sie Tonalarme, wenn Aufgaben abgeschlossen sind:

claude config set --global preferredNotifChannel terminal_bell

Für macOS-Benutzer: Vergessen Sie nicht, Benachrichtigungsberechtigungen in Systemeinstellungen → Benachrichtigungen → [Ihre Terminal-App] zu aktivieren.

​
iTerm 2 Systembenachrichtigungen

Für iTerm 2-Alarme, wenn Aufgaben abgeschlossen sind:

  1. Öffnen Sie iTerm 2 Einstellungen
  2. Navigieren Sie zu Profile → Terminal
  3. Aktivieren Sie “Glocke stumm schalten” und Filter-Alarme → “Escape-Sequenz-generierte Alarme senden”
  4. Stellen Sie Ihre bevorzugte Benachrichtigungsverzögerung ein

Beachten Sie, dass diese Benachrichtigungen spezifisch für iTerm 2 sind und nicht im Standard-macOS-Terminal verfügbar sind.

​
Umgang mit großen Eingaben

Beim Arbeiten mit umfangreichem Code oder langen Anweisungen:

  • Vermeiden Sie direktes Einfügen: Claude Code kann Schwierigkeiten mit sehr langen eingefügten Inhalten haben
  • Verwenden Sie dateibasierte Workflows: Schreiben Sie Inhalte in eine Datei und bitten Sie Claude, sie zu lesen
  • Seien Sie sich der VS Code-Einschränkungen bewusst: Das VS Code-Terminal neigt besonders dazu, lange Einfügungen abzuschneiden

​
Vim-Modus

Claude Code unterstützt eine Teilmenge von Vim-Tastenbindungen, die mit /vim aktiviert oder über /config konfiguriert werden können.

Die unterstützte Teilmenge umfasst:

  • Moduswechsel: Esc (zu NORMAL), i/I, a/A, o/O (zu INSERT)
  • Navigation: h/j/k/l, w/e/b, 0/$/^, gg/G
  • Bearbeitung: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (wiederholen)