Claude Mods erweitern Bedienflächen und Ereignishandler in Claude Code

Wann schützt ein Hinweis vor übersehener Arbeit, wann unterbricht er nur? Dan McAteer beschreibt bei Latent Space, wie Mods den Coding-Agenten Claude Code von Anthropic an seinen Arbeitsablauf anpassen. Sein Beispiel: ein Hinweis auf ungesicherte Änderungen, die er sonst versehentlich verworfen hätte.

Ereignishandler im Prozess von Claude Code

Die Claude-Code-Dokumentation beschreibt einen Mod als Plugin, das verändert, wie Claude Code aussieht und sich verhält. Er besteht aus JavaScript- oder TypeScript-Ereignishandlern, die Claude Code aufruft, wenn etwa ein Tool-Aufruf, ein abgeschickter Prompt oder das Zeichnen eines Oberflächenteils ansteht. Der Handler kann das Ereignis beobachten, verändern oder komplett übernehmen.

Settings-Hooks laufen dagegen als Shell-Befehl, HTTP-Request oder Prompt aus einer Einstellungsdatei. Die Handler eines Mods sind Funktionen innerhalb von Claude Code. Für alles außerhalb des eigenen Codes, etwa Zeichnen, Dateien lesen oder Netzwerkanfragen, ruft ein Hook die Mods-API auf. Deshalb kann Claude Code auflisten, was ein Mod tut, bevor du ihn installierst.

Zum Weiterlesen über Ereignisse in einem anderen Agenten-System: Hooks in OpenClaw: Den Agenten auf /new, /reset und andere Ereignisse reagieren lassen.

Panes, Bänder und eigene Befehle

Laut Anthropic kann ein Mod eine Bedienfläche zeichnen: ein Pane neben dem Gesprächsverlauf oder ein Band oberhalb des Eingabefelds, mit Tabs, Buttons und Textfeldern. Er darf auch Teile ersetzen oder umgestalten, die Claude Code selbst zeichnet, etwa die Zeile eines Tool-Aufrufs, den Spinner oder den Dialog für Rückfragen. Ein Slash-Befehl führt eine Funktion sofort aus, auch während Claude arbeitet. Dafür braucht es keinen zusätzlichen Arbeitsdurchlauf des Agenten, einen sogenannten Turn. Der Berechtigungsdialog bleibt dagegen unverändert.

Das Beispiel von Anthropic zählt Tool-Aufrufe. Während Claude arbeitet, erscheint die Zahl neben dem Spinner. Mod-Oberflächen können im Terminal, in der Desktop-App und in der VS-Code-Erweiterung erscheinen.

Mods sind laut Anthropic standardmäßig aktiv und setzen im Terminal Claude Code ab Version 2.1.287 voraus. Die Desktop-App bringt eine eigene Kopie mit. Dort funktionieren Mods ab 2.1.286. Welche Version du nutzt, zeigt im Terminal claude --version, in einer lokalen Sitzung im Code-Tab der Desktop-App /status in der Zeile „Claude Code“.

Ein Praxisbericht mit zwei Mods

Der Latent-Space-Text ist ein Erfahrungsbericht: McAteer nutzt Claude Mods nach eigener Aussage seit einigen Wochen, um Claude Code an seinen Arbeitsablauf anzupassen.

You Should Know zeigt laut McAteer als Nebenagent eine Notiz über dem Eingabefeld, wenn er etwas findet, das du übersehen haben könntest. Er ist in Claude Code eingebaut, aber ausgeschaltet, bis du ihn aktivierst. In seinem Beispiel ließ McAteer Claude Code verrauschte UI-Texte in einem privaten Projekt vereinfachen. Die bearbeitete Datei enthielt bereits nicht committete Arbeit, ebenso etwa 45 weitere Dateien. Der Mod schlug vor, diese frühere Arbeit zuerst zu committen oder zu stashen. Nach McAteers Darstellung bewahrte ihn das davor, unabsichtlich Arbeit zu verwerfen.

Next Steps Supervisor läuft laut McAteer nur nach Turns, in denen Claude Dateien bearbeitet, Befehle ausgeführt oder mindestens acht Tool-Aufrufe gemacht hat. Danach schlägt er einen nächsten Schritt als klickbaren Button vor, der die Anweisung als Nachricht an Claude Code schickt.

Seit der Installation am 15. Oktober erfüllten nach McAteers Angaben 99 von 111 Turns diese Schwelle. Er überfliege die Hinweise inzwischen, weil sich der Mod fast immer melde. In einer Sitzung markierte der Supervisor eine Aufgabe als „Solved“ und listete zugleich zwei Lücken und drei Abkürzungen. Für eine Sitzung schaltet /supervisor off den Mod ab.

Aus beiden Beispielen ziehe ich einen Maßstab: Häufigere Nebenprüfungen bedeuten nicht automatisch bessere Kontrolle. Der Hinweis auf ungesicherte Arbeit kam vor einer Entscheidung, bei der McAteer sonst unbeabsichtigt Arbeit verworfen hätte. Ein Urteil nach 99 von 111 Turns konkurriert dagegen mit der eigentlichen Arbeit um Aufmerksamkeit. Es wird überflogen. Überzeugender finde ich deshalb das Prinzip hinter You Should Know, das sich meldet, wenn es etwas findet, das du übersehen haben könntest. Ein guter Mod spricht, wenn eine Entscheidung ansteht. Alles andere ist Dekoration.

ModSmith als Baukasten

Next Steps Supervisor gehört laut McAteer zu ModSmith, seinem Open-Source-Plugin mit fertigen Mods und einer Vorlage für neue, zusammenarbeitende Mods. Das ModSmith-Projekt bietet auf GitHub sechs komplette Mods zum Laden oder Anpassen an. Dazu veröffentlicht es Kostenschätzungen, Angaben zum Prompt-Cache und Abschaltmöglichkeiten.

Vor der Installation steht die Codeprüfung. Anthropic beschreibt dafür claude plugin validate: Lade zunächst die Plugin-Dateien herunter und prüfe das lokale Plugin-Verzeichnis. ./some-mod ist hier ein Platzhalter für dessen Pfad.

claude plugin validate ./some-mod

Die Ausgabe listet unter hooks: und calls: die behandelten Ereignisse und angeforderten API-Aufrufe, ohne den Mod auszuführen. Eine Sicherheitsfreigabe ist das nicht. Die Liste verrät, worauf ein Mod zugreifen will. Ob er damit sorgfältig umgeht, beantwortet sie nicht. Deshalb gehört die Lektüre des Codes dazu, und auch sie bleibt eine Einschätzung statt eines Beweises.

Wenn du dem Code vertraust, sieht ModSmith folgende Befehle in Claude Code vor: Marketplace hinzufügen, dann das Gesamtpaket installieren.

/plugin marketplace add DannyMac180/skills
/plugin install modsmith-all@modsmith

Alternativ installierst du nur den Skill mit /plugin install modsmith@modsmith und einzelne Mods, etwa den Supervisor mit /plugin install next-steps-supervisor@modsmith. Starte anschließend wie vom Projekt beschrieben eine neue Claude-Code-Sitzung. Prüfe im Terminal mit /plugin, ob die erwarteten Mods geladen sind: Laut Anthropic stehen Anzahl und Namen in einer gedimmten Zeile unter den Tabs. Fehlt ein Mod, kontrolliere die Version am verwendeten Zugang und die Liste der geladenen Mods.

Beim Gesamtpaket besteht laut ModSmith eine Einschränkung: Um einen abhängigen Einzelmod zu deaktivieren oder zu entfernen, musst du zuerst modsmith-all@modsmith deinstallieren. Die Einzelmods bleiben dabei installiert und lassen sich anschließend über /plugin verwalten.

Gebaut und geprüft wurde ModSmith nach Projektangaben gegen Claude Code 2.1.286 und 2.1.287. Mods gelten dort als Early-Access-Funktion, die sich zwischen Releases ändert. Live in der Desktop-App liefen laut Projekt bislang quiz-after und next-steps-supervisor, die übrigen Vorlagen noch nicht.

Rechte, Vertrauen und Tokenkosten

Anthropic warnt: Mods sind nicht isoliert. Ein Mod läuft mit deinen Berechtigungen und kann Dateien lesen und schreiben, Prozesse starten und Netzwerkanfragen stellen. Er sieht außerdem jeden Prompt, den du schickst, und jeden Tool-Aufruf von Claude. Aktiviertes Sandboxing isoliert Claudes Bash-Befehle, nicht aber Prozesse, die ein Mod startet. Anthropic empfiehlt deshalb, Mods nur von vertrauenswürdigen Autoren und Marketplaces zu installieren.

McAteer fühlt sich mit selbst geschriebenen und mitgelieferten Mods wohl, würde fremden Code aber vor der Installation lesen. Ergänzende Lektüre: Agent Plugins: Portables Format, Sicherheit bleibt Clientsache.

Für eine Sitzung lassen sich laut Anthropic alle installierten Mods durch den Shell-Aufruf claude --safe-mode stoppen. Dabei werden auch andere Anpassungen deaktiviert. Eingebaute Mods bleiben unberührt: Weder disableAllHooks noch --bare oder --safe-mode stoppen sie.

Zusätzliche Hinweise kosten auch Tokens. Laut McAteer liest jede Supervisor-Prüfung eine Abzweigung der bisherigen Konversation erneut ein, einen sogenannten Fork. Der größte Teil werde aus dem Prompt-Cache wiederverwendet, statt erneut vollständig verarbeitet zu werden; bei abgelaufenem Cache steige der Verbrauch. ModSmith veranschlagt für quiz-after und next-steps-supervisor nach verändernden Turns jeweils eine gecachte Nebenprüfung. Die Kostenangaben des Projekts sind Schätzungen, keine Verbrauchszusage.

Mods nach Entscheidungsnutzen auswählen und begrenzen

• Wähle einen Mod für eine konkrete Entscheidung, etwa den Umgang mit übersehener Arbeit. Mehr Hinweise allein sind kein Nutzen.
• Wenn du Meldungen nur noch überfliegst, reduziere sie. Nutze beim Supervisor den beschriebenen Sitzungsbefehl; beachte beim Deaktivieren einzelner Plugins die Paketabhängigkeiten.
• Wäge zusätzliche Nebenprüfungen gegen ihren Tokenverbrauch und die weitreichenden Nutzerrechte ab. Validierung und Codelektüre gehören vor die Installation, ersetzen aber keine Vertrauensentscheidung.