​
Häufige Installationsprobleme

​
Linux-Berechtigungsprobleme

Bei der Installation von Claude Code mit npm können Berechtigungsfehler auftreten, wenn Ihr globales npm-Präfix nicht vom Benutzer beschreibbar ist (z.B. /usr oder /usr/local).

​
Empfohlene Lösung: Erstellen Sie ein vom Benutzer beschreibbares npm-Präfix

Der sicherste Ansatz ist die Konfiguration von npm zur Verwendung eines Verzeichnisses innerhalb Ihres Home-Ordners:

# Speichern Sie zunächst eine Liste Ihrer vorhandenen globalen Pakete für die spätere Migration
npm list -g --depth=0 > ~/npm-global-packages.txt

# Erstellen Sie ein Verzeichnis für Ihre globalen Pakete
mkdir -p ~/.npm-global

# Konfigurieren Sie npm zur Verwendung des neuen Verzeichnispfads
npm config set prefix ~/.npm-global

# Hinweis: Ersetzen Sie ~/.bashrc durch ~/.zshrc, ~/.profile oder eine andere passende Datei für Ihre Shell
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# Wenden Sie die neue PATH-Einstellung an
source ~/.bashrc

# Installieren Sie nun Claude Code am neuen Speicherort
npm install -g @anthropic-ai/claude-code

# Optional: Installieren Sie Ihre vorherigen globalen Pakete am neuen Speicherort
# Schauen Sie in ~/npm-global-packages.txt nach und installieren Sie die Pakete, die Sie behalten möchten

Diese Lösung wird empfohlen, weil sie:

  • Vermeidet die Änderung von Systemverzeichnisberechtigungen
  • Einen sauberen, dedizierten Speicherort für Ihre globalen npm-Pakete erstellt
  • Den Sicherheitsrichtlinien folgt

​
Systemwiederherstellung: Wenn Sie Befehle ausgeführt haben, die Eigentümerschaft und Berechtigungen von Systemdateien oder Ähnliches ändern

Wenn Sie bereits einen Befehl ausgeführt haben, der die Systemverzeichnisberechtigungen geändert hat (wie sudo chown -R $USER:$(id -gn) /usr && sudo chmod -R u+w /usr) und Ihr System jetzt defekt ist (zum Beispiel, wenn Sie sudo: /usr/bin/sudo must be owned by uid 0 and have the setuid bit set sehen), müssen Sie Wiederherstellungsschritte durchführen.

Ubuntu/Debian Wiederherstellungsmethode:

  1. Halten Sie beim Neustart SHIFT gedrückt, um das GRUB-Menü aufzurufen

  2. Wählen Sie “Erweiterte Optionen für Ubuntu/Debian”

  3. Wählen Sie die Recovery-Mode-Option

  4. Wählen Sie “Root-Shell-Prompt öffnen”

  5. Hängen Sie das Dateisystem als beschreibbar ein:

    mount -o remount,rw /

  6. Berechtigungen reparieren:

    # Root-Eigentümerschaft wiederherstellen
chown -R root:root /usr
chmod -R 755 /usr

# Stellen Sie sicher, dass /usr/local für npm-Pakete Ihrem Benutzer gehört
chown -R YOUR_USERNAME:YOUR_USERNAME /usr/local

# Setzen Sie das setuid-Bit für kritische Binärdateien
chmod u+s /usr/bin/sudo
chmod 4755 /usr/bin/sudo
chmod u+s /usr/bin/su
chmod u+s /usr/bin/passwd
chmod u+s /usr/bin/newgrp
chmod u+s /usr/bin/gpasswd
chmod u+s /usr/bin/chsh
chmod u+s /usr/bin/chfn

# Sudo-Konfiguration reparieren
chown root:root /usr/libexec/sudo/sudoers.so
chmod 4755 /usr/libexec/sudo/sudoers.so
chown root:root /etc/sudo.conf
chmod 644 /etc/sudo.conf

  7. Betroffene Pakete neu installieren (optional, aber empfohlen):

    # Liste installierter Pakete speichern
dpkg --get-selections > /tmp/installed_packages.txt

# Diese neu installieren
awk '{print $1}' /tmp/installed_packages.txt | xargs -r apt-get install --reinstall -y

  8. Neustart:

    reboot
Alternative Live-USB-Wiederherstellungsmethode:

Wenn der Recovery-Modus nicht funktioniert, können Sie einen Live-USB verwenden:

  1. Booten Sie von einem Live-USB (Ubuntu, Debian oder eine andere Linux-Distribution)

  2. Finden Sie Ihre Systempartition:

    lsblk

  3. Hängen Sie Ihre Systempartition ein:

    sudo mount /dev/sdXY /mnt  # ersetzen Sie sdXY durch Ihre tatsächliche Systempartition

  4. Wenn Sie eine separate Boot-Partition haben, hängen Sie diese auch ein:

    sudo mount /dev/sdXZ /mnt/boot  # falls erforderlich

  5. Chroot in Ihr System:

    # Für Ubuntu/Debian:
sudo chroot /mnt

# Für Arch-basierte Systeme:
sudo arch-chroot /mnt

  6. Folgen Sie den Schritten 6-8 der Ubuntu/Debian-Wiederherstellungsmethode oben

Nach der Wiederherstellung Ihres Systems folgen Sie der empfohlenen Lösung oben, um ein vom Benutzer beschreibbares npm-Präfix einzurichten.

​
Auto-Updater-Probleme

Wenn Claude Code sich nicht automatisch aktualisieren kann, liegt das möglicherweise an Berechtigungsproblemen mit Ihrem globalen npm-Präfix-Verzeichnis. Befolgen Sie die empfohlene Lösung oben, um dies zu beheben.

Wenn Sie stattdessen den Auto-Updater deaktivieren möchten, können Sie Folgendes verwenden:

claude config set -g autoUpdaterStatus disabled

​
Berechtigungen und Authentifizierung

​
Wiederholte Berechtigungsaufforderungen

Wenn Sie immer wieder dieselben Befehle genehmigen müssen, können Sie bestimmten Tools erlauben, ohne Genehmigung zu laufen:

# npm test ohne Genehmigung ausführen lassen
claude config add allowedTools "Bash(npm test)"

# npm test und alle seine Unterbefehle ohne Genehmigung ausführen lassen
claude config add allowedTools "Bash(npm test:*)"

​
Authentifizierungsprobleme

Bei Authentifizierungsproblemen:

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

Bei anhaltenden Problemen versuchen Sie:

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

Dies entfernt Ihre gespeicherten Authentifizierungsinformationen und erzwingt eine neue Anmeldung.

​
Leistung und Stabilität

​
Hohe CPU- oder Speicherauslastung

Claude Code ist für die meisten Entwicklungsumgebungen ausgelegt, kann aber bei der Verarbeitung großer Codebasen erhebliche Ressourcen verbrauchen. Bei Leistungsproblemen:

  1. Verwenden Sie regelmäßig /compact, 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 Ihren .gitignore und .claudeignore Dateien hinzuzufügen

​
Befehle hängen oder frieren ein

Wenn Claude Code nicht mehr reagiert:

  1. Drücken Sie Strg+C, um zu versuchen, den aktuellen Vorgang abzubrechen
  2. Bei fehlender Reaktion müssen Sie möglicherweise das Terminal schließen und neu starten
  3. Bei anhaltenden Problemen starten Sie Claude mit ausführlicher Protokollierung: claude --verbose

​
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 den Zustand Ihrer Claude Code-Installation zu überprüfen

Was this page helpful?

Claude Code TutorialsComputernutzung (Beta)