SpyBara
Go Premium

plugins/mods/overview.md 2026-10-01 23:59 UTC to 2026-10-02 19:58 UTC

This page contains 119 additions and 99 deletions.

2026
Thu 1 23:59 Fri 2 19:58

Mods – Übersicht

Fügen Sie Claude Code mit einem Mod Bereiche, Befehle und Regeln für Tool-Aufrufe hinzu. Erfahren Sie, was ein Mod leisten kann, wie Sie einen erstellen oder installieren und wo Mods ausgeführt werden.

Ein Mod ist ein Plugin, das das Aussehen und Verhalten von Claude Code verändert. Er besteht aus Event-Handlern in JavaScript oder TypeScript: Claude Code ruft einen davon auf, wenn ein Ereignis eintritt, etwa ein Tool-Aufruf, ein abgeschickter Prompt oder das Zeichnen eines Teils der Oberfläche, und der Handler kann das Ereignis beobachten, ändern oder vollständig übernehmen. Verwenden Sie einen Mod, um Claude Code eine eigene Funktion hinzuzufügen, beispielsweise einen Bereich, der nach jeder Anfrage grafisch darstellt, wie voll Ihr Kontext ist. Informationen zu den Dateien in einem Mod und ein vollständiges Beispiel finden Sie unter Wie ein Mod funktioniert.

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.

Mods funktionieren in der Claude Code CLI und im Code-Tab der Claude Desktop-App. Unter Wo Mods laufen erfahren Sie, wie sie sich an anderen Stellen verhalten, etwa in der VS Code-Erweiterung, in 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 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-org aus.
  • Führen Sie in Ihrer Shell claude plugin install token-chart@your-org aus.

Plugins installieren behandelt Marketplaces, Geltungsbereiche, die VS Code-Erweiterung und die Desktop-App sowie das Aktualisieren von Plugins. All dies gilt unverändert für ein Plugin, das einen Mod enthält.

Wenn Sie einen Mod über Ihre Shell installieren oder aktualisieren, während eine Sitzung geöffnet ist, führen Sie in dieser Sitzung /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 Verzeichnis claude-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 Kontextfenster
  • blast-radius: hält einen riskanten Shell-Befehl wie rm -rf oder einen Force-Push an und zeigt, was er ändern würde, mit Schaltflächen zum Fortfahren oder Abbrechen
  • replay-theater: fügt einen Befehl /replay hinzu, der schrittweise durch die Dateiänderungen geht, die Claude im letzten Turn vorgenommen hat

Ein Beispiel-Mod wird mit Ihren Berechtigungen ausgeführt. Um vor dem Laden zu sehen, was er tut, listen Sie seine Hooks und Aufrufe auf.

Um einen auszuprobieren, klonen Sie das Repository und laden Sie das Verzeichnis des Mods für eine Sitzung mit --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

Mods werden nicht in einer Sandbox ausgeführt. Wenn Sie Sandboxing aktivieren, isoliert die Sandbox die Bash-Befehle, die Claude ausführt, während ein Prozess, den ein Mod startet, außerhalb davon läuft.

Ein Mod, der Tool-Aufrufe genehmigt, kann einen Aufruf genehmigen, für den eine ask-Regel nachfragen würde oder den einer Ihrer eigenen PreToolUse-Hooks blockiert hat. Berechtigungen mit Hooks erweitern listet auf, was ein solcher Mod genehmigen kann, einschließlich der Fälle, in denen er einen Aufruf genehmigen kann, den eine deny-Regel ablehnt.

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 Shell claude plugin validate für das Verzeichnis des Plugins aus:

claude plugin validate ./some-mod

Die Zeilen 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 erfordern Claude Code v2.1.287 oder neuer und sind standardmäßig aktiviert. Führen Sie in Ihrer Shell claude --version aus, um dies zu prüfen, und aktualisieren Sie Claude Code, falls Ihre Version älter ist.

Um Mods auszuschalten, wählen Sie, wie viele Sie stoppen möchten und für wie lange. Um sie wieder einzuschalten, machen Sie dieselbe Änderung rückgängig:

  • 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": true in ~/.claude/settings.json. Ihre Einstellungs-Hooks und Ihre benutzerdefinierte Statuszeile werden ebenfalls gestoppt. Was Ihre Organisation verwaltet, läuft weiter.

Wenn Sie Claude Code über eine Organisation nutzen, kann ein Administrator zusätzlich einschränken, welche Mods geladen werden. Administratoren beginnen bei Vom Benutzer installierte Mods am Laden hindern.

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.

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:

first-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js
  • plugin.json: das Manifest des Plugins
  • hooks.json: verweist auf Ihre Code-Datei
  • register.js: Ihr Code, das sogenannte Hooks-Modul. Es teilt Claude Code mit, bei welchen Ereignissen Ihre Funktionen ausgeführt werden sollen.

Dies ist eine vollständige 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….

// The count, shared by the two hooks below
let calls = 0

// Claude Code calls this once when the mod loads
export function register(on) {
  // Runs each time Claude is about to use a tool
  on('tool.call', async ($, e, next) => {
    calls += 1
    // Ask Claude Code to draw the interface again, so the new count shows
    $.ui.invalidate('ui.render')
    // Let the tool run as usual
    return next(e)
  })

  // Runs each time Claude Code draws the spinner
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    // Keep Claude Code's spinner, with the count added after its word
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

Die Datei registriert zwei Hooks, und beide verwenden die Variable calls am Anfang:

  • Der tool.call-Hook wird jedes Mal ausgeführt, wenn Claude kurz davor ist, ein Tool zu verwenden. Er erhöht calls um 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.

Diese Aufnahme zeigt den Mod in Aktion. Achten Sie auf die Spinner-Zeile über dem Eingabefeld: Während Claude ein Verzeichnis auflistet und zwei Dateien liest, zeigt sie Thinking · tool calls: 1…, dann 2…, dann 3….