Claude Code Fehlerbehebung

Problem. Claude Code funktioniert nicht mehr und du weißt nicht warum. Die meisten Probleme kommen aus fünf Bereichen, und eine kurze Checkliste klärt das schnell. Geh die Liste der Reihe nach durch und du tippst in wenigen Minuten wieder Prompts.

Schnelle Diagnose-Checkliste:

# 1. Check your installation
claude --version
 
# 2. Test your internet connection
ping claude.ai
 
# 3. Verify your API key
echo $ANTHROPIC_API_KEY
 
# 4. Clear session state (inside Claude Code)
/clear
 
# 5. Restart with fresh config
claude config

Wenn einer dieser Befehle kracht, spring direkt zum passenden Abschnitt für die genaue Lösung.

Installationsprobleme

Fehler. command not found: claude

Das Binary ist nicht im PATH gelandet, oder die Installation ist komplett fehlgeschlagen. Der native Installer löst das selbst:

# Reinstall with native installer (recommended)
curl -fsSL https://claude.ai/install.sh | bash  # macOS/Linux
# Windows PowerShell: irm https://claude.ai/install.ps1 | iex
 
# Verify installation
which claude

Fehler. Node.js version not supported

Node 18 oder höher ist das Minimum. Check, was du hast:

# Check current version
node --version
 
# If below 18.0, install latest Node.js
# Visit nodejs.org and download the LTS version

Fehler. EACCES permission denied

Auf macOS und Linux ist falsche npm-Eigentümerschaft meistens der Übeltäter:

# Fix npm ownership
sudo chown -R $(whoami) ~/.npm
 
# Alternative: use a version manager like nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

Auf Windows öffne die Eingabeaufforderung als Administrator und führ den Installer nochmal aus.

Authentifizierungsprobleme

Fehler. Invalid API key

Entweder ist dein Key nicht gesetzt oder er ist falsch. Setz ihn sauber neu:

# Reconfigure Claude Code
claude config
 
# Or set environment variable
export ANTHROPIC_API_KEY="your-api-key-here"

Hol dir einen frischen Key bei console.anthropic.com. Pass auf, dass beim Einfügen keine Leerzeichen reinkommen.

Fehler. Subscription not recognized

Bei Max- und Pro-Authentifizierungsfehlern:

1. Meld dich im Browser vollständig bei Claude ab
2. Lösch Cookies und gecachte Daten
3. Öffne ein privates Fenster und meld dich neu an
4. Führ claude config nochmal aus, um den Handshake abzuschließen

Verbindungsprobleme

Fehler. 503 Service Unavailable

Das liegt an Anthropic, nicht an dir:

• Wart 2 bis 5 Minuten, die Server erholen sich meistens von selbst
• status.anthropic.com zeigt dir, ob gerade etwas ausgefallen ist
• Eine Neuinstallation hilft bei einem Serverproblem nicht

Claude Code startet, bleibt aber stumm

Wisch den Session-Status weg:

# Clear conversation history (run inside Claude Code)
/clear
 
# Or restart with fresh session
exit
claude

Immer noch nichts? Prüf deine Verbindung und versuch es nochmal.

Performance-Probleme

Langsame Antworten oder Hänger

Wähl ein schnelleres Modell und kürz den Kontext:

# Use Claude Sonnet 4 for speed
claude --model claude-sonnet-4-20250514
 
# Compress conversation history (run inside Claude Code)
/compact keep only function names and current errors

Fehler. Context window full

Der Thread ist zu groß geworden. Setz ihn zurück oder komprimiere ihn:

# Quick fix: start fresh (run inside Claude Code)
/clear
 
# Better fix: compress intelligently
/compact preserve main components and recent changes only

Dateiberechtigungsfehler

Fehler. Permission denied on file operations

Die Verzeichnis-Eigentümerschaft stimmt nicht. Fix es so:

# Check current permissions
ls -la
 
# Fix ownership of project directory
sudo chown -R $(whoami) .
 
# Verify Claude Code can access files
claude --add-dir $(pwd)

Einstellungs- und Konfigurationsprobleme

Einstellungen verhalten sich seltsam

In neun von zehn Fällen liegt es an der Scope-Priorität. Die Reihenfolge ist: Managed > Kommandozeile > Lokal > Projekt > Benutzer. Ein Key in .claude/settings.local.json schlägt also denselben Key in .claude/settings.json, und der schlägt wiederum ~/.claude/settings.json.

# Check which settings files exist
ls ~/.claude/settings.json
ls .claude/settings.json
ls .claude/settings.local.json

Managed-Einstellungen überschreiben deine Voreinstellungen

Wenn die IT eine managed-settings.json gepusht hat, steht sie ganz oben im Stack und lässt sich nicht überschreiben. Managed-Dateien liegen unter /Library/Application Support/ClaudeCode/ auf macOS, /etc/claude-code/ auf Linux und WSL, und C:\Program Files\ClaudeCode\ auf Windows. Wenn eine Einstellung immer wieder zurückspringt, frag deinen Admin, ob eine Policy das festnagelt.

Einstellungs-Autovervollständigung funktioniert nicht

Füg eine $schema-Zeile ganz oben in deine settings.json ein, damit der Editor validieren und vervollständigen kann:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json"
}

Sandbox- und Sicherheitsprobleme

Fehler. bubblewrap not installed (Linux/WSL2)

Linux-Sandboxing braucht die Pakete bubblewrap und socat. Installier beide und starte neu:

# Debian/Ubuntu
sudo apt install bubblewrap socat
 
# Fedora
sudo dnf install bubblewrap socat

Watchman kollidiert mit der Sandbox

Metas Watchman-Datei-Watcher kämpft mit der Claude Code-Sandbox. Schalte Watchman aus, oder halt es außerhalb der Sandbox-Grenze.

Docker-Befehle schlagen innerhalb der Sandbox fehl

Docker muss außerhalb der Sandbox laufen. Trag es in excludedCommands in der settings.json ein:

{
  "sandbox": {
    "enabled": true,
    "excludedCommands": ["docker", "docker-compose"]
  }
}

Debug-Umgebungsvariablen

Hängt du an einem hartnäckigen Bug? Diese Env-Variablen helfen dir, das Problem einzugrenzen:

# Run Claude Code with all non-essential traffic disabled
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 claude
 
# Or set just the auto-updater off
DISABLE_AUTOUPDATER=1 claude

Vermutest du ein Proxy- oder Netzwerkproblem? Leite den Traffic über HTTP_PROXY oder HTTPS_PROXY, und nutze NO_PROXY, um den Proxy für bestimmte Hosts zu umgehen.

Erweiterte Lösungen

Immer noch kaputt? Alles platt machen und neu starten:

# 1. Uninstall any existing installation
npm uninstall -g @anthropic-ai/claude-code  # if installed via npm
 
# 2. Remove config files
rm ~/.claude.json
rm -rf ~/.claude/
 
# 3. Fresh install with native installer (recommended)
curl -fsSL https://claude.ai/install.sh | bash  # macOS/Linux
# Windows PowerShell: irm https://claude.ai/install.ps1 | iex
 
# 4. Reconfigure
claude config

Der native Installer verdrahtet den PATH selbst und hält sich automatisch aktuell.

Erfolg prüfen

Sobald der Fix drin ist, mach einen kurzen Sanity-Check:

# Test basic functionality
claude "write hello world in Python"
 
# Test file operations
echo "# Test" > test.md
claude "read and improve test.md"
 
# Test help command (inside Claude Code)
/help

Claude Code sollte jetzt normal antworten. Wenn nicht, liegt das Problem wahrscheinlich auf der Service-Seite. Wart ein paar Minuten. Versuch es nochmal.