PreModelSwitch
Ab 2.1.251: Modellwechsel blockieren / bestätigen / annotieren
Claude Code 2.1.251 (2026-08-28) fügt die Hooks PreModelSwitch und PostModelSwitch hinzu. Changelog: einen Modellwechsel blockieren, bestätigen oder annotieren. SessionStart-Resume-Hooks erhalten jetzt außerdem die Veralterung der Sitzung und die geschätzten Re-Cache-Kosten. Es handelt sich um offizielle Hook-Events, nicht um Anleitungen, HTTP-Header umzuschreiben oder einen anderen Client vorzutäuschen.
Aktualisiert 2026-08-30
Vier Fakten zum Zitieren
Der Event-Name vor dem Wechsel
Der Changelog stellt ihn PostModelSwitch zur Seite. Er läuft vor einem Wechsel über /model, den Picker, das SDK oder eine Wiederaufnahme.
Drei offizielle Aktionen
Deny bricht den Wechsel ab; ask erfordert eine Bestätigung (im Headless-Modus abgelehnt); annotate fügt Kontext für die nächste Anfrage ein. Auch Exit-Code 2 kann blockieren. Das ist die Hook-Semantik des Produkts.
2026-08-28
Im selben Changelog wurde außerdem behoben, dass effort … bei deaktiviertem Thinking nicht unterstützt wird. Ein Upgrade, zwei Oberflächen.
Neue Resume-Felder
SessionStart-Resume-Hooks erhalten jetzt die Veralterung der Sitzung und die geschätzten Re-Cache-Kosten. Wenn ein Modellwechsel den Cache entwertet, ist das ein beobachtbares Kostensignal, keine Umgehung der Abrechnung.
SessionStart sah nie ein /model mitten in der Sitzung
Bestehende Hook-Anleitungen behandeln Stop, SessionStart und Tool-Events. Vor 2.1.251 gab es für einen /model- oder Picker-Wechsel mitten in der Sitzung kein passendes Hook-Paar. PreModelSwitch schließt diese Lücke: Richtlinien, Audit und Prompts können am Wechsel selbst ansetzen, statt nur beim Sitzungsstart zu laufen.
Der Picker kann auch den Effort pro Sitzung setzen
Gleiches Release: Der Modell-Picker kann für die Sitzung Effort und ein ultracode-Flag setzen; /effort merkt sich jetzt einen Standardwert pro Modell. Das „nächste Modell“, das PreModelSwitch sieht, kann Effort enthalten. Beobachten Sie die Anfrage. Schreiben Sie keine Client-Kennungen im Stil von Originator um.
Zeitachse
Claude Code hatte bereits SessionStart, Stop und Tool-Events. Unternehmen nutzen sie für Audit und Blockierung.
Hook-Events PreModelSwitch und PostModelSwitch hinzugefügt (einen Modellwechsel blockieren, bestätigen oder annotieren).
Verlassen Sie sich auf Ihren lokalen Changelog und die Hooks-Dokumentation. Die Payload-Felder folgen dem Schema der Version, die Sie einsetzen. Diese Seite erfindet keine unveröffentlichten Header.
Bestätigt vs. missverstanden
Bestätigt
Event-Namen, Blockieren/Bestätigen/Annotieren, derselbe Pfad wie /model und der Picker, Veralterung bei Resume und Re-Cache-Kosten: Changelog 2.1.251, erneut geprüft am 2026-08-30.
Missverstanden
„Mit dem Hook am Gateway eine andere Modell-ID vortäuschen“ – Gegenstand ist der eigene Wechselablauf von Claude Code. Diese Seite nennt offizielle Events; sie beschreibt nicht, Header oder Originator umzuschreiben, um einen Katalog zu ändern. „Ask öffnet im Headless-Modus ein Fenster“ – laut Changelog lehnt ask im Headless-Modus ab.
Start-Hooks vs. Wechsel-Hooks
SessionStart: Sitzung öffnen / fortsetzen
Repo-Regeln einspielen, Workspace prüfen. Ab 2.1.251 enthält Resume zusätzlich Veralterung und Re-Cache-Schätzung. Ein /model mitten in der Sitzung sieht er nicht.
PreModelSwitch: vor jedem Modellwechsel
„Dieses Repo darf nicht auf diese Stufe wechseln“, „vor dem Wechsel bestätigen“, „eine Einschränkung für das nächste Modell annotieren“. PostModelSwitch protokolliert im Nachhinein.
Wie offizielle Hooks eingebunden werden (Beobachtung)
Auf 2.1.251+ aktualisieren und PreModelSwitch / PostModelSwitch gemäß der Claude Code Hooks-Dokumentation registrieren. Aktionen laut Changelog: blockieren, bestätigen, annotieren. Diese Seite liefert keine Schritte, um Modell-IDs vorzutäuschen, HTTP-Header umzuschreiben oder Modellrichtlinien der Organisation zu umgehen. Soll eine Richtlinie einen Wechsel stoppen, nutzen Sie das offizielle deny / Exit 2.
QCode führt diese Hooks nicht aus
PreModelSwitch läuft im Claude Code Client. QCode ist eine Modell-API. Welche angebotene ID nach dem Wechsel tatsächlich angesprochen wird, richtet sich nach dem von Ihnen gesendeten Modellfeld und dem Katalog des Anbieters. Für Ihre eigene API verwenden Sie einen bereits eingerichteten Key zum offiziellen Preis × Servicegebühr.
FAQ
Wann wird PreModelSwitch ausgelöst?
Laut öffentlichen Hinweisen bei Wechseln über /model, den Picker, das SDK und durch Wiederaufnahme. Maßgeblich ist die Event-Tabelle in der Hooks-Dokumentation Ihrer Version.
Blockieren vs. bestätigen?
Changelog: deny bricht ab; ask bestätigt und lehnt im Headless-Modus ab. Annotate blockiert nicht, sondern fügt Kontext hinzu.
Dasselbe wie der Effort-Fix in 2.1.251?
Nein. Die andere Linie an diesem Tag ist der 400-Fehler bei xhigh/max + deaktiviertem Thinking. Hooks sind Ereignisse; Effort ist eine Parameterkombination.
Kann ein Hook dem Gateway vortäuschen, ich sei ein anderer Client?
Diese Seite beschreibt kein Umschreiben von Client-Kennungen oder des Originators. Hooks beobachten und beschränken den internen Modellwechsel von Claude Code.
Sind die Re-Cache-Kosten beim Fortsetzen eine Rechnung?
Changelog: geschätzte Re-Cache-Kosten für Hook-Entscheidungen. Abgerechnet wird weiterhin nach Tokens und offiziellen Preisen, nicht nach diesem Feld als eigenem Posten.
Leitet QCode diese Hooks weiter?
Nein. Hooks gehören zum Lebenszyklus des Clients. Die API sieht nur die Messages / Completions, die Sie senden.
Quellen
Claude Code Changelog 2.1.251 (2026-08-28): Hook-Ereignisse PreModelSwitch und PostModelSwitch hinzugefügt (Modellwechsel blockieren, bestätigen oder annotieren); SessionStart-Resume-Hooks erhalten jetzt die Veraltung der Sitzung und die geschätzten Re-Cache-Kosten. code.claude.com/docs/en/changelog. Erneut geprüft am 2026-08-30.
Modellwechsel können offizielle Hooks haben; abgerechnet wird weiterhin nach den verkauften IDs
PreModelSwitch ist ein Client-Ereignis von Claude Code. Für den API-Zugriff gilt bei verkauften Modellen: offizieller Preis × Servicegebühr.
Verwandt
Claude Code Hooks-Automatisierung
Bestehende Ereignisse SessionStart / Stop; diese Seite ergänzt nur den Ausschnitt zum Modellwechsel.
Claude Code Slash-Befehle
/model und die Auswahl sind ein und derselbe PreModelSwitch-Auslöser.
Anthropic Agent Skills
Eine andere offizielle Erweiterungsschnittstelle; vermischen Sie die Namen nicht mit Hook-Ereignissen.
Auslegung des Claude Code 2.1.251 Changelogs, keine Zusage zu unveröffentlichten Payload-Feldern. QCode führt keine Client-Hooks aus und umgeht keine Modellrichtlinien der Organisation.