Claude Code 2.1.328 ändert das Verhalten von Hooks in Code Mode und bei verwalteten PostToolUse-Hooks
Laut Changelog von Version 2.1.328 führt Code Mode keine UserPromptSubmit-Hooks mehr auf Script-Ausgaben aus, und verwaltete PostToolUse-Hooks lösen bei abgelehnten Aufrufen nicht mehr aus.
Der Changelog zu Claude Code 2.1.328 von Anthropic ändert zwei Verhaltensweisen von Hooks, die alle betreffen, die Tool-Aufrufe über Hooks protokollieren, schwärzen oder freigeben. Code Mode führt UserPromptSubmit-Hooks nicht mehr auf der Ausgabe von Scripts aus. Verwaltete PostToolUse-Hooks lösen nicht mehr bei Aufrufen aus, die schon vor der Ausführung abgelehnt werden. Die Release Notes bringen außerdem eine neue Fehleroption für MCP-Tool-Hooks, doch es sind die beiden Streichungen, die bestehende Setups unbemerkt aushebeln können.
Die Änderung in Code Mode ist die direktere. Code Mode erlaubt Claude, Scripts auszuführen, die Tools aufrufen. Bis zu diesem Release liefen UserPromptSubmit-Hooks, auch verwaltete, auf dem, was diese Scripts ausgaben. Laut Changelog ist das nun nicht mehr der Fall. Wer sich auf diesen Weg verlassen hat, um Script-Ausgaben zu prüfen oder zu schwärzen, muss die Aufgabe verlagern. Der Changelog empfiehlt einen PostToolUse-Hook, der mit updatedToolOutput die Ausgabe des Tools umschreibt.
Die zweite Änderung betrifft Ablehnungen. Verwaltete PostToolUse-Hooks sind die Stelle, an der ein Log-Eintrag, eine Umschreibung, eine Blockade oder ein Abbruch erfolgen kann. Laut Changelog lösen verwaltete PostToolUse-Hooks bei Aufrufen, die vor ihrer Ausführung abgelehnt wurden, überhaupt nicht mehr aus, sodass dort keine dieser Aktionen stattfindet. Der PostToolBatch-Hook erhält die meisten dieser Ereignisse, kennzeichnet sie laut dem Eintrag aber nicht als abgelehnt. Teams, die abgelehnte Aufrufe über PostToolUse protokollieren, müssen diese Lücke berücksichtigen.
Die neue Option onFailure wirkt in die entgegengesetzte Richtung. Das Release ergänzt „onFailure“: „block“ für mcp_tool-Hooks: Schlägt der Aufruf eines Hooks fehl, wird die Aktion blockiert. Command- und HTTP-Hooks verhalten sich bereits so. Für Teams, die wollen, dass eine fehlgeschlagene externe Prüfung eine Aktion stoppt, statt sie durchzulassen, ist das die relevante Neuerung.
Das Release ist umfangreich. Viele seiner 91 Bugfixes und 19 Verbesserungen betreffen Code Mode, Remote-Sessions, das Terminal und selbst gehostete Runner. Unter den Fixes für Code Mode ist einer, der behebt, dass Claude nicht erfuhr, dass ein Code-Mode-Script abgebrochen wurde, wenn eine Session über den Picker oder in einem Modus mit Berechtigungsabfrage fortgesetzt wurde. Diese Fixes haben mit den Hook-Änderungen nichts zu tun. Wer verwaltete Hooks gemeinsam mit Code Mode einsetzt, sollte die beiden Hook-Einträge zusammen lesen, denn im selben Release verschiebt sich der Weg für das Schwärzen, und der Weg für Ablehnungen wird enger.
Was sich ändert
Art: Inkompatible Änderung · Betrifft: Claude Code 2.1.328, Code Mode, UserPromptSubmit hooks, managed PostToolUse hooks, PostToolBatch hook, mcp_tool hooks
Warum es wichtig ist
Unternehmen, die Hooks für Logging, Schwärzung oder die Durchsetzung von Richtlinien nutzen, könnten feststellen, dass manche Ereignisse sie nicht mehr erreichen. Lücken bei Audit oder Schwärzung könnten unbemerkt bleiben, wenn das Hook-Setup nicht überprüft wird.
Was Sie tun können
Teams mit verwalteten oder eigenen Hooks sollten ihr Logging und ihre Schwärzung mit Version 2.1.328 testen, bevor sie die Version ausrollen.
Originalquelle
Wo wir es gesehen haben
Claude Code changelog
KI hat diese Zusammenfassung aus den genannten Quellen geschrieben und ins Deutsche übersetzt. Niemand hat sie vor der Veröffentlichung einzeln geprüft. Bitte prüfen Sie die Originalquelle, bevor Sie sich darauf verlassen. So funktioniert es