Zum Hauptinhalt springen

​
Installationsprobleme beheben

Wenn Sie das Terminal ganz vermeiden möchten, können Sie mit der Claude Code Desktop-App Claude Code über eine grafische Benutzeroberfläche installieren und verwenden. Laden Sie sie für macOS oder Windows herunter und beginnen Sie zu programmieren, ohne eine Befehlszeilenkonfiguration durchzuführen.
Finden Sie die Fehlermeldung oder das Symptom, das Sie sehen:
Was Sie sehenLösung
command not found: claude oder 'claude' is not recognizedBeheben Sie Ihren PATH
syntax error near unexpected token '<'Installationsskript gibt HTML zurück
curl: (56) Failure writing output to destinationLaden Sie das Skript zuerst herunter, führen Sie es dann aus
Killed während der Installation unter LinuxFügen Sie Swap-Speicher für Server mit wenig Speicher hinzu
TLS connect error oder SSL/TLS secure channelAktualisieren Sie CA-Zertifikate
Failed to fetch version oder kann den Download-Server nicht erreichenÜberprüfen Sie Netzwerk- und Proxy-Einstellungen
irm is not recognized oder && is not validVerwenden Sie den richtigen Befehl für Ihre Shell
Claude Code on Windows requires git-bashInstallieren oder konfigurieren Sie Git Bash
Error loading shared libraryFalscher Binär-Variant für Ihr System
Illegal instruction unter LinuxArchitektur-Nichtübereinstimmung
dyld: cannot load oder Abort trap unter macOSBinär-Inkompatibilität
Invoke-Expression: Missing argument in parameter listInstallationsskript gibt HTML zurück
App unavailable in regionClaude Code ist in Ihrem Land nicht verfügbar. Siehe unterstützte Länder.
unable to get local issuer certificateKonfigurieren Sie Unternehmens-CA-Zertifikate
OAuth error oder 403 ForbiddenBeheben Sie die Authentifizierung
Wenn Ihr Problem nicht aufgelistet ist, führen Sie diese Diagnoseschritte durch.

​
Installationsprobleme debuggen

​
Überprüfen Sie die Netzwerkverbindung

Das Installationsprogramm lädt von storage.googleapis.com herunter. Überprüfen Sie, ob Sie es erreichen können: 
curl -sI https://storage.googleapis.com
Wenn dies fehlschlägt, blockiert Ihr Netzwerk möglicherweise die Verbindung. Häufige Ursachen:
  • Unternehmens-Firewalls oder Proxys, die Google Cloud Storage blockieren
  • Regionale Netzwerkbeschränkungen: Versuchen Sie ein VPN oder ein alternatives Netzwerk
  • TLS/SSL-Probleme: Aktualisieren Sie die CA-Zertifikate Ihres Systems, oder überprüfen Sie, ob HTTPS_PROXY konfiguriert ist
Wenn Sie sich hinter einem Unternehmens-Proxy befinden, setzen Sie HTTPS_PROXY und HTTP_PROXY auf die Adresse Ihres Proxys, bevor Sie installieren. Fragen Sie Ihr IT-Team nach der Proxy-URL, wenn Sie diese nicht kennen, oder überprüfen Sie die Proxy-Einstellungen Ihres Browsers. Dieses Beispiel setzt beide Proxy-Variablen und führt dann das Installationsprogramm über Ihren Proxy aus: 
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

​
Überprüfen Sie Ihren PATH

Wenn die Installation erfolgreich war, aber Sie einen command not found- oder not recognized-Fehler erhalten, wenn Sie claude ausführen, befindet sich das Installationsverzeichnis nicht in Ihrem PATH. Ihre Shell sucht nach Programmen in Verzeichnissen, die in PATH aufgelistet sind, und das Installationsprogramm platziert claude unter ~/.local/bin/claude auf macOS/Linux oder %USERPROFILE%\.local\bin\claude.exe unter Windows. Überprüfen Sie, ob sich das Installationsverzeichnis in Ihrem PATH befindet, indem Sie Ihre PATH-Einträge auflisten und nach local/bin filtern: 
echo $PATH | tr ':' '\n' | grep local/bin
Wenn es keine Ausgabe gibt, fehlt das Verzeichnis. Fügen Sie es zu Ihrer Shell-Konfiguration hinzu:
# Zsh (macOS-Standard)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Bash (Linux-Standard)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Alternativ können Sie Ihr Terminal schließen und erneut öffnen.Überprüfen Sie, ob die Behebung funktioniert hat:
claude --version

​
Überprüfen Sie auf widersprüchliche Installationen

Mehrere Claude Code-Installationen können zu Versionskonflikten oder unerwartetem Verhalten führen. Überprüfen Sie, was installiert ist:
Listet alle claude-Binärdateien auf, die in Ihrem PATH gefunden werden:
which -a claude
Überprüfen Sie, ob die native Installer- und npm-Versionen vorhanden sind:
ls -la ~/.local/bin/claude

ls -la ~/.claude/local/

npm -g ls @anthropic-ai/claude-code 2>/dev/null
Wenn Sie mehrere Installationen finden, behalten Sie nur eine. Die native Installation unter ~/.local/bin/claude wird empfohlen. Entfernen Sie alle zusätzlichen Installationen: Deinstallieren Sie eine globale npm-Installation: 
npm uninstall -g @anthropic-ai/claude-code
Entfernen Sie eine Homebrew-Installation unter macOS: 
brew uninstall --cask claude-code

​
Überprüfen Sie Verzeichnisberechtigungen

Das Installationsprogramm benötigt Schreibzugriff auf ~/.local/bin/ und ~/.claude/. Wenn die Installation mit Berechtigungsfehlern fehlschlägt, überprüfen Sie, ob diese Verzeichnisse beschreibbar sind: 
test -w ~/.local/bin && echo "writable" || echo "not writable"
test -w ~/.claude && echo "writable" || echo "not writable"
Wenn eines der Verzeichnisse nicht beschreibbar ist, erstellen Sie das Installationsverzeichnis und setzen Sie Ihren Benutzer als Eigentümer: 
sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

​
Überprüfen Sie, ob die Binärdatei funktioniert

Wenn claude installiert ist, aber beim Start abstürzt oder hängt, führen Sie diese Überprüfungen durch, um die Ursache einzugrenzen. Bestätigen Sie, dass die Binärdatei vorhanden und ausführbar ist: 
ls -la $(which claude)
Überprüfen Sie unter Linux auf fehlende gemeinsame Bibliotheken. Wenn ldd fehlende Bibliotheken anzeigt, müssen Sie möglicherweise Systempakete installieren. Auf Alpine Linux und anderen musl-basierten Distributionen siehe Alpine Linux-Setup. 
ldd $(which claude) | grep "not found"
Führen Sie eine schnelle Integritätsprüfung durch, dass die Binärdatei ausgeführt werden kann: 
claude --version

​
Häufige Installationsprobleme

Dies sind die am häufigsten auftretenden Installationsprobleme und deren Lösungen.

​
Installationsskript gibt HTML statt eines Shell-Skripts zurück

Wenn Sie den Installationsbefehl ausführen, können Sie einen dieser Fehler sehen: 
bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'
In PowerShell erscheint das gleiche Problem als: 
Invoke-Expression: Missing argument in parameter list.
Dies bedeutet, dass die Installations-URL eine HTML-Seite statt des Installationsskripts zurückgegeben hat. Wenn die HTML-Seite „App unavailable in region” sagt, ist Claude Code in Ihrem Land nicht verfügbar. Siehe unterstützte Länder. Andernfalls kann dies aufgrund von Netzwerkproblemen, regionalen Routing-Problemen oder einer vorübergehenden Serviceunterbrechung geschehen. Lösungen:
  1. Verwenden Sie eine alternative Installationsmethode: Installieren Sie unter macOS oder Linux über Homebrew: 
    brew install --cask claude-code
    Installieren Sie unter Windows über WinGet: 
    winget install Anthropic.ClaudeCode
  2. Versuchen Sie es nach ein paar Minuten erneut: Das Problem ist oft vorübergehend. Warten Sie und versuchen Sie den ursprünglichen Befehl erneut.

​
command not found: claude nach der Installation

Die Installation ist abgeschlossen, aber claude funktioniert nicht. Die genaue Fehlermeldung variiert je nach Plattform:
PlattformFehlermeldung
macOSzsh: command not found: claude
Linuxbash: claude: command not found
Windows CMD'claude' is not recognized as an internal or external command
PowerShellclaude : The term 'claude' is not recognized as the name of a cmdlet
Dies bedeutet, dass sich das Installationsverzeichnis nicht im Suchpfad Ihrer Shell befindet. Siehe Überprüfen Sie Ihren PATH für die Behebung auf jeder Plattform.

​
curl: (56) Failure writing output to destination

Der Befehl curl ... | bash lädt das Skript herunter und übergibt es direkt an Bash zur Ausführung über eine Pipe (|). Dieser Fehler bedeutet, dass die Verbindung unterbrochen wurde, bevor das Skript vollständig heruntergeladen wurde. Häufige Ursachen sind Netzwerkunterbrechungen, das Blockieren des Downloads während der Übertragung oder Systemressourcenlimits. Lösungen:
  1. Überprüfen Sie die Netzwerkstabilität: Claude Code-Binärdateien werden auf Google Cloud Storage gehostet. Testen Sie, ob Sie es erreichen können: 
    curl -fsSL https://storage.googleapis.com -o /dev/null
    Wenn der Befehl stillschweigend abgeschlossen wird, ist Ihre Verbindung in Ordnung und das Problem ist wahrscheinlich vorübergehend. Versuchen Sie den Installationsbefehl erneut. Wenn Sie einen Fehler sehen, blockiert Ihr Netzwerk möglicherweise den Download.
  2. Versuchen Sie eine alternative Installationsmethode: Unter macOS oder Linux: 
    brew install --cask claude-code
    Unter Windows: 
    winget install Anthropic.ClaudeCode

​
TLS- oder SSL-Verbindungsfehler

Fehler wie curl: (35) TLS connect error, schannel: next InitializeSecurityContext failed, oder PowerShells Could not establish trust relationship for the SSL/TLS secure channel deuten auf TLS-Handshake-Fehler hin. Lösungen:
  1. Aktualisieren Sie Ihre System-CA-Zertifikate: Auf Ubuntu/Debian: 
    sudo apt-get update && sudo apt-get install ca-certificates
    Auf macOS über Homebrew: 
    brew install ca-certificates
  2. Aktivieren Sie unter Windows TLS 1.2 in PowerShell, bevor Sie das Installationsprogramm ausführen: 
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex
  3. Überprüfen Sie auf Proxy- oder Firewall-Interferenz: Unternehmens-Proxys, die TLS-Inspektion durchführen, können diese Fehler verursachen, einschließlich unable to get local issuer certificate. Setzen Sie NODE_EXTRA_CA_CERTS auf Ihr Unternehmens-CA-Zertifikat-Bundle: 
    export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
    Fragen Sie Ihr IT-Team nach der Zertifikatsdatei, wenn Sie diese nicht haben. Sie können auch auf einer direkten Verbindung versuchen, um zu bestätigen, dass der Proxy die Ursache ist.

​
Failed to fetch version from storage.googleapis.com

Das Installationsprogramm konnte den Download-Server nicht erreichen. Dies bedeutet normalerweise, dass storage.googleapis.com in Ihrem Netzwerk blockiert ist. Lösungen:
  1. Testen Sie die Konnektivität direkt: 
    curl -sI https://storage.googleapis.com
  2. Wenn Sie sich hinter einem Proxy befinden, setzen Sie HTTPS_PROXY, damit das Installationsprogramm es durchleiten kann. Siehe Proxy-Konfiguration für Details. 
    export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash
  3. Wenn Sie sich in einem eingeschränkten Netzwerk befinden, versuchen Sie ein anderes Netzwerk oder VPN, oder verwenden Sie eine alternative Installationsmethode: Unter macOS oder Linux: 
    brew install --cask claude-code
    Unter Windows: 
    winget install Anthropic.ClaudeCode

​
Windows: irm oder && nicht erkannt

Wenn Sie 'irm' is not recognized oder The token '&&' is not valid sehen, führen Sie den falschen Befehl für Ihre Shell aus.
  • irm nicht erkannt: Sie befinden sich in CMD, nicht in PowerShell. Sie haben zwei Optionen: Öffnen Sie PowerShell, indem Sie im Startmenü nach „PowerShell” suchen, und führen Sie dann den ursprünglichen Installationsbefehl aus: 
    irm https://claude.ai/install.ps1 | iex
    Oder bleiben Sie in CMD und verwenden Sie stattdessen das CMD-Installationsprogramm: 
    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  • && nicht gültig: Sie befinden sich in PowerShell, haben aber den CMD-Installationsbefehl ausgeführt. Verwenden Sie das PowerShell-Installationsprogramm: 
    irm https://claude.ai/install.ps1 | iex

​
Installation auf Linux-Servern mit wenig Speicher beendet

Wenn Sie während der Installation auf einem VPS oder einer Cloud-Instanz Killed sehen: 
Setting up Claude Code...
Installing Claude Code native build latest...
bash: line 142: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}
Der Linux OOM-Killer hat den Prozess beendet, da dem System der Speicher ausgegangen ist. Claude Code benötigt mindestens 4 GB verfügbaren RAM. Lösungen:
  1. Fügen Sie Swap-Speicher hinzu, wenn Ihr Server über begrenzte RAM verfügt. Swap verwendet Festplattenspeicher als Überlauf-Speicher, sodass die Installation auch bei wenig physischem RAM abgeschlossen werden kann. Erstellen Sie eine 2-GB-Swap-Datei und aktivieren Sie sie: 
    sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
    Versuchen Sie dann die Installation erneut: 
    curl -fsSL https://claude.ai/install.sh | bash
  2. Schließen Sie andere Prozesse, um Speicher vor der Installation freizugeben.
  3. Verwenden Sie eine größere Instanz, wenn möglich. Claude Code benötigt mindestens 4 GB RAM.

​
Installation hängt in Docker

Wenn Sie Claude Code in einem Docker-Container installieren, kann die Installation als Root in / zu Hängern führen. Lösungen:
  1. Setzen Sie ein Arbeitsverzeichnis, bevor Sie das Installationsprogramm ausführen. Wenn es von / aus ausgeführt wird, scannt das Installationsprogramm das gesamte Dateisystem, was zu übermäßiger Speichernutzung führt. Das Setzen von WORKDIR begrenzt den Scan auf ein kleines Verzeichnis: 
    WORKDIR /tmp
RUN curl -fsSL https://claude.ai/install.sh | bash
  2. Erhöhen Sie die Docker-Speicherlimits, wenn Sie Docker Desktop verwenden: 
    docker build --memory=4g .

​
Windows: Claude Desktop überschreibt claude CLI-Befehl

Wenn Sie eine ältere Version von Claude Desktop installiert haben, kann sie möglicherweise eine Claude.exe im WindowsApps-Verzeichnis registrieren, die PATH-Priorität über Claude Code CLI hat. Das Ausführen von claude öffnet die Desktop-App statt der CLI. Aktualisieren Sie Claude Desktop auf die neueste Version, um dieses Problem zu beheben.

​
Windows: „Claude Code on Windows requires git-bash”

Claude Code unter nativem Windows benötigt Git für Windows, das Git Bash enthält. Wenn Git nicht installiert ist, laden Sie es von git-scm.com/downloads/win herunter und installieren Sie es. Wählen Sie während der Einrichtung „Add to PATH” aus. Starten Sie Ihr Terminal nach der Installation neu. Wenn Git bereits installiert ist, aber Claude Code es immer noch nicht finden kann, setzen Sie den Pfad in Ihrer settings.json-Datei: 
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
Wenn Ihr Git an einem anderen Ort installiert ist, finden Sie den Pfad, indem Sie where.exe git in PowerShell ausführen, und verwenden Sie den bin\bash.exe-Pfad aus diesem Verzeichnis.

​
Linux: Falscher Binär-Variant installiert (musl/glibc-Nichtübereinstimmung)

Wenn Sie nach der Installation Fehler über fehlende gemeinsame Bibliotheken wie libstdc++.so.6 oder libgcc_s.so.1 sehen, hat das Installationsprogramm möglicherweise die falsche Binär-Variante für Ihr System heruntergeladen. 
Error loading shared library libstdc++.so.6: No such file or directory
Dies kann auf glibc-basierten Systemen geschehen, auf denen musl-Cross-Compilation-Pakete installiert sind, was das Installationsprogramm dazu veranlasst, das System fälschlicherweise als musl zu erkennen. Lösungen:
  1. Überprüfen Sie, welche libc Ihr System verwendet: 
    ldd /bin/ls | head -1
    Wenn es linux-vdso.so oder Verweise auf /lib/x86_64-linux-gnu/ anzeigt, befinden Sie sich auf glibc. Wenn es musl anzeigt, befinden Sie sich auf musl.
  2. Wenn Sie sich auf glibc befinden, aber die musl-Binärdatei erhalten haben, entfernen Sie die Installation und installieren Sie erneut. Sie können die richtige Binärdatei auch manuell aus dem GCS-Bucket unter https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/{VERSION}/manifest.json herunterladen. Erstellen Sie ein GitHub-Problem mit der Ausgabe von ldd /bin/ls und ls /lib/libc.musl*.
  3. Wenn Sie sich tatsächlich auf musl befinden (Alpine Linux), installieren Sie die erforderlichen Pakete: 
    apk add libgcc libstdc++ ripgrep

​
Illegal instruction unter Linux

Wenn das Installationsprogramm Illegal instruction statt der OOM-Nachricht Killed ausgibt, stimmt die heruntergeladene Binärdatei nicht mit Ihrer CPU-Architektur überein. Dies geschieht häufig auf ARM-Servern, die eine x86-Binärdatei erhalten, oder auf älteren CPUs, denen erforderliche Befehlssätze fehlen. 
bash: line 142: 2238232 Illegal instruction    "$binary_path" install ${TARGET:+"$TARGET"}
Lösungen:
  1. Überprüfen Sie Ihre Architektur: 
    uname -m
    x86_64 bedeutet 64-Bit Intel/AMD, aarch64 bedeutet ARM64. Wenn die Binärdatei nicht übereinstimmt, erstellen Sie ein GitHub-Problem mit der Ausgabe.
  2. Versuchen Sie eine alternative Installationsmethode, während das Architektur-Problem gelöst wird: 
    brew install --cask claude-code

​
dyld: cannot load unter macOS

Wenn Sie während der Installation dyld: cannot load oder Abort trap: 6 sehen, ist die Binärdatei mit Ihrer macOS-Version oder Hardware nicht kompatibel. 
dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
Abort trap: 6
Lösungen:
  1. Überprüfen Sie Ihre macOS-Version: Claude Code benötigt macOS 13.0 oder später. Öffnen Sie das Apple-Menü und wählen Sie „About This Mac”, um Ihre Version zu überprüfen.
  2. Aktualisieren Sie macOS, wenn Sie eine ältere Version verwenden. Die Binärdatei verwendet Load-Befehle, die ältere macOS-Versionen nicht unterstützen.
  3. Versuchen Sie Homebrew als alternative Installationsmethode: 
    brew install --cask claude-code

​
Windows-Installationsprobleme: Fehler in WSL

Sie können die folgenden Probleme in WSL antreffen: 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. nvm-Versionskonflikte: Wenn Sie nvm sowohl in WSL als auch in Windows installiert haben, können Sie Versionskonflikte erleben, wenn Sie Node-Versionen in WSL wechseln. Dies geschieht, weil WSL den Windows-PATH standardmäßig 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, beheben Sie Ihren Linux-PATH, um sicherzustellen, dass die Linux-Node/npm-Versionen 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: Passen Sie die PATH-Reihenfolge an Wenn nvm ordnungsgemäß geladen ist, aber Windows-Pfade immer noch Vorrang haben, können Sie Ihre Linux-Pfade explizit in Ihrer Shell-Konfiguration dem PATH voranstellen: 
export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"
Vermeiden Sie das Deaktivieren des Windows-PATH-Imports über appendWindowsPath = false, da dies die Möglichkeit bricht, Windows-Ausführbare aus WSL aufzurufen. Vermeiden Sie auch das Deinstallieren von Node.js von Windows, wenn Sie es für Windows-Entwicklung verwenden.

​
WSL2-Sandbox-Setup

Sandboxing wird auf WSL2 unterstützt, erfordert aber die Installation zusätzlicher Pakete. Wenn Sie einen Fehler wie „Sandbox requires socat and bubblewrap” sehen, wenn Sie /sandbox ausführen, installieren Sie die Abhängigkeiten: 
sudo apt-get install bubblewrap socat
WSL1 unterstützt Sandboxing nicht. Wenn Sie „Sandboxing requires WSL2” sehen, müssen Sie auf WSL2 aktualisieren oder Claude Code ohne Sandboxing ausführen.

​
Berechtigungsfehler während der Installation

Wenn das native Installationsprogramm mit Berechtigungsfehlern fehlschlägt, ist das Zielverzeichnis möglicherweise nicht beschreibbar. Siehe Überprüfen Sie Verzeichnisberechtigungen. Wenn Sie zuvor mit npm installiert haben und npm-spezifische Berechtigungsfehler erhalten, wechseln Sie zum nativen Installationsprogramm: 
curl -fsSL https://claude.ai/install.sh | bash

​
Berechtigungen und Authentifizierung

Diese Abschnitte behandeln Anmeldungsfehler, Token-Probleme und Verhalten bei Berechtigungsaufforderungen.

​
Wiederholte Berechtigungsaufforderungen

Wenn Sie sich wiederholt zum Genehmigen der gleichen Befehle aufgefordert finden, können Sie bestimmte Tools mit dem Befehl /permissions ohne Genehmigung ausführen lassen. 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 ab
Wenn der Browser während der Anmeldung nicht automatisch geöffnet wird, drücken Sie c, um die OAuth-URL in Ihre Zwischenablage zu kopieren, und fügen Sie sie dann manuell in Ihren Browser ein.

​
OAuth-Fehler: Ungültiger Code

Wenn Sie OAuth error: Invalid code. Please make sure the full code was copied sehen, ist der Anmeldecode abgelaufen oder wurde während des Kopierens gekürzt. Lösungen:
  • Drücken Sie die Eingabetaste, um die Anmeldung schnell nach dem Öffnen des Browsers zu wiederholen und abzuschließen
  • Geben Sie c ein, um die vollständige URL zu kopieren, wenn der Browser nicht automatisch geöffnet wird
  • Wenn Sie eine Remote-/SSH-Sitzung verwenden, kann der Browser auf dem falschen Computer geöffnet werden. Kopieren Sie die im Terminal angezeigte URL und öffnen Sie sie stattdessen in Ihrem lokalen Browser.

​
403 Forbidden nach der Anmeldung

Wenn Sie API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}} nach der Anmeldung sehen:
  • Claude Pro/Max-Benutzer: Überprüfen Sie, ob Ihr Abonnement unter claude.ai/settings aktiv ist
  • Console-Benutzer: Bestätigen Sie, dass Ihr Konto die Rolle „Claude Code” oder „Developer” hat, die von Ihrem Administrator zugewiesen wurde
  • Hinter einem Proxy: Unternehmens-Proxys können API-Anfragen beeinträchtigen. Siehe Netzwerkkonfiguration für Proxy-Setup.

​
OAuth-Anmeldung schlägt in WSL2 fehl

Browser-basierte Anmeldung in WSL2 kann fehlschlagen, wenn WSL Ihren Windows-Browser nicht öffnen kann. Setzen Sie die Umgebungsvariable BROWSER: 
export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude
Oder kopieren Sie die URL manuell: Wenn die Anmeldungsaufforderung angezeigt wird, drücken Sie c, um die OAuth-URL zu kopieren, und fügen Sie sie dann in Ihren Windows-Browser ein.

​
„Not logged in” oder Token abgelaufen

Wenn Claude Code Sie auffordert, sich nach einer Sitzung erneut anzumelden, ist Ihr OAuth-Token möglicherweise abgelaufen. Führen Sie /login aus, um sich erneut zu authentifizieren. Wenn dies häufig geschieht, überprüfen Sie, ob Ihre Systemuhr genau ist, da die Token-Validierung von korrekten Zeitstempeln abhängt.

​
Konfigurationsdateispeicherorte

Claude Code speichert die Konfiguration an mehreren Orten:
DateiZweck
~/.claude/settings.jsonBenutzereinstellungen (Berechtigungen, Hooks, Modellüberschreibungen)
.claude/settings.jsonProjekteinstellungen (in die Quellcodeverwaltung eingecheckt)
.claude/settings.local.jsonLokale Projekteinstellungen (nicht committed)
~/.claude.jsonGlobaler Status (Design, OAuth, MCP-Server)
.mcp.jsonProjekt-MCP-Server (in die Quellcodeverwaltung eingecheckt)
managed-mcp.jsonVerwaltete MCP-Server
Verwaltete EinstellungenVerwaltete Einstellungen (Server-verwaltet, MDM/OS-Richtlinien oder dateibasiert)
Unter Windows bezieht sich ~ auf Ihr Benutzer-Stammverzeichnis, z. B. C:\Users\YourName. 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, MCP-Serverkonfigurationen und Sitzungsverlauf.

​
Leistung und Stabilität

Diese Abschnitte behandeln Probleme im Zusammenhang mit Ressourcennutzung, Reaktionsfähigkeit und Suchverhalten.

​
Hohe CPU- oder Speichernutzung

Claude Code ist für die Zusammenarbeit mit den meisten Entwicklungsumgebungen konzipiert, kann aber bei der Verarbeitung großer Codebases 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 Strg+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 Skills 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.

​
Langsame oder unvollständige Suchergebnisse auf WSL

Leistungseinbußen beim Lesen von Festplatten beim Arbeiten über Dateisysteme auf WSL können zu weniger als erwarteten Übereinstimmungen führen, wenn Sie Claude Code auf WSL verwenden. Die Suche funktioniert immer noch, gibt aber weniger Ergebnisse zurück als auf einem nativen Dateisystem.
/doctor zeigt in diesem Fall die Suche als OK an.
Lösungen:
  1. Senden Sie spezifischere Suchen: Reduzieren Sie die Anzahl der durchsuchten Dateien, indem Sie Verzeichnisse oder Dateitypen angeben: „Search for JWT validation logic in the auth-service package” oder „Find use of md5 hash in JS files”.
  2. Verschieben Sie das Projekt auf das Linux-Dateisystem: Stellen Sie sicher, dass sich Ihr Projekt auf dem Linux-Dateisystem (/home/) statt auf dem 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 Dateisystem-Leistung zu erzielen.

​
IDE-Integrationsprobleme

Wenn Claude Code sich nicht mit Ihrer IDE verbindet oder sich in einem IDE-Terminal unerwartet verhält, versuchen Sie die folgenden Lösungen.

​
JetBrains IDE nicht erkannt auf WSL2

Wenn Sie Claude Code auf WSL2 mit JetBrains IDEs verwenden und Fehler „No available IDEs detected” erhalten, liegt dies wahrscheinlich an WSL2s Netzwerkkonfiguration oder 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 Windows Firewall (empfohlen)
  1. Finden Sie Ihre WSL2-IP-Adresse: 
    wsl hostname -I
# Example output: 172.21.123.45
  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 im JetBrains IDE-Leitfaden.

​
Melden Sie Windows IDE-Integrationsprobleme

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 IDE-Terminals

Wenn Sie Claude Code in JetBrains-Terminals verwenden und die Esc-Taste den Agenten nicht wie erwartet unterbricht, liegt dies wahrscheinlich an einem Tastenkombinations-Konflikt mit JetBrains’ Standardverknüpfungen. Um dieses Problem zu beheben:
  1. Gehen Sie zu Einstellungen → Tools → Terminal
  2. Entweder:
    • Deaktivieren Sie „Move focus to the editor with Escape”, oder
    • Klicken Sie auf „Configure terminal keybindings” und löschen Sie die Verknüpfung „Switch focus to Editor”
  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-Zäunen, 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";
}
```text
Statt ordnungsgemäß gekennzeichneter Blöcke wie: 
```javascript
function example() {
  return "hello";
}
```text
Lösungen:
  1. Bitten Sie Claude, Sprach-Tags hinzuzufügen: Fordern Sie „Add appropriate language tags to all code blocks in this markdown file” an.
  2. Verwenden Sie Post-Processing-Hooks: Richten Sie automatische Formatierungs-Hooks ein, um fehlende Sprach-Tags zu erkennen und hinzuzufügen. Siehe Auto-format code after edits für ein Beispiel eines PostToolUse-Formatierungs-Hooks.
  3. Manuelle Überprüfung: Überprüfen Sie nach der Generierung 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. Fordern Sie Formatierungskorrektionen an: Bitten Sie Claude, „Fix spacing and formatting issues in this markdown file” 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 Aufforderungen oder Projekt-Memory-Dateien ein.

​
Reduzieren Sie Markdown-Formatierungsprobleme

Um Formatierungsprobleme zu minimieren:
  • Seien Sie explizit in Anforderungen: Fordern Sie „properly formatted markdown with language-tagged code blocks” 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 Befehl /bug 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 Probleme zu diagnostizieren. Es überprüft:
    • Installationstyp, Version und Such-Funktionalität
    • Auto-Update-Status und verfügbare Versionen
    • Ungültige Einstellungsdateien (fehlerhaftes JSON, falsche Typen)
    • MCP-Serverkonfigurationsfehler
    • Tastenkombinations-Konfigurationsprobleme
    • Kontext-Nutzungswarnungen (große CLAUDE.md-Dateien, hohe MCP-Token-Nutzung, unerreichbare Berechtigungsregeln)
    • Plugin- und Agent-Ladefehler
  4. Fragen Sie Claude direkt nach seinen Fähigkeiten und Funktionen - Claude hat integrierten Zugriff auf seine Dokumentation