Anmerkung des Autors: Dieser Artikel basiert auf der offiziellen Anthropic-Dokumentation vom 2026-11-08 (UTC+8) sowie auf dem am 2026-11-09 um 10:40 Uhr aktualisierten Claude-Thinking-Parameter-Leitfaden von APIYI. Die Prüfung der Formulierungen erfolgte am 2026-11-13. Der Beitrag hilft dir, die 400-Fehler bei den thinking-Parametern von claude-opus-5-5 und claude-sonnet-5-5 zu vermeiden.
Wenn du bei claude-opus-5-5 für thinking den type auf disabled setzt, gibt die Schnittstelle direkt einen 400-Fehler zurück – das ist die offizielle Vorgabe, die in der Anthropic-Dokumentation vom 2026-11-08 (UTC+8) festgehalten ist. APIYI (apiyi.com) hat am 2026-11-09 um 10:40 Uhr den Claude-Thinking-Parameter-Leitfaden neu veröffentlicht und dabei die korrekte Schreibweise für beide Modell-IDs klar herausgearbeitet. Dieser Artikel fasst kurz zusammen, was diese Änderung für alle bedeutet, die die Claude API aufrufen.
Das sind keine Gerüchte: Beide Kernaussagen stützen sich auf die Dokumentation – bei claude-opus-5-5 lässt sich das Denken nicht abschalten, es lässt sich nur der effort reduzieren; bei claude-sonnet-5-5 muss man, um das vorgeschaltete Denken abzuschalten, auf between_tools umstellen.
Der Kernnutzen: In 3 Minuten die korrekte Schreibweise beider Modell-IDs verstehen, die Parameter-Grenzen von between_tools kennenlernen und einen Ansatz zur Fehlersuche bei 400-Fehlern bekommen.
Kerninformationen auf einen Blick: die thinking-Regeln von claude-opus-5-5 und claude-sonnet-5-5
Erst die Übersichtstabelle, dann die Details:
| Informationspunkt | Details |
|---|---|
| Offizielle Quelle | Anthropic-Dokumentation, Stand 08.11.2026 (UTC+8) |
| APIYI-Guide aktualisiert | 09.11.2026, 10:40 – docs.apiyi.com ist bereits synchronisiert |
| claude-opus-5-5 | Ohne thinking → adaptives Denken; mit disabled → 400 |
| claude-sonnet-5-5 | Ohne thinking ebenfalls adaptives Denken; Vorab-Denken abschalten mit between_tools |
Standardwert von effort |
medium bei Opus 5.5, high bei Sonnet 5.5 |
| Maximale Ausgabe | bei beiden Modell-IDs 128000, Denk-Tokens zählen mit hinein |
Bei claude-opus-5-5 ist die Regel ziemlich eindeutig. Wird das Feld thinking im Request weggelassen, geht das Modell in adaptives Denken über und entscheidet selbst, ob und wie tief es diesmal nachdenkt. Setzt man dagegen type in thinking auf disabled, wird das nicht stillschweigend ignoriert, sondern die API antwortet direkt mit 400. Anders gesagt: Für diese Modell-ID gibt es keinen Schalter zum Abschalten des Denkens. Das einzige Mittel, das die Dokumentation nennt, ist ein niedrigeres effort – die Standardstufe ist medium.
claude-sonnet-5-5 ist etwas anders gelagert. Auch hier gibt es das adaptive Denken, wenn thinking fehlt, aber zusätzlich einen offiziell anerkannten Weg zum Abschalten: Setzt man type auf between_tools, wird das Vorab-Denken deaktiviert und nur die Fortschrittsmeldungen zwischen Tool-Aufrufen bleiben erhalten. Auch die Grenzen dieses Wegs sind klar dokumentiert – am besten direkt in der folgenden Tabelle nachschauen:
| Einschränkung | Vorgabe der Dokumentation |
|---|---|
Werte für effort |
nur low, medium, high |
| Obergrenze der Stufe | darf nicht über high liegen |
| Kombinationsregel | nicht gleichzeitig mit display oder budget_tokens |
| Tatsächliche Wirkung | Vorab-Denken aus, nur Fortschrittsmeldungen zwischen Tool-Aufrufen bleiben |
Es gibt noch ein Detail, das leicht übersehen wird: Denk-Tokens zählen in max_tokens mit hinein. Die maximale Ausgabe beträgt bei beiden Modell-IDs 128000. Setzt man max_tokens im Request zu niedrig an, kann das Denken einen großen Teil des Budgets verbrauchen und der eigentliche Text wird abgeschnitten. Wenn man also dem Problem „Antworten werden plötzlich kürzer“ nachgeht, lohnt es sich, zuerst zu prüfen, wie viel das Denken belegt.
Bildhinweis: Die Aufrufkette im Diagramm verwendet beispielhaft das Gateway von APIYI (apiyi.com) im nativen Anthropic-Format. Im Anthropic-Format lautet die Basisadresse https://api.apiyi.com – bitte nicht in der Form mit angehängtem /v1 schreiben.
Auswirkungsanalyse: Welche Aufrufer ein 400-Fehler bei disabled trifft
Die Auswirkungen dieser geänderten Regelung auf die Aufrufer konzentrieren sich auf drei Bereiche: Fehlerbehandlung, Parameterkombinationen und Budgetplanung. Betrachtet man sie einzeln, wird das Ganze anschaulicher.
Auswirkungen auf bestehenden Code: Migration der disabled-Schreibweise
| Szenario | Alte Schreibweise | Aktuelles Ergebnis | Richtige Vorgehensweise |
|---|---|---|---|
| claude-opus-5-5: Denken abschalten | type auf disabled setzen |
Gibt 400 zurück | Lässt sich nicht abschalten, nur effort reduzieren |
| claude-sonnet-5-5: vorgelagertes Denken abschalten | type auf disabled setzen |
Gibt 400 zurück | Stattdessen between_tools verwenden |
| Denk-Budget fein steuern | between_tools zusammen mit budget_tokens |
Kombination wird nicht akzeptiert | Beides kann nicht gemeinsam übergeben werden, stattdessen die drei effort-Stufen verwenden |
| Sorge, dass Denken die Ausgabe verdrängt | max_tokens sehr klein setzen |
Der Textkörper wird abgeschnitten | Denk-Token zählen zu max_tokens, Puffer einplanen |
Die erste Auswirkung sind die zusätzlichen Einschränkungen bei Parameterkombinationen. between_tools darf nicht gleichzeitig mit budget_tokens oder display auftreten. Das bedeutet, dass sich das Denk-Budget auf diesem Weg nicht mehr fein steuern lässt und nur noch indirekt über die drei Stufen low, medium und high reguliert werden kann. Zusammen mit der Regel „Denk-Token zählen zu max_tokens“ müssen Aufrufer ein neues Gleichgewicht zwischen effort und max_tokens finden.
Die zweite Auswirkung betrifft die Verzweigungslogik, die aktualisiert werden muss. Wenn ein Skript anhand der Modell-ID entscheidet, ob disabled übergeben wird, sind für diese beiden IDs getrennte Zweige nötig: Beim ersteren muss man die Tatsache akzeptieren, dass es sich nicht abschalten lässt, und effort herunterstufen; beim letzteren wechselt man auf between_tools. Wer solche Verzweigungen zentral an einer Stelle in der Konfiguration pflegt, hat bei künftigen Regeländerungen den geringsten Anpassungsaufwand.
Am Rande sei erwähnt: Auf derselben Seite steht auch, dass Fable 5.1 und Fable 5 bei disabled ebenfalls einen 400-Fehler zurückgeben und sich ebenso wenig abschalten lassen; bei Haiku 5.5 und Opus 5 lässt sich disabled dagegen weiterhin verwenden, solange effort nicht über high liegt. Wenn der Code mehrere Modell-IDs gleichzeitig bedient, empfiehlt es sich, eine Schalter-Matrix pro Modell zu pflegen, statt global dieselbe Schreibweise zu verwenden.
Auswirkungen auf die Kostenstruktur: Thinking-Tokens und Verbrauch
claude-sonnet-5-5 wird in der Preisübersicht von APIYI (apiyi.com) mit $2 für Eingaben, $10 für Ausgaben und $0.1 für Cache-Lesevorgänge geführt. Da Thinking-Tokens auf max_tokens angerechnet werden, wirkt sich sowohl das Abschalten des vorgeschalteten Thinking als auch die gewählte effort-Stufe direkt auf den Token-Verbrauch aus. Bei hoher Aufrufrate fällt diese Differenz stärker ins Gewicht – beim Ändern von Code lohnt sich eine kurze Überschlagsrechnung.
Erläuterung zur Grafik: Die Angaben wurden aus der offiziellen Dokumentation vom 2026-11-08 zusammengestellt und können im Dokumentationszentrum von APIYI apiyi.com anhand des Originaltexts überprüft werden.
| Modell-ID | Verfügbarkeit von disabled |
Aussage der Dokumentation |
|---|---|---|
| claude-opus-5-5 | Nicht verfügbar, liefert 400 | Thinking lässt sich nicht abschalten, nur effort reduzieren (Standard: medium) |
| claude-sonnet-5-5 | Nicht verfügbar, liefert 400 | Stattdessen between_tools verwenden (Standard: high) |
| Fable 5.1 / Fable 5 | Nicht verfügbar, liefert 400 | Lässt sich ebenfalls nicht abschalten |
| Haiku 5.5 / Opus 5 | Verfügbar, wenn effort nicht höher als high ist |
Die alte Schreibweise funktioniert nur bei diesen beiden IDs |
So lässt sich between_tools von claude-sonnet-5-5 schnell verifizieren
Bevor du Änderungen live schaltest, solltest du das geänderte Verhalten zunächst mit wenig Traffic verifizieren. Registriere dich bei APIYI (apiyi.com) und hole dir einen API-Schlüssel – neue Nutzer erhalten ein kostenloses Testkontingent. Die Anfragen gehen an https://api.apiyi.com; im Request-Body setzt du type von thinking auf between_tools und wählst bei effort eine der drei Stufen. Lass zuerst eine Runde laufen und vergleiche dann mit dem adaptiven Modus ohne thinking, um die Veränderungen bei der Ausgabestruktur und beim Token-Verbrauch zu beobachten.
🚀 Tipp zur schnellen Verifikation: Hol dir über APIYI apiyi.com ein kostenloses Testkontingent und lass dieselbe Eingabeaufforderung einmal im Modus
between_toolsund einmal im adaptiven Modus laufen. Erst wenn du die Unterschiede bestätigt hast, änderst du den bestehenden Code. Die Plattform unterstützt den einheitlichen Aufruf gängiger Modelle wie Claude, OpenAI und Gemini; die OpenAI-kompatible Schnittstelle wird nach Verbrauch abgerechnet, was einen direkten Vergleich und Wechsel erleichtert.
Häufig gestellte Fragen (FAQ): disabled, between_tools und 400-Fehler
F1: Lässt sich das Denken bei claude-opus-5-5 überhaupt abschalten?
Nein. Die offizielle Aussage vom 2026-11-08 ist eindeutig: Wird `disabled` übergeben, kommt ein 400 zurück. Für diese Modell-ID gibt es keinen Schalter zum Abschalten des Denkens; du kannst die Denktiefe nur über `effort` reduzieren, die Standardstufe ist `medium`. Wenn dein Szenario zwingend ganz ohne Denken laufen muss, bleibt nur ein Wechsel der Modell-ID.
F2: Lässt sich `between_tools` bei claude-sonnet-5-5 mit `budget_tokens` kombinieren?
Nein. Die Dokumentation schreibt ausdrücklich, dass `between_tools` nicht gleichzeitig `display` oder `budget_tokens` mitführen darf; das zugehörige `effort` akzeptiert nur die drei Stufen `low`, `medium` und `high` und darf `high` nicht überschreiten. Wenn du das Denkbudget fein steuern willst, bleibt nur der Rückfall auf den adaptiven Modus oder ein Wechsel der Modell-ID.
F3: Warum liefert meine Claude-Anfrage plötzlich einen 400-Fehler zurück?
Prüfe zuerst, ob im Request-Body `type` von `thinking` auf `disabled` gesetzt ist – bei claude-opus-5-5 und claude-sonnet-5-5 ist das laut Dokumentation die auslösende Bedingung. Wenn das bestätigt ist, gehst du nach der Zuordnung in diesem Artikel vor: Beim ersteren reduzierst du `effort`, beim letzteren wechselst du zu `between_tools`. Maßgeblich ist die offizielle Dokumentation vom 2026-11-08 (UTC+8); die APIYI-Seite wurde am 2026-11-09 um 10:40 synchronisiert.
F4: Wie lässt sich die Wirkung von `between_tools` bei claude-sonnet-5-5 schnell verifizieren?
Registriere dich bei APIYI (apiyi.com) und hole dir einen API-Schlüssel – neue Nutzer erhalten ein kostenloses Testkontingent. Die Anfragen gehen an `https://api.apiyi.com`; setze `type` von `thinking` auf `between_tools` und wähle eine beliebige Stufe für `effort`. Nach einer Runde siehst du schon den Unterschied zum adaptiven Modus.
F5: Beanspruchen Denk-Token einen Teil des Ausgabebudgets?
Ja. Denk-Token werden auf `max_tokens` angerechnet; die maximale Ausgabe beträgt bei beiden Modell-IDs 128000. Wenn du `max_tokens` in der Anfrage zu niedrig setzt, kann das Denken zuerst das Budget aufbrauchen und der eigentliche Text wird abgeschnitten. Reserviere daher genug Spielraum für den Antworttext.
claude-opus-5-5 und claude-sonnet-5-5: die wichtigsten Kernpunkte
- Bei claude-opus-5-5 lässt sich das Denken nicht abschalten:
disabledzu übergeben führt direkt zu einem 400 – du kannst nur übereffortherunterregeln, Standard istmedium. - claude-sonnet-5-5 nutzt jetzt
between_tools: das vorgelagerte Denken wird abgeschaltet, nur die Fortschrittsmeldungen zwischen Tool-Aufrufen bleiben erhalten. - Drei rote Linien bei den Parametern:
effortkennt nurlow,mediumundhigh, höher alshighgeht nicht, unddisplaysowiebudget_tokenssind tabu. - Budget-Regel: Thinking-Tokens zählen in
max_tokenshinein, bei beiden IDs liegt das Limit bei 128000. - Zum Ausprobieren: APIYI apiyi.com, die Basis-URL im Anthropic-Format lautet
https://api.apiyi.com– ohne/v1anhängen.
Fazit: drei Schritte, um den 400er zu vermeiden
Die Regeln für claude-opus-5-5 und claude-sonnet-5-5 lassen sich in drei Sätzen zusammenfassen:
- claude-opus-5-5:
disabledführt zum 400er, das Denken lässt sich nicht abschalten – nureffortherunterdrehen. - claude-sonnet-5-5: vorgelagertes Denken abschalten und stattdessen
between_toolsverwenden, dreieffort-Stufen,displayundbudget_tokenssind nicht erlaubt. - Budget: Thinking-Tokens zählen in
max_tokenshinein, Obergrenze 128000 – lass genug Reserve für den eigentlichen Text.
Wenn du gerade an diesem 400er festhängst, empfiehlt es sich, zuerst bei APIYI apiyi.com mit dem kostenlosen Testkontingent eine Runde mit between_tools zu drehen und das Verhalten zu bestätigen, bevor du bestehenden Code anpasst. Auf der Plattform rufst du mit einem einzigen API-Schlüssel die gängigen Modelle von OpenAI, Claude, Gemini und Co. auf – abgerechnet wird nach Verbrauch, ideal für schnelle Vergleiche und Wechsel.
📚 Referenzen
- APIYI Claude Thinking-Parameter-Leitfaden: Geeignete Schreibweise für
effortundthinking - Link:
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
Beschreibung: Die am 2026-11-09 um 10:40 aktualisierte Version – die wichtigste Faktenquelle dieses Artikels
-
APIYI Leitfaden-Update: Offizielle Erläuterung zur Abstimmung der Formulierungen in dieser Runde
- Link:
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
Beschreibung: Dokumentiert den Abgleich mit der offiziellen Dokumentation vom 2026-11-08
-
Anthropic offizielle Dokumentation: Die ursprüngliche Formulierung des
thinking-Parameters - Link:
docs.anthropic.com - Beschreibung: Empfohlen zur begleitenden Lektüre, um die aktuellste Schreibweise zu bestätigen
Autor: APIYI Technikteam
Technischer Austausch: Kontaktieren Sie uns gerne über die Startseite der APIYI-Website; weitere Materialien finden Sie im Dokumentationszentrum unter docs.apiyi.com
