Claude Code Fehlerbehebung
Der Schwerpunkt bei der Fehlerbehebung von Claude Code liegt darin, sicherzustellen, dass die Claude- / Anthropic-Konfiguration korrekt übernommen wurde. Mischen Sie keine OpenAI-kompatiblen Adressen, Codex-Modellnamen oder Gemini-Keys in Claude Code.
Was sollte zuerst überprüft werden?
| Prüfpunkt | Vorgehensweise | Grund |
|---|---|---|
| Ziel-Tool | Stellen Sie sicher, dass Sie Fehler in Claude Code beheben, nicht in Codex oder Gemini CLI | Die Konfigurationsdateien, Protokolle und Modellnamen der verschiedenen Tools unterscheiden sich. |
| Provider-Protokoll | Claude, Anthropic und Claude Code werden im Backend oder Tutorial ausdrücklich erwähnt | Provider, die nur OpenAI-kompatible Schnittstellen anbieten, unterstützen Claude Code möglicherweise nicht |
| Key-Typ | Verwenden Sie den entsprechenden Key für Claude / Anthropic | Ein falscher Key-Typ führt direkt zu einem 401-Fehler oder Authentifizierungsfehler |
| Terminal-Status | Öffnen Sie das Terminal nach dem Wechseln der Konfiguration erneut und testen Sie noch einmal | Das alte Terminal verwendet möglicherweise noch Umgebungsvariablen oder Konfigurationen von vor dem Wechsel |
Häufige Fehler
| Symptom | Prioritäre Prüfung | Lösungen |
|---|---|---|
| Der Befehl lässt sich ausführen, aber die Anfrage schlägt fehl | Ob Claude Code die neue Konfiguration übernommen hat | Schließen Sie das aktuelle Terminalfenster, öffnen Sie es erneut und senden Sie eine minimale Testfrage. Wenn Sie über CC-Switch gewechselt haben, bearbeiten Sie dieselbe Konfiguration nicht gleichzeitig manuell. |
| 401 / Unauthorized | Key-Typ und Vollständigkeit | Vergewissern Sie sich, dass Sie den entsprechenden Key für Claude / Anthropic verwenden; tragen Sie keinen OpenAI-kompatiblen Key in Claude Code ein. Achten Sie beim erneuten Kopieren auf führende oder nachgestellte Leerzeichen. |
| 404 / model not found | Claude-Modellname | Tragen Sie den Namen exakt so ein, wie er im Backend des Providers für Claude-Modelle angegeben ist; ändern Sie weder Groß-/Kleinschreibung noch Bindestriche oder Versionsnummern. |
| Verbindungszeitüberschreitung oder keine Antwort | Claude Base-URL | Überprüfen Sie die Claude- / Anthropic-API-Adresse im Backend; Provider, die nur OpenAI-kompatible Adressen bereitstellen, unterstützen Claude Code möglicherweise nicht. |
| Nach dem Wechsel wird immer noch der alte Provider verwendet | Terminal-Sitzung und Konfigurationsquelle | Öffnen Sie das Terminal erneut und testen Sie noch einmal. Falls es immer noch nicht greift, vergewissern Sie sich, dass der aktuelle Provider in CC-Switch auf Claude Code angewendet wurde. |
Minimaler Test
Senden Sie beim Testen zuerst eine feste kurze Frage und prüfen Sie, ob eine Antwort erfolgt, bevor Sie mit dem eigentlichen Projekt fortfahren.
Claude Code minimaler Test
claude "Please reply only: Claude Code configuration test successful"Feedback-Vorlage
So verfassen Sie Feedback an den Provider
Tool: Claude Code System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened