- Eigene Mods der Benutzer ausschließen, mit oder ohne eigene Mods: Das Laden von Mods verhindern, die von Benutzern installiert wurden
- Sehen, was Ihre Benutzer erhalten, wenn Sie nichts ändern: Das Standardverhalten kennen
- Mods mit anderen Einschränkungen aktiviert lassen: Festlegen, wie viel erlaubt ist
Diese Fälle werden auf anderen Seiten behandelt:
- Sie haben noch nie verwaltete Einstellungen bereitgestellt: Beginnen Sie mit Verwaltete Einstellungen bereitstellen
- Sie möchten steuern, welche Plugins Benutzer installieren können: Siehe Plugins für Ihre Organisation verwalten
Verhindern, dass von Benutzern installierte Mods geladen werden
Um zu verhindern, dass Mods, die Ihre Benutzer mitbringen, ihre Hooks ausführen, setzen Sie die OptionallowManagedModsOnly für den integrierten Wächter, einen Richtlinien-Mod, den Claude Code vor jedem von einem Benutzer installierten Mod lädt. Die Option gehört in die verwalteten Einstellungen unter pluginConfigs, mit dem Schlüssel cc-plugin-sec-default@builtin:
managed-settings.json
- Kein Mod, den ein Benutzer mitbringt, führt seine Hooks aus: Das umfasst einen Mod in einem Plugin, das der Benutzer installiert hat, einen mit
--plugin-dirgeladenen Mod und einen Mod, den Claude während einer Sitzung geschrieben hat - Die Mods Ihrer Organisation laufen weiterhin: Ein Mod, der als Mod Ihrer Organisation gilt, wird nicht geprüft. Jeder andere Mod gilt als Mod eines Benutzers und wird abgelehnt. Dazu gehört auch ein Mod, den Ihre Organisation auf claude.ai für ihre Mitglieder aktiviert. Wenn keiner als Ihrer gilt, führt kein installierter Mod seine Hooks aus.
- Benutzer können dies nicht rückgängig machen: Der Wächter liest die Option nur aus den verwalteten Einstellungen, sodass derselbe Eintrag in einer Benutzer-, Projekt- oder lokalen Einstellungsdatei oder in einer mit
--settingsübergebenen Datei nichts ändert - Eine Datei- oder MDM-Richtlinie gilt für jeden Anbieter: Wenn Sie die Option als Datei oder über MDM bereitstellen, funktioniert sie auf Amazon Bedrock, Google Clouds Agent Platform und Microsoft Foundry auf die gleiche Weise. Informationen zur Bereitstellung über die Admin-Konsole von claude.ai finden Sie unter Plattformverfügbarkeit
- Andere Anpassungen der Benutzer funktionieren weiterhin: Ihre Hooks in Einstellungsdateien und in der
hooks/hooks.jsonvon Plugins, Statuszeilen und/goalsind nicht betroffen - Integrierte Mods laufen weiterhin: In Claude Code integrierte Mods, wie die Unterstützung für
AGENTS.md, haben jeweils einen eigenen Schalter
--plugin-dir und dem Pfad eines Verzeichnisses, das einen Mod enthält, zum Beispiel claude --plugin-dir ./first-mod. Die Hooks des Mods werden nicht ausgeführt, und das Transkript sowie das Debug-Log enthalten die Meldung des Wächters, die den Mod und allowManagedModsOnly nennt. Wenn die Meldung fehlt, lesen Sie Prüfen, ob eine Richtlinie in Kraft ist und die Regeln, die bestimmen, ob eine Option wirksam wird.
Wenn Sie während des Early Access CLAUDE_CODE_ENABLE_FUNCTION_HOOKS auf 0 gesetzt haben, ersetzen Sie dies durch diese Option. Claude Code v2.1.287 und neuer ignoriert die Variable unabhängig von ihrem Wert, sodass eine 0 dort Mods aktiviert lässt.
Wissen, was standardmäßig geschieht
Ohne eigene Mod-Einstellungen erhalten Ihre Benutzer Folgendes:-
Mods sind aktiviert. Ein Benutzer kann ein Plugin, das einen Mod enthält, aus jedem Marketplace installieren, den Ihre Plugin-Einstellungen zulassen, oder einen Mod mit
--plugin-diraus einem Verzeichnis laden. -
Ein integrierter Wächter läuft zuerst. Claude Code lädt einen integrierten Mod namens
sec-default@builtinvor jedem Mod, den ein Benutzer installiert. Benutzer können ihn nicht ausschalten./pluginund das Debug-Log führen ihn alscc-plugin-sec-default. Der Wächter wird geladen, wenn eine der folgenden Bedingungen zutrifft:- Der Rechner verfügt über verwaltete Einstellungen oder eine
managed-mcp.json-Datei - Die Sitzung läuft mit
/login-Anmeldedaten für einen Team- oder Enterprise-Plan
managed-mcp.json. Auch eine Sitzung, die mit einem langlebigenCLAUDE_CODE_OAUTH_TOKENläuft, zählt nicht als diese Anmeldung, selbst wenn auf dem Rechner eine Team- oder Enterprise-Anmeldung gespeichert ist. - Der Rechner verfügt über verwaltete Einstellungen oder eine
-
Der Wächter schützt, was Sie verwalten. Der Mod eines Benutzers kann nicht ändern, was Ihre verwalteten Hooks erhalten oder entscheiden, und auch nicht den System-Prompt oder Ihre verwaltete
CLAUDE.mdund andere verwaltete Anweisungen. Er kann außerdem nicht ändern, was ein Mod als Einstellungen liest, oder die Tools und Beschreibungen Ihrer verwalteten MCP-Server, sobald diese verbunden sind. -
Ab v2.1.323 kann der Mod eines Benutzers verhindern, dass ein verwalteter MCP-Server eine Verbindung herstellt. In der Sitzung dieses Benutzers führt
/mcpden Server als von diesem Mod zurückgehalten auf. Um das zu unterbinden, verhindern Sie, dass von Benutzern installierte Mods geladen werden. - Außerhalb dessen, was Sie verwalten, handelt der Mod eines Benutzers als dieser Benutzer. Der Mod behält die Berechtigungen dieses Benutzers: Er kann weiterhin Dateien lesen und schreiben, Prozesse starten und Netzwerkanfragen stellen. Er kann außerdem Tool-Aufrufe und Prompts umschreiben, einen Tool-Aufruf ablehnen, Tools hinzufügen oder entfernen und in der Oberfläche zeichnen.
-
Berechtigungsregeln und
PreToolUse-Hooks haben Vorrang vor dem Mod eines Benutzers. Wenn der Wächter geladen ist, kann der Mod eines Benutzers standardmäßig keinen Aufruf genehmigen, den einedeny-Regel ablehnt oder für den eineask-Regel nachfragt, unabhängig davon, in welcher Einstellungsdatei die Regel steht. Der Mod kann auch keinen Aufruf genehmigen, den einPreToolUse-Hook blockiert hat. Berechtigungsregeln undPreToolUse-Hooks gelten für die Tool-Aufrufe von Claude, nicht für die$.fs- und$.process-Aufrufe eines Mods. WennRead(.env)abgelehnt ist, kann ein Mod diese Datei trotzdem mit$.fs.readlesen oder ein Programm starten, das dies tut. Um die eigenen$.fs- und$.process-Aufrufe eines Mods einzuschränken, verhindern Sie, dass der Mod geladen wird, oder behandeln Sie sie in einem Richtlinien-Mod. -
Der Mod eines Benutzers kann dennoch einige Berechtigungsabfragen überspringen. Im Auto-Modus wird ein vom Mod genehmigter Aufruf ohne Prüfung durch den Klassifikator ausgeführt, es sei denn, der Wächter ist geladen und die Sitzung läuft mit
--permission-prompt-tooloder einemcanUseTool-Callback des Agent SDK. Dann prüft der Klassifikator den Aufruf zuerst. Welche Berechtigungsabfragen die Genehmigung eines Mods nicht überspringt, erfahren Sie unter Berechtigungen mit Hooks erweitern.
mods/sec-default des Claude Code-Repositorys verfügbar.
Wissen, welche Kontrollen weiterhin gelten
Mods ersetzen die Kontrollen, die Sie bereits haben, nicht:-
Einstellungs-Hooks funktionieren weiterhin. Command-, HTTP-, Prompt- und Agent-Hooks in Einstellungsdateien und in
hooks/hooks.jsonvon Plugins laufen wie bisher, parallel zu Mods. -
Deny-Regeln haben Vorrang, wo der Wächter geladen wird. Der Mod eines Benutzers kann keinen Aufruf genehmigen, den eine
deny-Regel ablehnt, es sei denn, Sie setzenallowModsToOverrideDenyRules. -
Verwaltete Hooks laufen zuerst. Ein
PreToolUse-Hook in verwalteten Einstellungen läuft vor demtool.call-Hook eines jeden Mods, und wenn dieser verwaltete Hook einen Tool-Aufruf blockiert, läuft für diesen Aufruf keintool.call-Hook eines Mods. Wenn der Aufruf fortgesetzt wird und ein Mod ihn umschreibt, laufen Ihre verwalteten Hooks erneut für den umgeschriebenen Aufruf, sodass sie ihn standardmäßig weiterhin blockieren können.PreToolUse-Hooks aus anderen Einstellungsdateien und aus Plugins laufen nach dem letzten Mod. Wenn ein Mod den Tool-Aufruf selbst beantwortet, wird das Tool nie ausgeführt, und diese Hooks laufen ebenfalls nicht. Siehe Die Reihenfolge, in der Mods laufen. -
Die Netzwerkrichtlinie gilt für
$.http.fetch.-
Die Richtlinie Ihrer Organisation lässt WebFetch nicht zu: Claude Code lehnt auch jede
$.http.fetch-Anfrage jedes Mods ab. Siehe Verfügbarkeit von WebFetch. -
Sie schalten das WebFetch-Tool mit
CLAUDE_CODE_DISABLE_WEB_FETCHoder einerWebFetch-Deny-Regel aus, in verwalteten Einstellungen oder einer anderen Einstellungsdatei: Mods können weiterhin$.http.fetch-Anfragen stellen. Um diese Anfragen für jeden Mod zu stoppen, den Ihre Benutzer installieren, verhindern Sie, dass von Benutzern installierte Mods geladen werden, oder hooken Siehttp.fetchin einem Richtlinien-Mod und lehnen Sie Anfragen aus den Mods Ihrer Benutzer ab. Geben Sie diesem Hook einen.catch-Handler, der ebenfalls ablehnt, denn Claude Code überspringt einen fehlschlagenden Hook, und die Anfrage wird dann trotzdem ausgeführt. Wenn Sie nur einschränken, welche Plugins Benutzer installieren können, werden weniger Mods geladen, aber die von Ihnen zugelassenen stellen diese Anfragen weiterhin. -
Sie setzen
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: Ein Mod, den Sie oder Ihre Benutzer installieren, kann diese Anfragen weiterhin stellen. Die Variable stoppt nur die in Claude Code integrierten Mods sowie jede$.http.fetch-Anfrage, die die Anthropic-Anmeldedaten der Sitzung mitführt. Vor v2.1.288 stoppte die Variable jede$.http.fetch-Anfrage jedes Mods.
$.process.runstartet. Dieses Programm greift mit dem eigenen Zugriff des Benutzers auf das Netzwerk zu. -
Die Richtlinie Ihrer Organisation lässt WebFetch nicht zu: Claude Code lehnt auch jede
-
Plugin-Kontrollen gelten für Mods. Ein Mod ist ein Plugin, daher entscheiden die Einstellungen, die einschränken, was Benutzer installieren können, etwa
strictKnownMarketplaces, ob er überhaupt installiert werden kann. - Mods können die Berechtigungsabfrage nicht ändern. Ein Mod kann einen Großteil der Oberfläche von Claude Code umgestalten, aber nicht die Berechtigungsabfrage, sodass er nicht ändern kann, was eine Abfrage anzeigt. Ein Mod kann einen Tool-Aufruf dennoch genehmigen oder ablehnen, bevor die Abfrage erscheint, wie unter Wissen, was standardmäßig geschieht beschrieben.
- Vertrauensabfragen kommen zuerst. In einer interaktiven Sitzung in einem Verzeichnis, dem der Benutzer noch nicht vertraut hat, wird kein Mod geladen, bis er die Vertrauensabfrage beantwortet.
-
--safe-modeschaltet installierte Mods aus, auch Ihre. Starten Sie eine Sitzung mitclaude --safe-mode, um zu prüfen, ob ein Mod ein Problem verursacht hat.
Wissen, welche Hooks des Mods eines Benutzers nicht laufen
Wo der integrierte Wächter geladen wird, läuft ein Hook, den der Mod eines Benutzers für eines dieser Ereignisse registriert, nie, und/plugin weist diesen Benutzer in einem Hinweis darauf hin. In den session.append-Zeilen ist door die Art der gespeicherten Zeile, auf die der Hook gefiltert ist.
Der Wächter übergeht die Hooks eines Benutzers auch in einigen anderen Fällen, etwa bei den Beschreibungen der Tools Ihrer Organisation auf
tool.describe und bei der gespeicherten Zeile für den Text eines Skills. Für diese zeigt /plugin keinen Hinweis an. Wenn ein Hook auf einem anderen Ereignis nichts bewirkt, siehe Herausfinden, warum ein Mod nichts bewirkt.
Der Hinweis erscheint in den Details des Plugins und auf dem Tab Errors von /plugin. Er erfordert Claude Code v2.1.299 oder höher. Er nennt jeden Hook aus der Tabelle so, wie der Mod ihn registriert hat, wie in diesem Beispiel:
- Den Mod als Mod Ihrer Organisation ausführen: Installieren Sie den Mod so, dass er als Ihrer zählt. Seine Hooks auf diesen Ereignissen laufen dann, und der Wächter bleibt für jeden anderen Mod geladen. Der Mod wird für alle aktiviert, die diese Einstellungen erhalten. Wenn Sie ihn in
prependPluginsaufführen, behalten Siesec-default@builtinin der Liste. - Den Wächter entfernen: Lassen Sie
sec-default@builtininprependPluginsweg. Eine leere Liste,"prependPlugins": [], genügt. Sie verlieren den gesamten Wächter, nicht nur diese Ereignisse. Der Mod eines Benutzers kann dann tun, was der Wächter sonst verhindert, und die Optionen des Wächters gelten nicht.
/plugin und prüfen Sie, ob der Hinweis verschwunden ist.
Ein session.append-Hook ohne door-Filter läuft weiterhin und erhält keinen Hinweis, aber die gespeicherten Zeilen aus der Tabelle erreichen ihn nicht.
Entscheiden, ob Mods aktiviert bleiben sollen
Ein Mod kann mehr als die anderen Bestandteile eines Plugins, weil er innerhalb von Claude Code ausgeführt wird. Er sieht jeden Prompt und jeden Tool-Aufruf, kann diese ändern und kann einen Tool-Aufruf erlauben oder ablehnen, bevor eine Berechtigungsabfrage erscheint. Was ein Benutzer als Mod laden kann, hängt von den Plugin-Steuerungen ab, die Sie bereits eingerichtet haben:
Plugins für Ihre Organisation verwalten listet die Wege auf, auf denen ein Plugin geladen wird, sowie die Einstellung, die jeden davon steuert.
Um die Mods in einem Marketplace zu prüfen, bevor Ihre Benutzer sie installieren, lesen Sie Prüfen, was ein Mod tun kann. Um von Benutzern installierte Mods fernzuhalten, bis Sie dies getan haben, lesen Sie Von Benutzern installierte Mods am Laden hindern.
Prüfen, was ein Mod tun kann
Sie können sehen, was ein Mod tun kann, ohne ihn auszuführen. Führen Sie in Ihrer Shellclaude plugin validate für das Verzeichnis des Plugins aus:
hooks: und calls: in der Ausgabe beschreiben den Code des Mods:
hooks:: die Events, die der Mod empfängt. Ein Hinweisdefault matcher key: pluginbedeutet, dass der Hook davor die Steuerelemente und Zeichnungen anderer Mods überspringt.calls:: die Methoden der Mods-API, die sein Code aufruft
$ geschrieben, greift ein Mod auf Dateien, Prozesse und das Netzwerk zu. Claude Code verweigert das Laden eines Mods, der die Mods-API auf eine Weise verwendet, die dieser Befehl nicht auslesen kann.
Genehmigen Sie keinen Mod, bei dem dieser Befehl fehlschlägt, denn manche Fehler verhindern nicht, dass er geladen wird. Führen Sie den Befehl mit Claude Code v2.1.323 oder neuer aus, wo eine lange Liste in weiteren Zeilen mit derselben Bezeichnung fortgesetzt wird, und lesen Sie jede Zeile hooks: und calls:. Achten Sie in den Zeilen calls: auf Folgendes:
In der Zeile
hooks: bedeuten tool.call und prompt.submit, dass der Mod jeden Tool-Aufruf und jeden Prompt sieht und diese ändern kann. session.append bedeutet, dass der Mod jede Zeile der Konversation umschreiben kann, bevor sie gespeichert wird, abgesehen von den Zeilen, die der Guard überspringt. ui.render{component=AskUserQuestion} bedeutet, dass der Mod den Dialog neu zeichnen kann, mit dem Claude dem Benutzer eine Frage stellt. tool.check bedeutet, dass der Mod einen Tool-Aufruf genehmigen oder ablehnen kann, bevor eine Berechtigungsabfrage erscheint. Wissen, was standardmäßig passiert listet auf, welche Ihrer Regeln und Hooks Vorrang vor seiner Antwort haben.
Festlegen, wie viel erlaubt ist
Mod-Richtlinien reichen von gar keinen installierten Mods bis zu jedem Mod, den ein Benutzer wählt, wobei Ihr eigener Mod die anderen prüft, und jede davon besteht aus einigen verwalteten Einstellungen. Suchen Sie die gewünschte Richtlinie in der ersten Spalte und setzen Sie, was die zweite Spalte nennt. Verwaltete Einstellungen bereitstellen beschreibt, wo verwaltete Einstellungen liegen.
Was jede Einstellung bewirkt:
allowManagedModsOnly: eine Option des integrierten Wächters. Claude Code lehnt die eigenen Mods der Benutzer ab, sodass keiner ihrer Hooks ausgeführt wird. Die Einstellungs-Hooks, Statuszeilen und/goalder Benutzer funktionieren weiterhin. Vom Benutzer installierte Mods am Laden hindern führt auf, was sie abdeckt.allowManagedHooksOnly: eine umfassendere Einstellung. Nur die Mods Ihrer Organisation und die in Claude Code integrierten Mods werden geladen. Ein Mod, den ein Benutzer selbst installiert hat, wird nicht geladen. Die Einstellung blockiert außerdem Hooks in den eigenen Einstellungsdateien der Benutzer. Lesen Sie Was unterallowManagedHooksOnlyausgeführt wird, bevor Sie sie setzen.disableAllHooks: die umfassendste Einstellung. In verwalteten Einstellungen stoppt sie die Mods in jedem installierten Plugin, einschließlich Ihrer eigenen, und schaltet jeden Hook in Einstellungsdateien aus, sodass einPreToolUse-Hook in Ihren verwalteten Einstellungen nichts mehr blockiert. Benutzerdefinierte Statuszeilen und/goalfunktionieren ebenfalls nicht mehr. Lesen SiedisableAllHooks, bevor Sie sie setzen.disableSideloadFlags: lehnt--plugin-dirund--plugin-urlbeim Start ab und verhindert, dass Mods geladen werden, die Claude während einer Sitzung schreibt. Die Einstellung lehnt außerdem--agentsund--mcp-configab. Lesen SiedisableSideloadFlags, bevor Sie sie setzen.
AGENTS.md, sind von diesen Einstellungen nicht betroffen. Jeder davon hat einen eigenen Schalter.
Ein Benutzer, dessen Mod abgelehnt oder nicht geladen wurde, findet den Grund in seinem Debug-Log. Ablehnungsmeldungen führt die Zeilen für allowManagedHooksOnly und disableAllHooks auf, und Meldungen des integrierten Wächters enthält die Zeile für allowManagedModsOnly.
Nur die Mods Ihrer Organisation zulassen
Um die Mods Ihrer Organisation auszuführen und die von Benutzern mitgebrachten zu blockieren, stellen Sie die Einstellungen aus der Zeile Nur die Mods Ihrer Organisation der Richtlinientabelle sowiedisableSideloadFlags bereit. Mit dieser vollständigen managed-settings.json lehnt Claude Code die eigenen Mods der Benutzer ab, sodass keiner ihrer Hooks ausgeführt wird, und Ihr Richtlinien-Mod wird vor anderen Mods ausgeführt:
managed-settings.json
extraKnownMarketplaces,enabledPluginsundprependPlugins: installieren Ihren Mod so, dass er als Ihrer gilt, und führen ihn zuerst aus, mit dem Wächter danach. Die Mods Ihrer Organisation installieren und die Reihenfolge festlegen beschreibt das Verzeichnis, auf das diese Schlüssel verweisen.pluginConfigs: setzt die OptionallowManagedModsOnlydes Wächters, sodass Claude Code die eigenen Mods der Benutzer ablehnt. Ihre Einstellungs-Hooks, Statuszeilen und/goalfunktionieren weiterhin.disableSideloadFlags: siehedisableSideloadFlagsfür die Flags, die sie beim Start ablehnt
claude --debug und lesen Sie das Debug-Log:
- Ihr Mod: Seine Zeile
hooks moduleenthälttier prepend - Ein vom Benutzer installierter Mod: Eine Zeile lautet
refused by cc-plugin-sec-default: mods are limited to your organization's by policy (allowManagedModsOnly). Eine frühere Zeile besagt, dass das Hooks-Modul dieses Modsloadedwurde, suchen Sie also nach der Ablehnung. - Ein Plugin-Verzeichnis:
claude --plugin-dir ./any-modwird mit einer Meldung beendet, die mit--plugin-dir is disabled by your organization's managed settings (disableSideloadFlags)beginnt
Ihre Plugin-Steuerungen auf Mods anwenden
Ein Mod ist ein Plugin, daher gelten die Möglichkeiten, mit denen Sie Plugins für Ihre Organisation verwalten, auch für ein Plugin, das einen Mod enthält:- Sehen, welche Plugins in Ihrer gesamten Flotte geladen werden: Prüfen und überprüfen
- Entscheiden, wann ein von Ihnen geprüftes Plugin aktualisiert werden darf: Update-Richtlinie festlegen
- Einer Gruppe eine andere Richtlinie geben, etwa für ein Pilotprojekt: Planen, was verwaltete Einstellungen nicht durchsetzen können
- Prüfen, welche Apps und Sitzungsarten die Plugin-Schlüssel anwenden: Wann jede Oberfläche die Plugin-Schlüssel anwendet
- CI und Container einrichten: Container und CI vorbereiten
- Mods anbieten, die Ihre Benutzer installieren dürfen: Einen Marketplace hosten. Ein Mod, den Claude Code aus einer GitHub-, Git-, URL- oder npm-Quelle kopiert, gilt als Mod eines Benutzers, es sei denn, Sie installieren ihn als Mod Ihrer Organisation.
Optionen für den integrierten Wächter festlegen
Der integrierte Wächter akzeptiert Optionen. Setzen Sie diese in verwalteten Einstellungen unterpluginConfigs mit dem Schlüssel cc-plugin-sec-default@builtin, wie es das Beispiel in Vom Benutzer installierte Mods am Laden hindern tut.
Die Tabelle zeigt, was Ihre Benutzer erhalten, wenn die jeweilige Option nicht gesetzt ist und wenn sie auf true gesetzt ist:
Diese Regeln entscheiden, ob eine Option wirksam wird:
- Die ID hat hier eine Form: Claude Code liest die Optionen nur unter
cc-plugin-sec-default@builtin.prependPluginsakzeptiert auchsec-default@builtin,pluginConfigsdagegen nicht. - Nur verwaltete Einstellungen zählen: Derselbe Eintrag in einer Benutzer-, Projekt- oder lokalen Einstellungsdatei oder in einer mit
--settingsübergebenen Datei setzt weder eine Option noch lockert er eine - Der Wächter muss geladen werden: Wenn Sie
prependPluginssetzen, führen Sie den Wächter in der Liste auf. Wo der Wächter nicht geladen wird, gilt keine der beiden Optionen. - Der Wächter schlägt sicher fehl: Wenn der Wächter die verwalteten Einstellungen nicht lesen kann, lehnt er beim Laden jeden Mod eines Benutzers ab. Wenn er die Deny-Regeln für einen Aufruf, den ein Mod eines Benutzers genehmigt hat, nicht prüfen kann, lehnt er den Aufruf ab.
Eigene Mods Ihrer Organisation ausführen
Sie können eigene Mods für alle Benutzer bereitstellen, festlegen, wo sie relativ zu den Mods der Benutzer ausgeführt werden, und einen Mod verwenden, um eine Richtlinie durchzusetzen.Mods Ihrer Organisation installieren und die Reihenfolge festlegen
Die Mods Ihrer Organisation werden auch dort geladen, wo Mods von Benutzern nicht geladen werden, und können vor diesen ausgeführt werden. Daher muss Claude Code erkennen können, dass ein Mod von Ihnen stammt. Damit ein Mod aus einem Remote-Marketplace, etwa einem GitHub-Repository, ab v2.1.324 als Ihrer gilt, führen Sie alle folgenden Schritte in verwalteten Einstellungen aus:- Setzen Sie das Plugin des Mods in
enabledPluginsauftrue - Deklarieren Sie den Marketplace in
extraKnownMarketplaces. Um zu steuern, wann sich der Code des Mods ändert, pinnen Sie den Marketplace und den Eintrag des Mods. - Führen Sie die ID des Mods, etwa
acme-guard@acme-tools, inprependPluginsoderappendPluginsauf. Führen Sie beiprependPluginsaußerdemsec-default@builtinauf, um den integrierten Wächter beizubehalten.
- Das verwaltete
enabledPluginssetzt das Plugin des Mods auftrue - Die verwalteten Einstellungen benennen den Marketplace des Plugins als Verzeichnis auf dem Rechner des Benutzers, und zwar über einen absoluten Pfad. Ein Eintrag in
extraKnownMarketplacesleistet das und registriert den Marketplace zusätzlich für den Benutzer. - Der Marketplace führt das Plugin über einen relativen Pfad auf, sodass Claude Code es direkt an Ort und Stelle lädt, und zwar aus diesem Verzeichnis
/opt/acme/claude-plugins/.claude-plugin/marketplace.json
enabledPlugins es aktiviert. Sein Mod wird zusammen mit den Mods der Benutzer ausgeführt, prependPlugins und appendPlugins überspringen ihn, allowManagedModsOnly lehnt ihn ab, und allowManagedHooksOnly verhindert, dass er geladen wird. Wenn verwaltete Einstellungen es aktivieren, enthält das Debug-Log des Benutzers eine Zeile, die mit der ID des Plugins und is enabled by managed settings, but beginnt.
Claude Code löst jedes Mal ein Ereignis aus, wenn es im Begriff ist, eine Aktion auszuführen, etwa ein Tool auszuführen, und übergibt es nacheinander an jeden Mod. Ein Mod, der die Verzeichnisbedingungen erfüllt, wird vor den Mods der Benutzer ausgeführt, auch wenn Sie ihn nirgends aufführen. Um seine Position festzulegen, führen Sie seine ID in einer von zwei Einstellungen auf. Die ID besteht aus dem Namen des Plugins, @ und dem Namen des Marketplace, etwa acme-guard@acme-tools.
prependPlugins: Ihr Mod sieht jedes Ereignis vor jedem Mod eines Benutzers und jedes Ergebnis danach. Er kann das Ereignis ändern, es ablehnen oder die Mods der Benutzer überspringen. Prüfen Sie ab v2.1.323, ob Ihre Hooks weiterhin die Steuerelemente und Zeichnungen anderer Mods erreichen.appendPlugins: Ihr Mod wird nach jedem Mod eines Benutzers ausgeführt und sieht daher nur die Ereignisse, die diese Mods weitergeben, und zwar in der Form, in der sie sie weitergeben
acme-tools unter /opt/acme/claude-plugins, aktiviert daraus acme-guard und führt diesen Mod zuerst aus, gefolgt vom integrierten Wächter:
managed-settings.json
extraKnownMarketplaces: benennt das Verzeichnis, das den Marketplaceacme-toolsenthält.pathist der absolute Pfad des Verzeichnisses, das.claude-plugin/marketplace.jsonenthält.enabledPlugins: aktiviertacme-guardfür jeden Benutzer, der diese verwalteten Einstellungen erhältprependPlugins: stelltacme-guardan die erste und den integrierten Wächter an die zweite Stelle, beide vor jedem Mod, den ein Benutzer installiert. Claude Code hält sich an die Reihenfolge, die Sie angeben.
claude --debug und durchsuchen Sie das Debug-Log nach der ID des Mods:
hooks module acme-guard@acme-tools loaded, mittier prepend: Der Mod gilt als Mod Ihrer Organisation und wird zuerst ausgeführt- Dieselbe Zeile mit
tier user: Claude Code behandelt ihn als Mod eines Benutzers. Eine zweite Zeile,prependPlugins names acme-guard@acme-tools, which is not an enabled managed plugin with a hooks module; skipped, besagt, dass die Liste ihn übersprungen hat.
- Die Liste ersetzt den Standard: Wenn Sie
prependPluginsin verwalteten Einstellungen setzen, führen Sie darinsec-default@builtinauf, um den integrierten Wächter beizubehalten. Der Wächter ist integriert und benötigt keinen Eintrag inenabledPlugins. - Ihre eigenen IDs müssen als Ihre gelten: In verwalteten Einstellungen überspringt Claude Code eine ID, deren Plugin die Bedingungen für einen Mod einer Organisation nicht erfüllt
- Repositorys können keine der beiden Listen setzen: Claude Code ignoriert beide in der Einstellungsdatei eines Repositorys. Setzen Sie sie daher in verwalteten Einstellungen.
- Ein Benutzer kann sie setzen, um seine eigenen Mods zu ordnen: in
~/.claude/settings.json, allerdings nur auf einem Rechner ohne verwaltete Einstellungen odermanaged-mcp.json-Datei und nur, wenn die Anmeldedaten der Sitzung kein Team- oder Enterprise-/loginsind. In allen anderen Fällen ignoriert Claude Code beide Schlüssel in den Benutzereinstellungen. Eine Liste dort fügt den integrierten Wächter weder hinzu noch entfernt sie ihn.
Eine Richtlinie mit einem eigenen Mod durchsetzen
Um alle Mods von Benutzern fernzuhalten, benötigen Sie keinen eigenen Mod. Setzen SieallowManagedModsOnly. Schreiben Sie einen Richtlinien-Mod, wenn Sie einige Mods von Benutzern zulassen und andere ablehnen möchten oder wenn Sie protokollieren möchten, was Mods tun.
Jedes Mal, wenn ein anderer Mod geladen werden soll, erhält Ihr Mod die Liste, die claude plugin validate ausgibt, in einem Ereignis namens plugin.register. Ein Mod in prependPlugins kann diese Liste lesen und den Mod ablehnen. Er kann außerdem jeden Aufruf der Mods-API über ihren Namen behandeln, um diesen Aufruf für jeden anderen Mod zu protokollieren oder abzulehnen. Der Name ist die Methode ohne $., sodass ein Hook auf fs.write jeden Aufruf von $.fs.write sieht.
Ab v2.1.323 benötigt ein
ui.focus-Hook einen breiteren Matcher, um die $.ui.focus-Aufrufe anderer Mods zu empfangen. Siehe Zeichnungen und Steuerelemente anderer Mods hooken.$.process.run oder $.process.spawn aufruft. Außerdem führt er ein Audit-Log, indem er jeden Tool-Aufruf und jede Datei, die ein Mod schreibt, in das Debug-Log schreibt. Da er zuerst ausgeführt wird, hält das Log fest, was angefordert wurde, bevor ein Mod eines Benutzers es ändert. Speichern Sie ihn als acme-guard/hooks/register.js:
acme-guard/hooks/register.js
plugin.register: entscheidet, ob ein anderer Mod geladen wird. Er lehnt einen Mod eines Benutzers ab, der eine blockierte Methode aufruft, und lässt jeden anderen Mod durch.tool.call: schreibt für jeden Tool-Aufruf eine Zeile wieaudit tool.call Bashin das Debug-Log und ändert nichtsfs.write: schreibt für jeden Aufruf von$.fs.write, den ein anderer Mod ausführt, eine Zeile wieaudit fs.write by reader "/tmp/notes.md"und ändert nichts. Der Name des Mods steht zuerst und der Pfad in Anführungszeichen, sodass ein Pfad, den ein Mod wählt, nicht als ein anderes Feld der Zeile durchgehen kann.
plugin.register liest zwei Felder des Ereignisses:
e.tier: wo der Mod ausgeführt würde, einer der Werteprepend,user,appendoderbuiltin. Jeder Mod, den eine Person installiert, istuser.e.uses.calls: die Methoden der Mods-API, die der Mod aufruft, jeweils alsnamespace.methodgeschrieben, etwaprocess.run, ohne das$., dasclaude plugin validateausgibt
$.process.run aufruft, wird der Mod nicht geladen, und sein Debug-Log enthält eine Zeile, die mit refused by acme-guard: und Ihrer Begründung endet. Die Ablehnung erscheint außerdem im Transkript einer Sitzung, die ein Plugin-Verzeichnis per Hot-Reload neu lädt.
Um einen Aufruf zu blockieren, ohne den gesamten Mod abzulehnen, geben Sie { deny: 'your reason' } aus einem Hook auf den Namen dieses Aufrufs zurück, nachdem Sie geprüft haben, wer den Aufruf ausgeführt hat.
Um die Audit-Zeilen an ein anderes Ziel als das Debug-Log zu senden, rufen Sie $.http.fetch aus denselben Hooks auf.
Eine Sitzung kann ohne Ihren Mod laufen. Wenn der Worker-Thread, der installierte Mods ausführt, dreimal abstürzt, entlädt Claude Code jeden Mod, der nicht integriert ist, einschließlich Ihres, bis der Benutzer /reload-plugins ausführt oder eine neue Sitzung startet. Und ein Benutzer, der Claude Code mit --safe-mode startet, arbeitet ohne installierte Mods, Ihren eingeschlossen.
Einen Mod erstellen behandelt die Dateien, die ein Mod benötigt. Einen Richtlinien-Mod testen enthält eine Testdatei für diesen Richtlinien-Mod.
Mods ablehnen, wenn Ihre Prüfung fehlschlägt
Wenn Ihr Hookplugin.register eine Ausnahme auslöst oder sein Zeitlimit überschreitet, überspringt Claude Code den Hook. Die Prüfung schlägt also offen fehl, und der Mod, der geprüft wurde, wird geladen. Damit die Prüfung geschlossen fehlschlägt und Mods von Benutzern abgelehnt werden, verschieben Sie die Prüfung in eine benannte Funktion und fügen Sie einen .catch-Handler hinzu, der die Ablehnung zurückgibt. Diese Version der Datei zeigt nur den Hook plugin.register. Behalten Sie daher die beiden Audit-Hooks aus der ersten Version in register bei:
acme-guard/hooks/register.js
refused by acme-guard: Acme policy check failed, so this mod was not loaded. Der Handler übergibt jeden Mod außerhalb der Stufe user an next(e), sodass eine fehlgeschlagene Prüfung die Mods, die Ihre Organisation aufführt, nicht aufhält. Einen fehlschlagenden Hook behandeln behandelt .catch für andere Ereignisse.
Nächste Schritte
- Plugin-Sicherheit: was jedes Plugin auf dem Rechner eines Benutzers tun kann und wie Sie ein Plugin prüfen, bevor es installiert wird
- Mods-Übersicht: was ein Mod ist und wie er sich im Vergleich zu Hooks, Skills und MCP-Servern verhält
- Die Reihenfolge, in der Mods ausgeführt werden: wie
prependPluginsundappendPluginsmit den Mods der Benutzer zusammenspielen - Einstellungen und Umgebungsvariablen: alle auf dieser Seite genannten Einstellungen in einer Tabelle