​
Häufige Installationsprobleme

​
Windows-Installationsprobleme: Fehler in 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 sehen, wenn Sie claude ausführen, 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.

​
Linux und Mac Installationsprobleme: Berechtigung oder Befehl nicht gefunden Fehler

Bei der Installation von Claude Code mit npm können PATH-Probleme den Zugriff auf claude verhindern. Sie können auch auf Berechtigungsfehler stoßen, wenn Ihr npm-Global-Präfix nicht benutzerschreibbar ist (z.B. /usr oder /usr/local).

​
Empfohlene Lösung: Native Claude Code Installation

Claude Code hat eine native Installation, die nicht von npm oder Node.js abhängt.

Der native Claude Code Installer befindet sich derzeit in der Beta-Phase.

Verwenden Sie den folgenden Befehl, um den nativen Installer auszuführen.

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

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

Dieser Befehl installiert den entsprechenden Build von Claude Code für Ihr Betriebssystem und Ihre Architektur und fügt einen Symlink zur Installation bei ~/.local/bin/claude hinzu.

Stellen Sie sicher, dass Sie das Installationsverzeichnis in Ihrem System-PATH haben.

​
Alternative Lösung: Migration zu lokaler Installation

Alternativ, wenn Claude Code läuft, können Sie zu einer lokalen Installation migrieren:

claude migrate-installer

Dies verschiebt Claude Code nach ~/.claude/local/ und richtet einen Alias in Ihrer Shell-Konfiguration ein. Kein sudo ist für zukünftige Updates erforderlich.

Nach der Migration starten Sie Ihre Shell neu und überprüfen dann Ihre Installation:

Auf macOS/Linux/WSL:

which claude  # Sollte einen Alias zu ~/.claude/local/claude zeigen

Auf Windows:

where claude  # Sollte den Pfad zur claude-Ausführungsdatei zeigen

Installation überprüfen:

claude doctor # Installationsgesundheit prüfen

​
Berechtigungen und Authentifizierung

​
Wiederholte Berechtigungsaufforderungen

Wenn Sie sich dabei wiederfinden, dieselben Befehle wiederholt zu genehmigen, können Sie bestimmte Tools erlauben, ohne Genehmigung zu laufen, indem Sie den /permissions-Befehl verwenden. Siehe Berechtigungsdokumentation.

​
Authentifizierungsprobleme

Wenn Sie Authentifizierungsprobleme haben:

  1. Führen Sie /logout aus, um sich vollständig abzumelden
  2. Schließen Sie Claude Code
  3. Starten Sie mit claude neu und schließen Sie den Authentifizierungsprozess erneut ab

Wenn Probleme bestehen bleiben, versuchen Sie:

rm -rf ~/.config/claude-code/auth.json
claude

Dies entfernt Ihre gespeicherten Authentifizierungsinformationen und erzwingt eine saubere Anmeldung.

​
Leistung und Stabilität

​
Hohe CPU- oder Speichernutzung

Claude Code ist darauf ausgelegt, mit den meisten Entwicklungsumgebungen zu arbeiten, kann aber erhebliche Ressourcen verbrauchen, wenn große Codebasen verarbeitet werden. Wenn Sie Leistungsprobleme haben:

  1. Verwenden Sie /compact regelmäßig, um die Kontextgröße zu reduzieren
  2. Schließen und starten Sie Claude Code zwischen größeren Aufgaben neu
  3. Erwägen Sie, große Build-Verzeichnisse zu Ihrer .gitignore-Datei hinzuzufügen

​
Befehl hängt oder friert ein

Wenn Claude Code nicht reagiert:

  1. Drücken Sie Strg+C, um zu versuchen, die aktuelle Operation abzubrechen
  2. Wenn es nicht reagiert, müssen Sie möglicherweise das Terminal schließen und neu starten

​
ESC-Taste funktioniert nicht in JetBrains (IntelliJ, PyCharm, etc.) Terminals

Wenn Sie Claude Code in JetBrains-Terminals verwenden und die ESC-Taste den Agent nicht wie erwartet unterbricht, liegt dies wahrscheinlich an einem Tastenkombinationskonflikt mit JetBrains’ Standard-Shortcuts.

Um dieses Problem zu beheben:

  1. Gehen Sie zu Einstellungen → Tools → Terminal
  2. Klicken Sie auf den Hyperlink “Configure terminal keybindings” neben “Override IDE Shortcuts”
  3. Scrollen Sie in den Terminal-Tastenkombinationen nach unten zu “Switch focus to Editor” und löschen Sie diese Verknüpfung

Dies ermöglicht es der ESC-Taste, ordnungsgemäß für das Abbrechen von Claude Code-Operationen zu funktionieren, anstatt von PyCharms “Switch focus to Editor”-Aktion erfasst zu werden.

​
Such- und Entdeckungsprobleme

Wenn das Such-Tool, @file-Erwähnungen, benutzerdefinierte Agenten und benutzerdefinierte Slash-Befehle nicht funktionieren, installieren Sie das System-ripgrep:

# macOS (Homebrew)  
brew install ripgrep

# Windows (winget)
winget install BurntSushi.ripgrep.MSVC

# Ubuntu/Debian
sudo apt install ripgrep

# Alpine Linux
apk add ripgrep

# Arch Linux
pacman -S ripgrep

Setzen Sie dann USE_BUILTIN_RIPGREP=0 in Ihrer Umgebung.

​
Markdown-Formatierungsprobleme

Claude Code generiert manchmal Markdown-Dateien mit fehlenden Sprach-Tags auf Code-Zäunen, was die Syntaxhervorhebung und Lesbarkeit in GitHub, Editoren und Dokumentationstools beeinträchtigen kann.

​
Fehlende Sprach-Tags in Codeblöcken

Wenn Sie Codeblöcke wie diese in generiertem Markdown bemerken:

```
function example() {
  return "hello";
}
```

Anstatt ordnungsgemäß getaggte Blöcke wie:

```javascript
function example() {
  return "hello";
}
```

Lösungen:

  1. Bitten Sie Claude, Sprach-Tags hinzuzufügen: Fordern Sie einfach an “Bitte fügen Sie angemessene Sprach-Tags zu allen Codeblöcken in dieser Markdown-Datei hinzu.”

  2. Verwenden Sie Nachbearbeitungs-Hooks: Richten Sie automatische Formatierungs-Hooks ein, um fehlende Sprach-Tags zu erkennen und hinzuzufügen. Siehe das Markdown-Formatierungs-Hook-Beispiel für Implementierungsdetails.

  3. Manuelle Überprüfung: Nach der Generierung von Markdown-Dateien überprüfen Sie diese auf ordnungsgemäße Codeblock-Formatierung und fordern Sie Korrekturen an, falls erforderlich.

​
Inkonsistente Abstände und Formatierung

Wenn generiertes Markdown übermäßige Leerzeilen oder inkonsistente Abstände hat:

Lösungen:

  1. Formatierungskorrekturen anfordern: Bitten Sie Claude, “Abstands- und Formatierungsprobleme in dieser Markdown-Datei zu beheben.”

  2. Formatierungstools verwenden: Richten Sie Hooks ein, um Markdown-Formatierer wie prettier oder benutzerdefinierte Formatierungsskripte auf generierten Markdown-Dateien auszuführen.

  3. Formatierungsvorlieben spezifizieren: Schließen Sie Formatierungsanforderungen in Ihre Prompts oder Projekt-Speicher-Dateien ein.

​
Best Practices für Markdown-Generierung

Um Formatierungsprobleme zu minimieren:

  • Seien Sie explizit in Anfragen: Bitten Sie um “ordnungsgemäß formatiertes Markdown mit sprach-getaggten Codeblöcken”
  • Verwenden Sie Projektkonventionen: Dokumentieren Sie Ihren bevorzugten Markdown-Stil in CLAUDE.md
  • Richten Sie Validierungs-Hooks ein: Verwenden Sie Nachbearbeitungs-Hooks, um häufige Formatierungsprobleme automatisch zu überprüfen und zu beheben

​
Weitere Hilfe erhalten

Wenn Sie Probleme haben, die hier nicht behandelt werden:

  1. Verwenden Sie den /bug-Befehl innerhalb von Claude Code, um Probleme direkt an Anthropic zu melden
  2. Überprüfen Sie das GitHub-Repository auf bekannte Probleme
  3. Führen Sie /doctor aus, um die Gesundheit Ihrer Claude Code-Installation zu überprüfen
  4. Fragen Sie Claude direkt nach seinen Fähigkeiten und Funktionen - Claude hat eingebauten Zugriff auf seine Dokumentation