Häufige Claude Code-Fehler und Lösungen

Fehlermeldungsindex

Die folgenden Fehlermeldungen wurden mit Claude Code 2.1.299 getestet.

400

API Error: 400 {"error":"模型 xxx 不存在或未上线，请前往 https://aicodewith.com/zh/dashboard/pricing 查看可用模型列表 (request_id: …)"}

• •Modellname ist falsch geschrieben oder das Modell ist nicht verfügbar: Führe /model aus, um neu auszuwählen, oder prüfe die Modell-ID auf der Modellseite.
• •Kontext ist zu lang: Führe /compact aus, um die Unterhaltung zu komprimieren, oder /clear, um eine neue Sitzung zu starten.

401 Authentifizierung

Failed to authenticate. API Error: 401 {"error":"请在请求中提供有效的 API Key。"}

1. Kopiere den Schlüssel erneut aus dem Dashboard, prüfe auf führende/abschließende Leerzeichen und Zeilenumbrüche und stelle sicher, dass der Schlüssel nicht gelöscht wurde.
2. Lege den Schlüssel in ANTHROPIC_AUTH_TOKEN ab und lasse ANTHROPIC_API_KEY leer.
3. Führe in einem neuen Terminal echo $ANTHROPIC_API_KEY aus und entferne alte Werte in ~/.zshrc oder ~/.bashrc.
4. Schließe alle Claude Code-Sitzungen und öffne sie neu, dann führe /status aus.

403 Schlüssel deaktiviert

Failed to authenticate. API Error: 403 此 API Key 已被停用，如有疑问请联系我们 https://aicodewith.com/zh/contact

Nachdem der Schlüssel deaktiviert oder gelöscht wurde, erscheint dieser Fehler innerhalb von Sekunden. Prüfe den Schlüsselstatus im Dashboard, erstelle einen neuen Schlüssel und aktualisiere deine Konfiguration; kontaktiere uns bei Fragen.

Not logged in

Not logged in · Please run /login

Das bedeutet, dass der Schlüssel leer oder nicht konfiguriert ist; es bedeutet nicht, dass du dich bei einem Claude-Konto anmelden musst. Trage den Schlüssel in ANTHROPIC_AUTH_TOKEN in ~/.claude/settings.json ein und starte Claude Code neu.

429 Ratenlimit

{"error":"当前并发请求过多，请稍后重试 (request_id: …)"}

(Dieser Fehler wurde mit gleichzeitigen curl-Anfragen reproduziert; die Anzeige in Claude Code kann abweichen.)

Pay-as-you-go hat kein 5-Stunden- oder Wochenkontingent, aber Raten- und Parallelitätslimits gelten weiterhin. Wenn zu viele Anfragen gleichzeitig gesendet werden, geben die überzähligen Anfragen 429 zurück; warte kurz und versuche es erneut.

• •Schließe zusätzliche Claude Code-Sitzungen und reduziere parallele Subagents; Skripte und CI-Jobs, die denselben Schlüssel verwenden, zählen ebenfalls.
• •Erstelle einen separaten Schlüssel für jede Person oder Pipeline, damit sich die Quelle leichter identifizieren lässt.

overloaded

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}

Die Anfrage und der Schlüssel sind in Ordnung; das Modell ist in diesem Moment einfach ausgelastet. Die Spitze ist meist kurz und betrifft nur ein bestimmtes Modell.

• •Warte kurz und sende erneut; die Unterhaltung geht nicht verloren.
• •Führe /model aus, um zu einem anderen Modell zu wechseln (zum Beispiel von Opus zu Sonnet), damit du die Arbeit zuerst erledigen kannst.
• •Prüfe den Kanalstatus auf der Modellseite und wechsle den Schlüssel bei Bedarf zu einem anderen Kanal.

Timeout / Verbindung unterbrochen (ECONNRESET)

API Error: Connection dropped (ECONNRESET)

Dieser Fehler erscheint, wenn der API-Endpunkt nicht erreichbar oder die Domain falsch ist.

• •Führe /status aus, um zu bestätigen, dass der API-Endpunkt api.aicodewith.ai ist und nicht die Standardadresse von Anthropic.
• •Deaktiviere vorübergehend deinen lokalen Proxy oder VPN und versuche es erneut; Verbindungen aus China können direkt funktionieren.

Wenn der Schlüssel falsch oder das Netzwerk nicht erreichbar ist, versucht Claude Code etwa 3–4 Minuten lang automatisch erneut, währenddessen bleibt die Oberfläche ohne Meldung leer. Wenn es lange hängt, prüfe zuerst den Schlüssel und den Endpunkt.

Probleme mit Drittanbieter-APIs (Base URL, Konfiguration nicht übernommen)

There's an issue with the selected model (...). It may not exist or you may not have access to it. Run --model to pick a different model.

Wenn ANTHROPIC_BASE_URL auf https://aicodewith.ai gesetzt ist oder einen falschen Pfad (wie /foo) enthält, erhältst du diesen Fehler. Er sieht wie ein Modellproblem aus, aber tatsächlich ist der Endpunkt falsch; verwende stattdessen https://api.aicodewith.ai.

Umgebungsvariablen haben Vorrang vor ~/.claude/settings.json: Alte Werte, die in deinem Terminal exportiert wurden, überschreiben die Konfigurationsdatei. Nach jeder Konfigurationsänderung schließt du alle Claude Code-Sitzungen (einschließlich VS Code- und JetBrains-Plugins) und öffnest sie neu. Die Standardkonfiguration ist:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的_API_KEY",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
  }
}

• •ANTHROPIC_BASE_URL sollte kein /v1 und keinen abschließenden Schrägstrich enthalten.
• •Wenn der erste Start auf der Anmeldeseite hängen bleibt, füge "hasCompletedOnboarding": true in ~/.claude.json hinzu.

Claude Code-IntegrationsleitfadenClaude Code Relay einrichtenClaude Haiku API-Fehlerbehebung

FAQ