SpyBara
Go Premium

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

This page contains 62 additions and 42 deletions.

2026
Thu 1 23:59 Fri 2 10:59

Mods – Übersicht

Fügen Sie Bereiche, Befehle und Tool-Call-Regeln zu Claude Code mit einem Mod hinzu. Sehen Sie, was ein Mod kann, wie Sie einen erstellen oder installieren, und wo Mods ausgeführt werden.

Ein Mod ist ein Plugin, das ändert, wie Claude Code aussieht und sich verhält. Er besteht aus JavaScript- oder TypeScript-Event-Handlern: Claude Code ruft einen auf, wenn ein Ereignis eintritt, z. B. ein Tool-Call, eine eingereichte Eingabeaufforderung oder ein Teil der Benutzeroberfläche wird gezeichnet, und der Handler kann das Ereignis beobachten, ändern oder übernehmen. Verwenden Sie einen Mod, um Claude Code eine eigene Funktion hinzuzufügen, z. B. einen Bereich, der nach jeder Anfrage anzeigt, wie voll Ihr Kontext ist. Für die Dateien in einem Mod und ein vollständiges Beispiel siehe Wie ein Mod funktioniert.

Was ein Mod kann

Settings-Hooks, Skills, Statuszeilen und MCP-Server funktionieren außerhalb von Claude Code: Jeder führt ein Skript aus oder gibt Claude Text oder Tools. Ein Mod wird in Claude Code ausgeführt, daher kann er Dinge tun, die sie nicht können:

  • Eine Benutzeroberfläche zeichnen, die Sie verwenden können: ein Bereich neben dem Transkript oder ein Band über der Eingabeaufforderung mit Registerkarten, Schaltflächen und Textfeldern. Siehe In der Benutzeroberfläche zeichnen.
  • Claude Codes eigene Benutzeroberfläche neu zeichnen: Ersetzen oder gestalten Sie Teile neu, die Claude Code selbst zeichnet, z. B. die Zeile eines Tool-Calls, den Spinner oder den Dialog, in dem Claude Fragen stellt. Siehe Ändern Sie, was Claude Code bereits zeichnet.
  • In einen Tool-Call oder eine Anfrage einsteigen: Halten Sie beispielsweise einen Tool-Call an, während Sie den Benutzer eine Frage stellen, beantworten Sie ihn, ohne das Tool auszuführen, oder senden Sie eine Anfrage an ein anderes Modell. Siehe Einen Tool-Call schützen oder ändern und Einem Zug folgen.
  • Ihren eigenen Code auf einem Befehl ausführen: ein /command, der Ihre Funktion sofort ausführt, ohne Claude-Zug, auch während Claude arbeitet. Siehe Einen Befehl oder ein Tool hinzufügen.
  • Daten zwischen Hooks teilen: Die Hooks eines Mods teilen die Variablen in seiner Datei, daher kann ein anderer Hook zeigen, was ein Hook aufzeichnet. Beispielsweise kann ein Hook Tool-Calls zählen, während ein anderer die Anzahl neben dem Spinner anzeigt, oder einer kann die Token-Nutzung jeder Anfrage lesen, während ein anderer sie in einem Bereich darstellt. Siehe Auf Ereignisse reagieren.

Mods funktionieren in der Claude Code CLI und auf der Registerkarte „Code" der Claude Desktop-App. Siehe Wo Mods ausgeführt werden, um zu verstehen, wie sie sich an anderen Orten verhalten, z. B. in der VS Code-Erweiterung, claude -p und Cloud-Sitzungen. Wenn ein Settings-Hook, ein Skill oder ein MCP-Server bereits das tut, was Sie benötigen, vergleichen Sie sie, bevor Sie einen Mod schreiben. Um Mods für eine Organisation zu verwalten, siehe Mods für Ihre Organisation verwalten.

Einen Mod abrufen

So beginnen Sie mit einem Mod:

Einen Mod installieren oder aktualisieren

Ein Mod wird als Plugin von einem Marketplace installiert. Geben Sie den Namen des Plugins, ein @ und den Namen des Marketplace an. Diese Beispiele installieren ein Plugin namens token-chart von 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 Plugins aktuell halten, die alle unverändert für ein Plugin gelten, das einen Mod enthält.

Wenn Sie einen Mod von Ihrer Shell aus installieren oder aktualisieren, während eine Sitzung offen ist, führen Sie /reload-plugins in dieser Sitzung 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 unverändert und ohne Support bereit.

  • token-weather: zeichnet eine Vorhersage Ihres Kontextfensters oberhalb des Prompts
  • 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 Dateibearbeitungen geht, die Claude im letzten Turn vorgenommen hat

Ein Beispiel-Mod wird mit Ihren Berechtigungen ausgeführt. Um zu sehen, was ein Mod tut, bevor Sie ihn laden, 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 Ihres Klons als Marketplace hinzu und installieren Sie den Mod dann aus claude-code-playground-mods. Der Marketplace verweist auf Ihren Klon, sodass der Mod nicht mehr geladen wird, wenn Sie den Klon verschieben oder löschen.

Entscheiden Sie, ob Sie einem Mod vertrauen

Ein Mod ist Code, der mit Ihren Berechtigungen in Claude Code ausgeführt wird. Installieren Sie Mods nur von Autoren und Marketplaces, denen Sie vertrauen.

Was ein Mod erreichen kann

Ein Mod wird mit Ihren Berechtigungen ausgeführt, daher sollten Sie vor der Installation wissen, worauf er Zugriff hat. Nach dem Laden kann ein Mod:

  • Auf Ihrem Computer als Sie handeln: Dateien überall dort lesen und schreiben, wo Ihr Benutzerkonto kann, Programme starten und Netzwerkanfragen stellen
  • Ihre Geheimnisse lesen: Umgebungsvariablen und Einstellungsdateien, einschließlich eines API-Schlüssels, den Sie in einem von beiden aufbewahren
  • Ihre Sitzung sehen: jeden Prompt, den Sie senden, und jeden Tool-Aufruf, den Claude macht
  • Ihre Sitzung ändern: einen Prompt oder einen Tool-Aufruf umschreiben, einen Prompt absenden, als hätten Sie ihn eingegeben, oder eine Nachricht an eine andere Ihrer Sitzungen senden
  • Ohne Sie zu fragen handeln: einen Tool-Aufruf genehmigen, bevor Sie gefragt werden
  • Ihre Nutzung 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, und ein Prozess, den ein Mod startet, läuft außerhalb davon.

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 wann er einen Aufruf genehmigen kann, den eine deny-Regel ablehnt.

Ein Mod kann einen Großteil der Claude Code-Benutzeroberfläche umgestalten, aber nicht die Berechtigungsabfrage. Er kann nicht ändern, was Ihnen eine Abfrage anzeigt.

Auflisten, was ein Mod tut, bevor Sie ihn installieren

Bevor Sie einen Mod installieren, können Sie auflisten, welche Ereignisse er verarbeitet und was er Claude Code auffordert zu tun, z. B. eine Datei zu lesen oder eine Netzwerkanfrage zu stellen, ohne ihn auszuführen. Rufen Sie zuerst die Plugin-Dateien ab, z. B. durch Klonen des Repositorys. Führen Sie dann in Ihrer Shell claude plugin validate im Verzeichnis des Plugins aus:

claude plugin validate ./some-mod

Die Zeilen hooks: und calls: in der Ausgabe listen die Ereignisse auf, die der Mod verarbeitet, und was er Claude Code auffordert zu tun. Überprüfen Sie, was ein Mod tun kann zeigt die Ausgabe und nach welchen Aufrufen Sie suchen sollten.

Mods ein- oder ausschalten

Mods erfordern Claude Code v2.1.287 oder höher und sind standardmäßig eingeschaltet. 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, legen Sie fest, 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 Hooks aus den Einstellungen 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 außerdem einschränken, welche Mods geladen werden. Administratoren beginnen bei Laden von benutzerinstallierten Mods verhindern.

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 führen auf, was jede davon mit einem Plugin und seinen Hooks aus den Einstellungen 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, sogenannte Hooks. Claude Code führt einen Hook aus, wenn sein Ereignis eintritt, z. B. wenn Claude ein Tool aufruft oder der Spinner gezeichnet wird. Ein kleiner Mod hat drei Dateien:

first-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

Dies ist ein vollständiges register.js. Es zählt die Tool-Aufrufe, die Claude macht, und zeigt die Anzahl neben dem Spinner an, während Claude arbeitet, wie in 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 calls-Variable oben:

  • Der tool.call-Hook wird jedes Mal ausgeführt, wenn Claude ein Tool verwenden möchte. Er addiert eins zu calls, fordert Claude Code auf, die Benutzeroberfläche erneut zu zeichnen, und lässt das Tool wie gewohnt ausführen.
  • Der ui.render-Hook wird jedes Mal ausgeführt, wenn Claude Code den Spinner zeichnet. Er behält Claude Codes eigenen Spinner und fügt die Anzahl nach dem Wort hinzu.

Diese Aufzeichnung zeigt den Mod in Aktion. Beobachten Sie 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….