Zum Hauptinhalt springen

​
Häufige Installationsprobleme

​
Windows-Installationsprobleme: Fehler in WSL

Sie könnten die folgenden Probleme in WSL antreffen: Probleme bei der Betriebssystem-/Plattformerkennung: 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, nicht mit /mnt/c/. Um dies zu beheben, versuchen Sie, Node über den Paketmanager Ihrer Linux-Distribution oder über nvm zu installieren. nvm-Versionskonflikte: Wenn Sie nvm sowohl in WSL als auch in Windows installiert haben, können beim Wechsel von Node-Versionen in WSL Versionskonflikte auftreten. Dies geschieht, weil WSL standardmäßig den Windows PATH importiert, was dazu führt, dass Windows nvm/npm Vorrang vor der WSL-Installation hat. Sie können dieses Problem identifizieren durch:
  • Ausführen von which npm und which node - wenn sie auf Windows-Pfade zeigen (beginnend mit /mnt/c/), werden Windows-Versionen verwendet
  • Fehlerhafte Funktionalität nach dem Wechsel von Node-Versionen mit nvm in WSL
Um dieses Problem zu beheben, korrigieren Sie Ihren Linux PATH, um sicherzustellen, dass die Linux-Versionen von node/npm Vorrang haben: Primäre Lösung: Stellen Sie sicher, dass nvm ordnungsgemäß in Ihrer Shell geladen wird Die häufigste Ursache ist, dass nvm nicht in nicht-interaktiven Shells geladen wird. Fügen Sie Folgendes zu Ihrer Shell-Konfigurationsdatei (~/.bashrc, ~/.zshrc, usw.) hinzu: 
# Load nvm if it exists
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
Oder führen Sie direkt in Ihrer aktuellen Sitzung aus: 
source ~/.nvm/nvm.sh
Alternative: PATH-Reihenfolge anpassen Wenn nvm ordnungsgemäß geladen ist, aber Windows-Pfade immer noch Vorrang haben, können Sie Ihre Linux-Pfade explizit am Anfang von PATH in Ihrer Shell-Konfiguration hinzufügen: 
export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"
Vermeiden Sie das Deaktivieren des Windows PATH-Imports (appendWindowsPath = false), da dies die Möglichkeit, Windows-Executables von WSL aus aufzurufen, beeinträchtigt. Vermeiden Sie auch das Deinstallieren von Node.js von Windows, wenn Sie es für Windows-Entwicklung verwenden.

​
Linux- und Mac-Installationsprobleme: Berechtigungs- 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-Präfix für globale Pakete nicht vom Benutzer beschreibbar 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. Verwenden Sie den folgenden Befehl, um das native Installationsprogramm auszuführen. macOS, Linux, WSL: 
# Install stable version (default)
curl -fsSL https://claude.ai/install.sh | bash

# Install latest version
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Install specific version number
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
Windows PowerShell: 
# Install stable version (default)
irm https://claude.ai/install.ps1 | iex

# Install latest version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# Install specific version number
& ([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 unter ~/.local/bin/claude (oder %USERPROFILE%\.local\bin\claude.exe unter Windows) hinzu.
Stellen Sie sicher, dass Sie das Installationsverzeichnis in Ihrem System PATH haben.

​
Windows: “Claude Code unter Windows erfordert git-bash”

Claude Code unter nativem Windows erfordert Git für Windows, das Git Bash enthält. Wenn Git installiert ist, aber nicht erkannt wird:
  1. Legen Sie den Pfad explizit in PowerShell fest, bevor Sie Claude ausführen: 
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
  2. Oder fügen Sie es dauerhaft zu Ihren Systemumgebungsvariablen über Systemeigenschaften → Umgebungsvariablen hinzu.
Wenn Git an einem nicht standardmäßigen Ort installiert ist, passen Sie den Pfad entsprechend an.

​
Windows: “installMethod ist native, aber claude-Befehl nicht gefunden”

Wenn Sie diesen Fehler nach der Installation sehen, ist der claude-Befehl nicht in Ihrem PATH. Fügen Sie ihn manuell hinzu:
1

Öffnen Sie Umgebungsvariablen

Drücken Sie Win + R, geben Sie sysdm.cpl ein und drücken Sie Enter. Klicken Sie auf Erweitert → Umgebungsvariablen.
2

Bearbeiten Sie Benutzer PATH

Wählen Sie unter “Benutzervariablen” Pfad aus und klicken Sie auf Bearbeiten. Klicken Sie auf Neu und fügen Sie hinzu:
%USERPROFILE%\.local\bin
3

Starten Sie Ihr Terminal neu

Schließen Sie PowerShell oder CMD und öffnen Sie es erneut, damit die Änderungen wirksam werden.
Überprüfen Sie die Installation: 
claude doctor # Check installation health

​
Berechtigungen und Authentifizierung

​
Wiederholte Berechtigungsaufforderungen

Wenn Sie sich wiederholt zum Genehmigen derselben Befehle aufgefordert finden, können Sie bestimmte Tools ohne Genehmigung ausführen lassen, 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 führen Sie den Authentifizierungsprozess erneut aus
Wenn die Probleme bestehen bleiben, versuchen Sie: 
rm -rf ~/.config/claude-code/auth.json
claude
Dies entfernt Ihre gespeicherten Authentifizierungsinformationen und erzwingt eine saubere Anmeldung.

​
Konfigurationsdateispeicherorte

Claude Code speichert die Konfiguration an mehreren Orten:
DateiZweck
~/.claude/settings.jsonBenutzereinstellungen (Berechtigungen, Hooks, Modellüberschreibungen)
.claude/settings.jsonProjekteinstellungen (in Versionskontrolle eingecheckt)
.claude/settings.local.jsonLokale Projekteinstellungen (nicht committed)
~/.claude.jsonGlobaler Status (Design, OAuth, MCP-Server, zulässige Tools)
.mcp.jsonProjekt-MCP-Server (in Versionskontrolle eingecheckt)
managed-settings.jsonVerwaltete Einstellungen
managed-mcp.jsonVerwaltete MCP-Server
Unter Windows bezieht sich ~ auf Ihr Benutzer-Heimatverzeichnis, z. B. C:\Users\YourName. Speicherorte verwalteter Dateien:
  • macOS: /Library/Application Support/ClaudeCode/
  • Linux/WSL: /etc/claude-code/
  • Windows: C:\Program Files\ClaudeCode\
Weitere Informationen zum Konfigurieren dieser Dateien finden Sie unter Einstellungen und MCP.

​
Konfiguration zurücksetzen

Um Claude Code auf Standardeinstellungen zurückzusetzen, können Sie die Konfigurationsdateien entfernen: 
# Reset all user settings and state
rm ~/.claude.json
rm -rf ~/.claude/

# Reset project-specific settings
rm -rf .claude/
rm .mcp.json
Dies entfernt alle Ihre Einstellungen, zulässigen Tools, MCP-Serverkonfigurationen und Sitzungsverlauf.

​
Leistung und Stabilität

​
Hohe CPU- oder Speicherauslastung

Claude Code ist für die Zusammenarbeit mit den meisten Entwicklungsumgebungen konzipiert, kann aber beim Verarbeiten großer Codebasen erhebliche Ressourcen verbrauchen. 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 großen 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 Ctrl+C, um zu versuchen, den aktuellen Vorgang abzubrechen
  2. Wenn nicht reagiert, müssen Sie möglicherweise das Terminal schließen und neu starten

​
Such- und Erkennungsprobleme

Wenn das Such-Tool, @file-Erwähnungen, benutzerdefinierte Agenten und benutzerdefinierte Schrägstrich-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
Legen Sie dann USE_BUILTIN_RIPGREP=0 in Ihren Umgebungsvariablen fest.

​
Langsame oder unvollständige Suchergebnisse auf WSL

Leistungseinbußen beim Lesen von Datenträgern beim Arbeiten über Dateisysteme auf WSL können zu weniger als erwarteten Übereinstimmungen führen (aber nicht zu einem vollständigen Mangel an Suchfunktionalität), wenn Sie Claude Code auf WSL verwenden.
/doctor zeigt in diesem Fall Search als OK an.
Lösungen:
  1. Geben Sie spezifischere Suchvorgänge ein: Reduzieren Sie die Anzahl der durchsuchten Dateien, indem Sie Verzeichnisse oder Dateitypen angeben: “Suchen Sie nach JWT-Validierungslogik im auth-service-Paket” oder “Finden Sie die Verwendung von md5-Hash in JS-Dateien”.
  2. Verschieben Sie das Projekt in das Linux-Dateisystem: Stellen Sie nach Möglichkeit sicher, dass sich Ihr Projekt im Linux-Dateisystem (/home/) und nicht im Windows-Dateisystem (/mnt/c/) befindet.
  3. Verwenden Sie stattdessen natives Windows: Erwägen Sie, Claude Code nativ unter Windows statt über WSL auszuführen, um eine bessere Dateisystemleistung zu erzielen.

​
IDE-Integrationsprobleme

​
JetBrains IDE nicht erkannt auf WSL2

Wenn Sie Claude Code auf WSL2 mit JetBrains IDEs verwenden und Fehler “Keine verfügbaren IDEs erkannt” erhalten, liegt dies wahrscheinlich an der Netzwerkkonfiguration von WSL2 oder der Windows Firewall, die die Verbindung blockiert.

​
WSL2-Netzwerkmodi

WSL2 verwendet standardmäßig NAT-Netzwerk, das IDE-Erkennung verhindern kann. Sie haben zwei Optionen: Option 1: Konfigurieren Sie die Windows Firewall (empfohlen)
  1. Finden Sie Ihre WSL2-IP-Adresse: 
    wsl hostname -I
# Example output: 172.21.123.456
  2. Öffnen Sie PowerShell als Administrator und erstellen Sie eine Firewall-Regel: 
    New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16
    (Passen Sie den IP-Bereich basierend auf Ihrem WSL2-Subnetz aus Schritt 1 an)
  3. Starten Sie sowohl Ihre IDE als auch Claude Code neu
Option 2: Wechseln Sie zu gespiegeltem Netzwerk Fügen Sie zu .wslconfig in Ihrem Windows-Benutzerverzeichnis hinzu: 
[wsl2]
networkingMode=mirrored
Starten Sie dann WSL mit wsl --shutdown von PowerShell neu.
Diese Netzwerkprobleme betreffen nur WSL2. WSL1 verwendet das Netzwerk des Hosts direkt und erfordert diese Konfigurationen nicht.
Weitere JetBrains-Konfigurationstipps finden Sie in unserem JetBrains IDE-Leitfaden.

​
Melden von Windows IDE-Integrationsproblemen (sowohl nativ als auch WSL)

Wenn Sie IDE-Integrationsprobleme unter Windows haben, erstellen Sie ein Problem mit den folgenden Informationen:
  • Umgebungstyp: natives Windows (Git Bash) oder WSL1/WSL2
  • WSL-Netzwerkmodus (falls zutreffend): NAT oder gespiegelt
  • IDE-Name und Version
  • Claude Code-Erweiterungs-/Plugin-Version
  • Shell-Typ: Bash, Zsh, PowerShell, usw.

​
Escape-Taste funktioniert nicht in JetBrains (IntelliJ, PyCharm, usw.) Terminals

Wenn Sie Claude Code in JetBrains-Terminals verwenden und die Esc-Taste den Agenten nicht wie erwartet unterbricht, liegt dies wahrscheinlich an einem Tastenkombinationskonflikt mit den Standardverknüpfungen von JetBrains. Um dieses Problem zu beheben:
  1. Gehen Sie zu Einstellungen → Tools → Terminal
  2. Entweder:
    • Deaktivieren Sie “Fokus mit Escape zum Editor verschieben”, oder
    • Klicken Sie auf “Terminal-Tastenkombinationen konfigurieren” und löschen Sie die Verknüpfung “Fokus zum Editor wechseln”
  3. Wenden Sie die Änderungen an
Dies ermöglicht der Esc-Taste, Claude Code-Operationen ordnungsgemäß zu unterbrechen.

​
Markdown-Formatierungsprobleme

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

​
Fehlende Sprach-Tags in Code-Blöcken

Wenn Sie Code-Blöcke wie diesen in generiertem Markdown bemerken: 
```
function example() {
  return "hello";
}
```
Anstelle von ordnungsgemäß gekennzeichneten Blöcken wie: 
```javascript
function example() {
  return "hello";
}
```
Lösungen:
  1. Bitten Sie Claude, Sprach-Tags hinzuzufügen: Fordern Sie “Fügen Sie geeignete Sprach-Tags zu allen Code-Blöcken in dieser Markdown-Datei hinzu.”
  2. Verwenden Sie Post-Processing-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: Überprüfen Sie nach dem Generieren von Markdown-Dateien diese auf ordnungsgemäße Code-Block-Formatierung und fordern Sie Korrektionen an, falls erforderlich.

​
Inkonsistente Abstände und Formatierung

Wenn generiertes Markdown übermäßige Leerzeilen oder inkonsistente Abstände hat: Lösungen:
  1. Formatierungskorrektionen anfordern: Bitten Sie Claude, “Abstands- und Formatierungsprobleme in dieser Markdown-Datei zu beheben.”
  2. Verwenden Sie Formatierungswerkzeuge: Richten Sie Hooks ein, um Markdown-Formatierer wie prettier oder benutzerdefinierte Formatierungsskripte auf generierte Markdown-Dateien auszuführen.
  3. Geben Sie Formatierungspräferenzen an: Fügen Sie Formatierungsanforderungen in Ihre Eingabeaufforderungen oder Projekt-Memory-Dateien ein.

​
Best Practices für Markdown-Generierung

Um Formatierungsprobleme zu minimieren:
  • Seien Sie explizit in Anfragen: Fordern Sie “ordnungsgemäß formatiertes Markdown mit Sprach-gekennzeichneten Code-Blöcken” an
  • Verwenden Sie Projektkonventionen: Dokumentieren Sie Ihren bevorzugten Markdown-Stil in CLAUDE.md
  • Richten Sie Validierungs-Hooks ein: Verwenden Sie Post-Processing-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 in 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 integrierten Zugriff auf seine Dokumentation