Die bestehenden Hooks von Claude Code werden ebenfalls bei Ereignissen ausgeführt, und zwar als Shell-Befehl, HTTP-Anfrage oder Prompt, den Sie in einer Einstellungsdatei konfigurieren. Die Handler eines Mods sind dagegen Funktionen, die innerhalb von Claude Code ausgeführt werden. Claude Code bezeichnet beide Arten als Hooks: Auf diesen Seiten bezeichnet „Hook“ den Handler eines Mods, und die in der Einstellungsdatei konfigurierte Art ist ein „Einstellungs-Hook“.
Was ein Mod leisten kann
Einstellungs-Hooks, Skills, Statuszeilen und MCP-Server arbeiten von außerhalb von Claude Code: Jeder davon führt ein Skript aus oder stellt Claude Text oder Tools bereit. Ein Mod läuft innerhalb von Claude Code und kann daher Dinge tun, die ihnen nicht möglich sind:- Eine bedienbare Oberfläche zeichnen: einen Bereich neben dem Transkript oder ein Band über dem Prompt, mit Tabs, Schaltflächen und Textfeldern. Siehe In der Oberfläche zeichnen.
- Die Oberfläche von Claude Code selbst neu zeichnen: Teile ersetzen oder umgestalten, die Claude Code selbst zeichnet, etwa die Zeile eines Tool-Aufrufs, den Spinner oder den Dialog, in dem Claude Fragen stellt. Siehe Ändern, was Claude Code bereits zeichnet.
- In einen Tool-Aufruf oder eine Anfrage eingreifen: beispielsweise einen Tool-Aufruf zurückhalten, während Sie dem Benutzer eine Frage stellen, ihn beantworten, ohne das Tool auszuführen, oder eine Anfrage an ein anderes Modell senden. Siehe Einen Tool-Aufruf absichern oder ändern und Einen Turn verfolgen.
- Eigenen Code bei einem Befehl ausführen: ein
/command, der Ihre Funktion sofort ausführt, ohne Claude-Turn, selbst während Claude arbeitet. Siehe Einen Befehl oder ein Tool hinzufügen. - Daten zwischen Hooks teilen: Die Hooks eines Mods teilen sich die Variablen in seiner Datei, sodass ein Hook anzeigen kann, was ein anderer aufzeichnet. Beispielsweise kann ein Hook Tool-Aufrufe zählen, während ein anderer die Anzahl neben dem Spinner anzeigt, oder ein Hook kann die Token-Nutzung jeder Anfrage auslesen, während ein anderer sie in einem Bereich als Diagramm darstellt. Siehe Auf Ereignisse reagieren.
claude -p und in Cloud-Sitzungen. Wenn ein Einstellungs-Hook, ein Skill oder ein MCP-Server bereits das leistet, was Sie benötigen, vergleichen Sie sie, bevor Sie einen Mod schreiben. Informationen zur Verwaltung von Mods für eine Organisation finden Sie unter Mods für Ihre Organisation verwalten.
Einen Mod erhalten
So beginnen Sie mit einem Mod:- Einen vorhandenen verwenden: Einige der eigenen Funktionen von Claude Code sind Mods, zum Beispiel
/diff. Siehe In Claude Code integrierte Mods. - Einen erstellen: Beschreiben Sie in einer Claude Code-Sitzung, was Sie möchten, und Claude schreibt den Mod. Siehe Claude um einen Mod bitten. Um zu verstehen, wie der Code eines Mods funktioniert, schreiben Sie selbst einen.
- Einen installieren: Siehe Einen Mod installieren oder aktualisieren oder einen Beispiel-Mod ausprobieren
Einen Mod installieren oder aktualisieren
Ein Mod wird als Plugin aus einem Marketplace installiert. Geben Sie den Namen des Plugins, ein@ und den Namen des Marketplace an. Diese Beispiele installieren ein Plugin namens token-chart aus einem Marketplace namens your-org:
- Führen Sie in einer Claude Code-Sitzung
/plugin install token-chart@your-orgaus. - Führen Sie in Ihrer Shell
claude plugin install token-chart@your-orgaus.
/reload-plugins aus, um ihn zu laden. Andernfalls wird er beim nächsten Start von Claude Code geladen.
Einen Beispiel-Mod ausprobieren
Anthropic stellt Beispiel-Mods im Verzeichnisclaude-code/mods des Repositorys claude-code-playground bereit. Jeder davon ist ein vollständiges Plugin, und seine README beschreibt, wie er erstellt wurde. Das Repository stellt sie ohne Gewähr und ohne Support bereit.
token-weather: zeichnet oberhalb des Prompts eine Vorhersage für Ihr Kontextfensterblast-radius: hält einen riskanten Shell-Befehl wierm -rfoder einen Force-Push an und zeigt, was er ändern würde, mit Schaltflächen zum Fortfahren oder Abbrechenreplay-theater: fügt einen Befehl/replayhinzu, der schrittweise durch die Dateiänderungen geht, die Claude im letzten Turn vorgenommen hat
--plugin-dir. Um zu bestätigen, dass der Mod geladen wurde, prüfen Sie, welche Mods die Sitzung geladen hat.
Um einen dauerhaft zu behalten, fügen Sie das Verzeichnis claude-code/mods des Klons als Marketplace hinzu und installieren Sie den Mod anschließend aus claude-code-playground-mods. Der Marketplace verweist auf Ihren Klon, daher wird der Mod nicht mehr geladen, wenn Sie den Klon verschieben oder löschen.
Entscheiden, ob Sie einem Mod vertrauen
Ein Mod ist Code, der mit Ihren Berechtigungen innerhalb von Claude Code ausgeführt wird. Installieren Sie Mods nur von Autoren und aus Marketplaces, denen Sie vertrauen.Worauf ein Mod zugreifen kann
Ein Mod wird mit Ihren Berechtigungen ausgeführt. Informieren Sie sich daher vor der Installation, worauf er Zugriff hat. Sobald ein Mod geladen ist, kann er:- Auf Ihrem Rechner in Ihrem Namen handeln: Dateien überall dort lesen und schreiben, wo Ihr Benutzerkonto dies kann, Programme starten und Netzwerkanfragen stellen
- Ihre Geheimnisse lesen: Umgebungsvariablen und Einstellungsdateien, einschließlich eines API-Schlüssels, den Sie in einer der beiden ablegen
- Ihre Sitzung einsehen: jeden Prompt, den Sie senden, und jeden Tool-Aufruf, den Claude ausführt
- Ihre Sitzung verändern: einen Prompt oder einen Tool-Aufruf umschreiben, einen Prompt so absenden, als hätten Sie ihn eingegeben, oder eine Nachricht an eine andere Ihrer Sitzungen senden
- Handeln, ohne Sie zu fragen: einen Tool-Aufruf genehmigen, bevor Sie gefragt werden
- Ihr Nutzungskontingent verbrauchen: ein Modell über Ihren Plan oder Ihren API-Schlüssel aufrufen
deny- oder ask-Regeln oder Ihre PreToolUse-Hooks stoppen würden, sofern der integrierte Wächter dies nicht verhindert. Ist der Wächter geladen, kann der Mod eines Benutzers dies standardmäßig nicht. In einer lokalen Terminal-Sitzung bedeutet cc-plugin-sec-default auf dem Tab Installed von /plugin, dass der Wächter geladen ist.
Ein Mod kann einen Großteil der Oberfläche von Claude Code umgestalten, nicht jedoch die Berechtigungsabfrage. Er kann nicht ändern, was Ihnen eine Berechtigungsabfrage anzeigt.
Vor der Installation auflisten, was ein Mod tut
Bevor Sie einen Mod installieren, können Sie auflisten, welche Events er verarbeitet und was er von Claude Code anfordert, etwa eine Datei zu lesen oder eine Netzwerkanfrage zu stellen, ohne ihn auszuführen. Beschaffen Sie sich zunächst die Dateien des Plugins, zum Beispiel indem Sie sein Repository klonen. Führen Sie dann in Ihrer Shellclaude plugin validate für das Verzeichnis des Plugins aus:
hooks: und calls: in der Ausgabe listen die Events auf, die der Mod verarbeitet, und was er von Claude Code anfordert. Prüfen, was ein Mod tun kann zeigt die Ausgabe und auf welche Aufrufe Sie achten sollten.
Mods ein- oder ausschalten
Mods sind standardmäßig aktiviert. Verwenden Sie im Terminal Claude Code v2.1.287 oder neuer. Die Desktop-App enthält ihre eigene Kopie von Claude Code, und Mods funktionieren dort ab v2.1.286. Prüfen Sie die Version dort, wo Sie Mods verwenden:- Terminal: Führen Sie in Ihrer Shell
claude --versionaus. Falls Ihre Version älter ist, aktualisieren Sie Claude Code. - Desktop-App: Geben Sie in einer lokalen Sitzung im Tab Code
/statusein und lesen Sie die Zeile Claude Code, die eine Version wie2.1.286anzeigt. Falls Ihre Version älter ist, aktualisieren Sie die Desktop-App.
- Ein Mod: Deaktivieren oder deinstallieren Sie sein Plugin über den Tab Installed in
/plugin - Alle installierten Mods, für eine Sitzung: Starten Sie Claude Code mit
--safe-mode, wodurch auch Ihre anderen Anpassungen deaktiviert werden - Alle von Ihnen installierten Mods, in jeder Sitzung: Setzen Sie
"disableAllHooks": truein~/.claude/settings.json. Ihre Einstellungs-Hooks und Ihre benutzerdefinierte Statuszeile werden ebenfalls gestoppt. Was Ihre Organisation verwaltet, läuft weiter.
disableAllHooks und das allowManagedModsOnly Ihrer Organisation stoppen einen Mod und lassen den Rest seines Plugins unverändert: Das Plugin bleibt installiert, und seine Skills, Befehle, Agenten und MCP-Server werden geladen. Andere Einstellungen und Flags reichen weiter. disableAllHooks und Was unter allowManagedHooksOnly ausgeführt wird listen auf, was jede dieser Optionen mit einem Plugin und seinen Einstellungs-Hooks macht.
Um herauszufinden, ob Mods bei Ihnen geladen werden können, lesen Sie Prüfen, ob Mods geladen werden können.
Wenn Sie
CLAUDE_CODE_ENABLE_FUNCTION_HOOKS während des Early Access gesetzt haben, entfernen Sie es. Claude Code v2.1.287 und neuer ignoriert diese Variable, sodass das Setzen auf 0 Mods nicht ausgeschaltet hält.Sehen, welche Mods eine Sitzung geladen hat
Um zu sehen, welche Mods eine Terminal-Sitzung geladen hat, führen Sie/plugin im Prompt von Claude Code aus. Eine abgeblendete Zeile unter den Tabs zeigt die Anzahl und die Namen an, etwa 1 mod active · first-mod. Wenn ein von Ihnen installierter Mod dort nicht aufgeführt ist, lesen Sie Herausfinden, warum ein Mod nichts tut.
Wie ein Mod funktioniert
Ein Mod ist ein Plugin, dessen Code Event-Handler registriert, die als Hooks bezeichnet werden. Claude Code führt einen Hook aus, wenn sein Ereignis eintritt, etwa wenn Claude ein Tool aufruft oder wenn der Spinner gezeichnet wird. Ein kleiner Mod besteht aus drei Dateien:plugin.json: das Manifest des Pluginshooks.json: verweist auf Ihre Code-Dateiregister.js: Ihr Code, das sogenannte Hooks-Modul. Es teilt Claude Code mit, bei welchen Ereignissen Ihre Funktionen ausgeführt werden sollen.
register.js. Sie zählt die Tool-Aufrufe, die Claude ausführt, und zeigt die Anzahl neben dem Spinner an, während Claude arbeitet, etwa als Thinking · tool calls: 3….
hooks/register.js
calls am Anfang:
- Der
tool.call-Hook wird jedes Mal ausgeführt, wenn Claude kurz davor ist, ein Tool zu verwenden. Er erhöhtcallsum eins, fordert Claude Code auf, die Oberfläche neu zu zeichnen, und lässt das Tool wie gewohnt laufen. - Der
ui.render-Hook wird jedes Mal ausgeführt, wenn Claude Code den Spinner zeichnet. Er behält den eigenen Spinner von Claude Code bei und fügt die Anzahl nach dem Wort hinzu.
Thinking · tool calls: 1…, dann 2…, dann 3….
Was ein Hook mit einem Ereignis tun kann
Claude Code führt Ihren Hook aus, bevor es auf das Ereignis reagiert, sodass der Hook entscheidet, was als Nächstes passiert. Er kann:- Beobachten: festhalten, was passiert, und es unverändert fortsetzen lassen, wie es der
tool.call-Hook im Beispiel tut - Umschreiben: das Ereignis ändern, bevor es fortgesetzt wird, wie es der
ui.render-Hook tut, wenn er die Anzahl zum Spinner hinzufügt - Beantworten: das Ereignis selbst behandeln, sodass das übliche Verhalten nicht ausgeführt wird, etwa indem ein Befehl abgelehnt wird
Wo Mods ausgeführt werden
Die Hooks eines Mods werden in jeder Art von Sitzung ausgeführt, die das Plugin lädt, unabhängig davon, welcher Anbieter das Modell bereitstellt, einschließlich Amazon Bedrock, Agent Platform von Google Cloud und Microsoft Foundry. Beim Zeichnen ist der Umfang enger: Was ein Mod zeichnet, wird im Terminal, in der Desktop-App und in der VS Code-Erweiterung angezeigt. Diese Tabelle listet jeden Ort auf, an dem Sie Claude Code ausführen können:
Ein Mod, der zeichnet, kann prüfen, in welcher App er ausgeführt wird, und dort, wo nichts gezeichnet wird, auf eine Zeile im Transkript oder die Textantwort eines Befehls zurückgreifen.
Mods für Ihre Organisation steuern
Administratoren legen über verwaltete Einstellungen fest, ob Mods ausgeführt werden und welche. Mods für Ihre Organisation verwalten beschreibt, was standardmäßig geschieht, wie Sie einen Mod überprüfen und wie Sie eine Richtlinie mit einem eigenen Mod durchsetzen.Mods, Einstellungs-Hooks, Skills und MCP-Server im Vergleich
Mods, Einstellungs-Hooks, Skills und MCP-Server überschneiden sich. Diese Tabelle zeigt, was jeweils dahintersteckt und wann Sie welche Variante wählen sollten.
Die anderen Varianten haben jeweils eine eigene Seite: Hooks, Skills und MCP. Ein Plugin kann alle davon enthalten, sodass ein Mod im selben Plugin wie ein Skill und ein MCP-Server ausgeliefert werden kann.
In Claude Code integrierte Mods
Einige der eigenen Funktionen von Claude Code sind Mods. Um die Mods Ihrer Sitzung anzuzeigen, führen Sie/plugin im Prompt von Claude Code aus und wechseln Sie zum Tab Installed, der sie unter Built-in auflistet. Sie können einen integrierten Mod weder aktualisieren noch deinstallieren. Die Zeile mods active lässt integrierte Mods aus.
Diese Tabelle listet einige der Built-in-Einträge unter dem Namen auf, den /plugin anzeigt:
Für ein Built-in-Plugin, das nicht in der Tabelle steht, öffnen Sie dessen Details in
/plugin, um nachzulesen, was es tut, oder um es zu deaktivieren.
Die Einstellungen und Flags, die installierte Mods stoppen, wie disableAllHooks, --bare und --safe-mode, stoppen integrierte Mods nicht.
Den Quellcode integrierter Mods lesen
Der Quellcode einiger dieser Mods ist im Verzeichnismods des Claude Code-Repositorys öffentlich verfügbar. Jeder davon ist ein vollständiges Plugin mit seinem Hooks-Modul und Tests:
diff: der/diff-Bereich, mit Schaltflächen, die an Tastaturaktionen gebunden sind, und einem Scrollen, das der Mod selbst verarbeitetagents-md: lädtAGENTS.mdals Projektanweisungen, mit eineruserConfig-Optionsec-default: der unter Wissen, was standardmäßig geschieht beschriebene Schutz, ein Vorbild für einen Mod, der Richtlinien durchsetzttelemetry: fügt Methoden hinzu, die andere Mods aufrufen können, und liefert deren Typen mit
Nächste Schritte
- Einen Mod erstellen: Erstellen Sie einen Mod, der Tool-Aufrufe zählt, die Anzahl neben dem Spinner anzeigt und einen Befehl hinzufügt, und lernen Sie den Ablauf aus Bearbeiten und Neuladen kennen
- In der Oberfläche zeichnen: Bereiche, das Band über dem Prompt, Schaltflächen, Textfelder und Zustand
- Auf Ereignisse reagieren: Tool-Aufrufe, Prompts, Turns und die Reihenfolge, in der Mods ausgeführt werden
- Die Mods-API verwenden: Befehle, Tools, Modellaufrufe, Timer und Dateien
- Einen Mod testen: automatisierte Tests, die ohne Sitzung ausgeführt werden
- Fehlerbehebung bei einem Mod: die Gründe, warum ein Mod nichts tut, und das Debug-Log
- Mods für Ihre Organisation verwalten: Standardwerte, verwaltete Einstellungen, Überprüfen eines Mods und Richtlinien-Mods
- Mods-Referenz: Ereignisse, Methoden, Elemente und Limits