AI Development

Claude 3.5 Sonnet im Ruhestand: API-429-Fehler in Cursor diagnostizieren (2026)

Claude 3.5 Sonnet im Ruhestand: API-429-Fehler in Cursor diagnostizieren (2026)

Ein Claude 3.5 Sonnet API-429-Fehler lässt sich zuverlässig erst diagnostizieren, wenn klar ist, welche Schicht ihn zurückgibt: Cursor, Anthropic oder LiteLLM. Verwenden Sie die Antwort-Header und Protokolle als Belege, statt allein aus der Statusmeldung auf die Ursache zu schließen. Die Anthropic-API-Version von Claude Sonnet 3.5 wurde am 28.10.2025 außer Dienst gestellt; eine weiterhin konfigurierte alte Modellkennung ist daher zuerst zu prüfen (offizielle Modellübersicht).

Dieser Leitfaden richtet sich an Entwickler, die in Cursor einen 429 sehen, aber nicht wissen, ob der Aufruf direkt oder über einen integrierten Dienst läuft.
Auch für Teams mit LiteLLM ist er geeignet, wenn sie eine lokale Begrenzung von einer Antwort des Upstream-Anbieters trennen müssen.
Wer eine ältere Claude-3.5-Sonnet-Integration betreut, findet hier einen Weg, Modellkennung und Fehlerursache auseinanderzuhalten.

Erst den Aufrufpfad klären, dann den 429 einordnen

Ein HTTP-429-Status besagt für sich genommen nicht, wer die Anfrage begrenzt hat. Die Meldung kann von einem API-Anbieter oder von einer vorgelagerten Komponente stammen. In einer Kette aus Cursor, LiteLLM und einem Modellanbieter muss deshalb jede Antwortgrenze separat betrachtet werden. Anthropic erläutert die Bedeutung von API-Fehlerantworten und Ratenbegrenzungen in den Fehlerhinweisen und der Dokumentation zu API-Ratenbegrenzungen.

Aufrufpfad Was zuerst geprüft wird Was ein 429 zunächst aussagt Was er nicht belegt
Cursor mit eigenem API-Schlüssel Schlüsselpfad, Modellwahl, rohe Anbieterantwort Eine Begrenzung kann vom Anbieter oder einer vorgeschalteten Schicht kommen Dass Cursor selbst die Ursache ist
Cursor mit integriertem Dienst tatsächlich gewähltes Modell, angezeigte Meldung, Dienststatus Cursor zeigt eine fehlgeschlagene Anfrage an Konkrete Anbieterlimits, wenn Rohantwort und Header fehlen
Cursor über LiteLLM Proxy-Protokoll, Schlüssel- und Teamregeln, Upstream-Ergebnis Proxy oder Upstream kann den Fehler ausgelöst haben Dass jede Proxy-Antwort vom Modellanbieter stammt
Alte Modellkennung verwendete Modell-ID und Modellstatus Der Aufruf kann auf ein nicht mehr verfügbares Modell zielen Dass erneute Versuche das Modell wieder verfügbar machen

Die erste Entscheidung lautet daher nicht „Wie oft soll erneut versucht werden?“, sondern „Welche Komponente hat diese Antwort erzeugt?“. Cursor dokumentiert den Einsatz eigener API-Schlüssel in den Einstellungen für API-Schlüssel. Dieser Pfad ist von einem integrierten Cursor-Dienst zu unterscheiden: Bei eigenem Schlüssel ist die Zuordnung zur eigenen Anbieterintegration wichtig; bei einem integrierten Dienst liegen Abrechnung und Fehlerdetails nicht automatisch im selben Konto oder Protokoll.

Eigener API-Schlüssel in Cursor: Anbieterantwort statt Vermutung prüfen

Bei einer direkten Verbindung mit eigenem Schlüssel beginnt die Prüfung in Cursor. Vergewissern Sie sich, dass der eigene Schlüssel tatsächlich für den betroffenen Anbieter hinterlegt und der betreffende Modellpfad aktiv ist. Prüfen Sie auch, ob ein Proxy oder eine weitere Zwischenkomponente eingetragen ist. Eine sichtbare Meldung in der Oberfläche reicht nicht, um eine direkte Verbindung zu beweisen.

Kann die Anwendung die originale HTTP-Antwort bereitstellen, sichern Sie den Antworttext und die Antwort-Header. Bei Anthropic können die dokumentierten Ratenbegrenzungs-Header zusammen mit retry-after Hinweise darauf geben, ob eine Begrenzung vorliegt und wann ein neuer Versuch vorgesehen ist. Welche Informationen tatsächlich vorliegen, hängt von der empfangenen Antwort ab; fehlende Header sollten nicht aus einer verkürzten Cursor-Meldung ergänzt werden. Die Bedeutung der Felder ist in der Anthropic-Dokumentation zu Ratenbegrenzungen beschrieben.

Auch eine Kosten- oder Kontingentgrenze ist von einer zeitabhängigen Ratenbegrenzung zu unterscheiden. Eine Fehlermeldung kann auf ein Problem mit dem Konto oder der Anfrage hinweisen, ohne dass die Antwort-Header eine Ratenbegrenzung ausweisen. Lassen sich die Rohdaten nicht aus Cursor exportieren, bleiben die lokale Modell- und Schlüsselkonfiguration überprüfbar; die Anbieterursache muss dann anhand des API-Protokolls oder über den zuständigen Dienst geklärt werden.

Typischer Fall: Cursor zeigt einen 429, während der Entwickler mehrere API-Schlüssel verwaltet. Solange unklar ist, welcher Schlüssel für den fehlgeschlagenen Aufruf verwendet wurde, sagt die sichtbare Meldung nichts Belastbares über das betroffene Anbieter-Konto. Zuerst den aktiven Schlüsselpfad und das Modell belegen, dann die zugehörige Antwort untersuchen.

Integrierter Cursor-Dienst: sichtbare Meldung und Anbieterursache trennen

Bei einem integrierten Modellpfad kann der Entwickler nicht ohne Weiteres auf die rohe Upstream-Antwort zugreifen. In diesem Fall sind die Angaben in Cursor und der Status des verwendeten Dienstes die verfügbaren lokalen Belege. Sie zeigen jedoch nicht zwangsläufig, welche konkrete Anbieterbegrenzung ausgelöst wurde. Insbesondere lassen sich aus einer allgemeinen Fehlermeldung keine belastbaren RPM-, Token- oder Kontingentwerte ableiten.

Beobachtung Selbst überprüfbar Beim Dienstanbieter zu klären
Modellname in Cursor Ist das erwartete Modell ausgewählt? War das Modell zum Zeitpunkt des Aufrufs verfügbar?
Fehlermeldung Wortlaut, Zeitpunkt und betroffener Arbeitsablauf sichern Gibt es eine zugehörige Dienststörung oder Begrenzung?
API-Schlüsselpfad Ist ein eigener Schlüssel aktiv oder der integrierte Dienst ausgewählt? Welche Anbieterantwort lag dem integrierten Pfad zugrunde?
Wiederholtes Auftreten Tritt der Fehler bei demselben Modellpfad erneut auf? Betrifft die Störung Konto, Dienst oder Anbieter?

Das verhindert eine häufige Fehldiagnose: Ein Nutzer sieht „429“ und nimmt an, Cursor habe eine bestimmte Grenze überschritten. Ohne Originalantwort ist das nicht belegt. Halten Sie die Fehlermeldung und den gewählten Pfad fest und fragen Sie beim zuständigen Dienst nach der zugrunde liegenden Antwort. Ein eigener Schlüsselwechsel ist nur dann ein sinnvoller Test, wenn die Änderung tatsächlich den Aufrufpfad verändert und die Nutzungsbedingungen des jeweiligen Dienstes eingehalten werden.

Über LiteLLM: lokale Begrenzung und Upstream-Aufruf vergleichen

Bei LiteLLM gibt es mindestens zwei relevante Stellen: die Anfrage, die beim Proxy eingeht, und den Aufruf, den der Proxy an den Anbieter weiterleitet. Die Architekturbeschreibung des LiteLLM-Proxys erklärt den Ablauf zwischen eingehender Anfrage und weitergeleitetem Modellaufruf. Die Dokumentation zu Proxy-Nutzern und Ratenbegrenzungen beschreibt die Regeln, die auf Proxy-Seite für Nutzer oder Teams gelten können.

Vergleichen Sie für denselben Fehlerzeitpunkt die eingehende Anfrage mit dem zugehörigen Upstream-Eintrag. Prüfen Sie, welcher virtuelle Schlüssel verwendet wurde, ob Team- oder Bereitstellungsregeln greifen und welche Modellgruppe angesprochen wurde. Suchen Sie anschließend nach dem Ergebnis des Anbieteraufrufs. Gibt es keinen dazugehörigen Upstream-Aufruf, ist eine lokale Ablehnung wahrscheinlicher. Ist einer vorhanden, muss dessen Antwort untersucht werden. Diese Hinweise sind Indizien und sollten mit den konkreten Protokolleinträgen belegt werden.

Prüfen Sie zusätzlich, ob LiteLLM einen erneuten Versuch oder eine Weiterleitung ausgelöst hat. Der LiteLLM Router-Leitfaden beschreibt Routing- und Wiederholungsmechanismen; für die Fehlerdiagnose genügt hier der Blick auf die tatsächlich protokollierten Ereignisse. Eine konfigurierte Fallback-Regel beweist nicht, dass sie im konkreten Fall ausgeführt wurde. Entscheidend sind die protokollierte Modellgruppe und das Ergebnis der Weiterleitung.

Ein Proxy-429 ohne passenden Upstream-Eintrag ist kein Beleg für eine Anthropic-Begrenzung. Umgekehrt beweist ein protokollierter Upstream-Aufruf allein noch nicht, dass der Anbieter die Anfrage abgelehnt hat: Dafür muss dessen tatsächliches Ergebnis geprüft werden.

Alte Modellkennung: Außerdienststellung ist keine Ratenbegrenzung

Die alte Modellkennung kann an mehreren Stellen fortbestehen: in der Cursor-Auswahl, in einer Anwendungskonfiguration oder in einer Modellzuordnung des Gateways. Suchen Sie die tatsächlich verwendete Zeichenfolge in allen beteiligten Konfigurationen und vergleichen Sie sie mit Anthropics offizieller Übersicht zu außer Dienst gestellten Modellen. Die dort dokumentierte API-Version von Claude Sonnet 3.5 wurde am 28.10.2025 außer Dienst gestellt.

Ein Fehler, der auf ein nicht verfügbares oder unbekanntes Modell hindeutet, ist anders zu behandeln als eine dokumentierte Ratenbegrenzung. Ein zusätzlicher Versuch kann die Modellkennung nicht wieder gültig machen. Ändern Sie die Konfiguration erst, nachdem Sie festgestellt haben, welcher Modellname tatsächlich an den Anbieter gesendet wird. Danach sollte derselbe Aufruf erneut geprüft werden: Ändert sich der Fehler, sind die neue Modellkennung und die Antwort entscheidend, nicht die alte 429-Anzeige.

Typischer Fall: Eine Anwendung wurde ursprünglich mit einer älteren Modell-ID eingerichtet, während Cursor oder LiteLLM später eine andere Bezeichnung anzeigt. Der sichtbare Name muss nicht mit dem Namen übereinstimmen, der tatsächlich im Upstream-Aufruf landet. Deshalb gehört die Modellzuordnung in der Proxy-Konfiguration zur Prüfung und nicht nur die Auswahl in der Oberfläche.

FAQ: häufige Fragen zur Diagnose

Wie lässt sich feststellen, ob Anthropic den Cursor-Aufruf begrenzt?

Bei einem eigenen API-Schlüssel sind die rohe Anbieterantwort und ihre Header die aussagekräftigsten Belege. Prüfen Sie, ob die Antwort Informationen zu einer Ratenbegrenzung oder zu retry-after enthält. Eine verkürzte Cursor-Meldung reicht nicht aus, um den Anbieter als Ursache festzulegen. Wenn Cursor keine Rohantwort bereitstellt, lassen sich nur der gewählte Pfad und die sichtbare Meldung selbst prüfen; die genaue Anbieterursache muss beim zuständigen Dienst geklärt werden.

Was bedeuten retry-after und die Header zur Ratenbegrenzung?

Ein vorhandener retry-after-Header nennt den Zeitpunkt beziehungsweise die Wartezeit für einen erneuten Versuch gemäß der Antwort. Weitere von Anthropic dokumentierte Header können Informationen zu Begrenzung und verbleibendem Spielraum liefern. Maßgeblich ist, was in der Antwort tatsächlich enthalten ist. Fehlt ein Header, kann sein Wert nicht aus dem HTTP-Status oder aus einer Cursor-Anzeige abgeleitet werden. Prüfen Sie die Namen und ihre Bedeutung in der aktuellen API-Dokumentation.

Ist ein LiteLLM-429 lokal oder vom Modellanbieter?

Stellen Sie das Proxy-Eingangsprotokoll dem Upstream-Eintrag gegenüber. Eine Ablehnung ohne entsprechenden Anbieteraufruf spricht eher für eine lokale Proxy-Regel, etwa für einen virtuellen Schlüssel oder ein Team. Gibt es einen Upstream-Aufruf, prüfen Sie dessen Antwort und die nachfolgenden Router-Ereignisse. Erst dieser Vergleich zeigt, ob LiteLLM selbst abgelehnt oder lediglich eine Anbieterantwort weitergereicht hat. Der Statuscode allein identifiziert die verantwortliche Schicht nicht.

Wie prüfe ich eine alte Claude-3.5-Sonnet-Modell-ID?

Suchen Sie nach der Modell-ID in Cursor, im Anwendungscode und in LiteLLM-Zuordnungen. Vergleichen Sie die gefundene Kennung mit Anthropics offizieller Dokumentation zur Außerdienststellung. Da die API-Version von Claude Sonnet 3.5 am 28.10.2025 außer Dienst gestellt wurde, sollte eine weiterhin verwendete Kennung nicht als aktuell verfügbar vorausgesetzt werden. Nach der Umstellung auf ein unterstütztes Modell sind die neue Antwort und die zugehörigen Proxy-Protokolle erneut zu prüfen.

Belege auswerten: ein Entscheidungsweg statt blinder Wiederholungen

Die folgende Entscheidungsfolge ordnet den nächsten Schritt nach dem verfügbaren Nachweis. Sie ersetzt keine Rohprotokolle, verhindert aber, dass eine unbestätigte Vermutung sofort zu mehr Anfragen führt.

  • Wenn eine originale Anbieterantwort vorliegt und retry-after enthält, halten Sie sich an die dort angegebene Wartezeit. Prüfen Sie zusätzlich die Ratenbegrenzungs-Header und den aktuellen Status des verwendeten Modells.
  • Wenn Cursor einen 429 anzeigt, aber keine Upstream-Antwort zugänglich ist, klären Sie zuerst, ob ein eigener Schlüssel oder der integrierte Dienst verwendet wird. Leiten Sie aus der Oberfläche keine konkreten Anbieterlimits ab.
  • Wenn LiteLLM den Fehler protokolliert, aber kein passender Upstream-Aufruf existiert, prüfen Sie virtuelle Schlüssel, Teamregeln, Modellgruppe und Proxy-Einstellungen. Behandeln Sie den Fehler zunächst als lokal zu untersuchenden Proxy-Fall.
  • Wenn ein Upstream-Aufruf existiert, vergleichen Sie dessen Antwort mit dem Proxy-Ergebnis. Prüfen Sie außerdem, ob ein erneuter Versuch oder eine Weiterleitung tatsächlich protokolliert wurde.
  • Wenn die angefragte Modell-ID außer Dienst gestellt oder nicht gültig ist, korrigieren Sie zuerst die Modellzuordnung. Wiederholungen sind kein Ersatz für eine verfügbare Modellkennung.
  • Wenn kein eindeutiger Nachweis vorliegt, sichern Sie Zeitpunkt, Fehlermeldung, Aufrufpfad und verfügbare Protokolle. Klären Sie fehlende Anbieterinformationen mit dem zuständigen Dienst, statt die Anfragefrequenz auf Verdacht zu erhöhen.

Anthropic verwaltet API-Ratenbegrenzungen über Dimensionen wie RPM, ITPM und OTPM; konkrete Grenzen hängen vom jeweiligen Konto und der geltenden Konfiguration ab. Die offiziellen Hinweise zu Ratenbegrenzungen sind daher aussagekräftiger als ein übernommener Grenzwert aus einem fremden Beispiel. Ein aggressiverer Wiederholungsmechanismus kann zusätzliche Anfragen erzeugen, ohne eine ungültige Modell-ID oder eine lokale Proxy-Ablehnung zu beheben. Auch eine Weiterleitung auf ein anderes Modell garantiert nicht dasselbe Antwortverhalten.

Entwicklungsrechner und API-Gateway: getrennte Aufgaben, getrennte Fehler

Ein Mac dient als Entwicklungsrechner: Dort laufen Editor, Terminal, lokale Werkzeuge und gegebenenfalls der Zugriff auf einen Proxy. Ein API-Gateway nimmt Modellanfragen entgegen, prüft seine Regeln und leitet Anfragen an einen Anbieter weiter. Ein Mac stellt deshalb nicht automatisch eine zusätzliche Modell-API bereit und hebt keine Begrenzung des Anbieters auf. Für die Diagnose bleibt entscheidend, welcher Dienst die Antwort erzeugt hat.

Wer den Entwicklungsrechner unabhängig vom eigenen lokalen Gerät bereitstellen möchte, kann sich über einen Cloud-Mac als Entwicklungsumgebung informieren. Das ist eine Entscheidung über den Zugriff auf eine Mac-Umgebung, nicht über die Verfügbarkeit von Claude oder die Ratenbegrenzung einer API. Für Fragen zu Zugang und Nutzung stehen die ProxyMac-Hilfeinformationen bereit. Bei der Übertragung von Quellcode und Protokollen sollte außerdem geprüft werden, welche Daten den eigenen Rechner oder das Rechenzentrum verlassen; die Datenschutzhinweise beschreiben den Umgang mit personenbezogenen Daten im Dienstkontext.

Ein vorhandenes Gerät ist meist die einfachste Wahl, wenn es zuverlässig verfügbar ist und die Entwicklungsumgebung bereits eingerichtet wurde. Eine eigene Maschine bietet direkte Kontrolle über lokale Werkzeuge und Schnittstellen, verursacht aber Anschaffungs- und Wartungsaufwand. Eine Cloud-Umgebung kann für zeitlich begrenzte Entwicklungs- oder Testphasen passen, bringt jedoch Zugriffs- und Verbindungsabhängigkeiten mit sich. Keine dieser Optionen behebt für sich genommen einen 429 des Modellanbieters.

Wenn die Ursache tatsächlich im API-Konto, in der Modellkennung oder in einer LiteLLM-Regel liegt, sollte zuerst diese Schicht korrigiert werden. Liegt das Problem dagegen in einer nicht verfügbaren oder schlecht zugänglichen Entwicklungsumgebung, kann ein gemieteter Mac von ProxyMac die Arbeit an der lokalen Entwicklungsseite vereinfachen. Das ist eine sinnvolle Alternative zu einem sofortigen Gerätekauf für befristete Tests, aber kein Ersatz für die Prüfung von Anbieterantwort, Modellstatus und Gateway-Protokollen.

FAQ

Wie lässt sich feststellen, ob Cursor bei einem Claude-Aufruf von Anthropic begrenzt wird?+
Prüfen Sie zuerst, ob Cursor Ihren eigenen API-Schlüssel verwendet oder den integrierten Dienst. Bei einem eigenen Schlüssel sind die rohe Antwort und die Antwort-Header des Anbieters entscheidend. Ein 429 im Cursor-Fenster allein belegt keine Begrenzung durch Anthropic. Fehlen die ursprünglichen Header, sollte die Ursache beim Dienstanbieter erfragt werden, statt aus der Meldung ein konkretes Kontingent abzuleiten.
Was bedeuten retry-after und die Ratenbegrenzungs-Header in einer Claude-API-Antwort?+
Ein vorhandener retry-after-Header gibt an, wann ein erneuter Versuch laut Antwort erfolgen soll. Die dokumentierten Begrenzungs-Header können zusätzliche Auskunft über das Limit, die verbleibende Kapazität oder eine Rücksetzung geben. Maßgeblich ist die tatsächlich empfangene Antwort: Fehlt ein Header, lässt sich sein Wert nicht aus der Cursor-Anzeige rekonstruieren. Vergleichen Sie die Header mit der aktuellen Anthropic-Dokumentation.
Ist ein 429 von LiteLLM eine lokale Begrenzung oder eine Antwort des Modellanbieters?+
Vergleichen Sie das eingehende Proxy-Protokoll mit dem zugehörigen Upstream-Aufruf. Gibt es keinen entsprechenden Anbieteraufruf, sprechen die Hinweise eher für eine lokale Begrenzung, etwa durch Schlüssel-, Team- oder Parallelitätsregeln. Ist ein Upstream-Aufruf protokolliert, prüfen Sie dessen Ergebnis und ob LiteLLM einen erneuten Versuch oder eine Weiterleitung ausgelöst hat. Der Statuscode allein trennt diese Fälle nicht.
Wie prüfe ich eine alte Claude-3.5-Sonnet-Modellkennung nach der Außerdienststellung?+
Suchen Sie die Modellkennung in Cursor, in Anwendungseinstellungen und in LiteLLM-Modellzuordnungen. Vergleichen Sie sie mit Anthropic. Die Claude-Sonnet-3.5-API-Version wurde am 28.10.2025 außer Dienst gestellt. Ein Fehler wegen einer nicht verfügbaren Modellkennung ist daher nicht automatisch eine Ratenbegrenzung. Nach der Umstellung auf ein aktuell unterstütztes Modell sollten Antwort und Protokolle erneut geprüft werden.

Richten Sie Ihre Diagnoseumgebung auf einem eigenen Cloud-Mac ein

Mit ProxyMac nutzen Sie einen dedizierten Mac mini M4 für reproduzierbare Tests und die Auswertung von Protokollen.
Greifen Sie per SSH oder VNC auf eine vollständige macOS-Umgebung zu und untersuchen Sie Ihre Entwicklungsabläufe aus der Ferne.