Verwalten Sie Claude Code-Plugins für Ihre Organisation

​

Plugins vorinstallieren und erforderlich machen

​

Wählen Sie einen Bereitstellungsmechanismus

• Serverseitig verwaltete Einstellungen: Setzen Sie die Plugin-Schlüssel als JSON unter Organisationseinstellungen > Claude Code > Verwaltete Einstellungen. Erfordert eine Eigentümerrolle in Ihrer Claude-Organisation. Eine Cloud-Sitzung ruft diese Einstellungen ab, bevor sie Plugins installiert.
• MDM-Richtlinien: Unter macOS stellen Sie eine plist bereit, deren oberste Schlüssel die Einstellungsschlüssel sind. Unter Windows speichern Sie das gesamte JSON-Dokument als Zeichenkette in einem Registrierungswert. Die plist-Domäne und der Registrierungsschlüssel befinden sich unter Wo jeder Mechanismus die Richtlinie speichert.
• Verwaltete Einstellungsdatei: Platzieren Sie eine managed-settings.json im Systempfad der Plattform. Sie können auch Dateien zum managed-settings.d/-Drop-in-Verzeichnis daneben hinzufügen. Die Dateipfade pro Plattform befinden sich unter Wo jeder Mechanismus die Richtlinie speichert, und die Drop-in-Zusammenführungsregeln befinden sich unter Teilen Sie eine dateibasierte Richtlinie auf Teams auf.

​

Welche verwaltete Quelle gilt auf einem Computer

​

Erforderlich machen eines Marketplace und seiner Plugins

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": { "source": "github", "repo": "your-org/your-marketplace" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": {
    "code-formatter@your-marketplace": true,
    "deploy-helper@your-marketplace": true
  }
}

• autoUpdate: true hält den Marketplace und seine Plugins im Hintergrund aktualisiert, und false schaltet das aus. Siehe Aktualisierungsrichtlinie festlegen.
• source: github ist einer von mehreren Quellentypen. Eine git-Quelle benötigt eine url für GitLab oder einen internen Host, und eine url-Quelle benötigt die Adresse einer gehosteten marketplace.json. Jede Quellenform befindet sich in der Marketplace-Referenz.

• Marketplaces: Ein verwalteter Marketplace-Eintrag ersetzt einen Eintrag mit niedrigerer Priorität mit demselben Namen, und die Felder der beiden Einträge werden nicht zusammengeführt.
• --plugin-dir-Kopien: --plugin-dir lädt ein Plugin aus einem lokalen Verzeichnis für eine Sitzung. Für das, was passiert, wenn der Name dieser Kopie mit einem Plugin übereinstimmt, das Ihre verwalteten enabledPlugins benennen, siehe Namenskonflikte.

​

Erforderlich machen von Plugins pro Repository

• Interaktive Sitzungen: Claude Code registriert den Marketplace nur, nachdem der Mitwirkende den Workspace-Vertrauensdialog für diesen Ordner akzeptiert hat.
• Nicht-interaktive -p-Läufe: Die Einträge gelten nur in einem Ordner, dessen Vertrauen der Benutzer bereits interaktiv akzeptiert hat, oder dessen hasTrustDialogAccepted-Flag Sie in ~/.claude.json setzen.

​

Wenn jede Oberfläche die Plugin-Schlüssel anwendet

​

Bestätigen Sie den Rollout

• Auf einem Computer: Starten Sie Claude Code und führen Sie /plugin aus. Der Marketplace und die Plugins sind aufgelistet.
• In CI: Führen Sie claude -p mit --output-format stream-json --verbose aus. Das init-Ereignis listet die geladenen Plugins unter plugins auf.

​

Container und CI seeding

CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin marketplace add your-org/your-marketplace
CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin install code-formatter@your-marketplace

• Schreibgeschützt: Claude Code schreibt niemals in den Seed und erzwingt autoUpdate aus für Seed-Marketplaces.
• Seed-Einträge haben Vorrang: Beim Start überschreibt ein im Seed deklarierter Marketplace den Eintrag des Benutzers mit demselben Namen. Benutzer deaktivieren ein Seed-Plugin mit claude plugin disable, nicht durch Entfernen des Marketplace.
• Aktualisierung und Entfernung schlagen fehl: claude plugin marketplace update <name> und remove ohne --scope auf einem Seed-Marketplace schlagen mit einer Meldung fehl, die das Seed-Verzeichnis benennt.
• Richtlinie gilt immer noch: Die Zulassungsliste und Blockliste überprüfen auch die aufgezeichnete Quelle eines Seed-Marketplace. Erlauben Sie die Quelle, aus der Sie den Seed erstellt haben.

​

Einschränken, was Benutzer installieren können

• Vor einem Download: Die Listen greifen, wenn ein Benutzer einen Marketplace hinzufügt, sowie bei jeder Installation, jedem Update, jeder Aktualisierung und jedem automatischen Update.
• Beim Start einer Sitzung: Die Listen greifen erneut für bereits installierte Plugins, sodass ein installiertes Plugin, dessen Marketplace-Quelle nicht mehr übereinstimmt, nicht geladen wird. /plugin führt es mit Marketplace "<name>" is not in the allowed marketplace list oder Marketplace "<name>" is blocked by enterprise policy auf.

• Die Admin-Konsole von claude.ai: Claude Code setzt beide Listen in den Sitzungen durch, die serverseitig verwaltete Einstellungen lesen. claude.ai prüft sie außerdem, wenn jemand in Ihrer Organisation einen neuen Marketplace aus einem Git-Repository auf claude.ai oder über Customize in der Claude Desktop-App außerhalb ihres Code-Tabs hinzufügt. Das umfasst sowohl einen Marketplace, den ein Mitglied für sein eigenes Konto hinzufügt, als auch einen, der für die gesamte Organisation unter Organization settings > Plugins hinzugefügt wird. claude.ai lehnt ein Repository ab, das die Allowlist nicht zulässt oder das die Blocklist nennt. Ein Marketplace, der an einer dieser Stellen hinzugefügt wurde, bevor Sie die Listen festgelegt haben, wird nicht erneut geprüft, und hochgeladene Plugins werden nicht geprüft.
• Eine verwaltete Einstellungsdatei, eine Richtlinie auf Betriebssystemebene oder eine andere verwaltete Quelle: Claude Code setzt beide Listen dort durch, wo es diese Quelle liest. claude.ai liest sie nicht.

​

Steuerungsmatrix

• enabledPlugins: Sie können ihn in jedem Geltungsbereich setzen, und verwaltete Einstellungen sperren ihn.
• syncClaudeAiPlugins: Jeder Benutzer kann ihn auch in seinen eigenen Benutzer- oder lokalen Einstellungen setzen. Siehe seinen Geltungsbereich in der Einstellungsreferenz.
• CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL: Dies ist eine Umgebungsvariable, die Sie über den verwalteten env-Block bereitstellen, wie unter Updates für die gesamte Flotte ausschalten gezeigt.
• allowManagedModsOnly: Dies ist eine Option eines integrierten Plugins, die Sie unter pluginConfigs in den verwalteten Einstellungen setzen. Siehe Vom Benutzer installierte Mods am Laden hindern.

​

Aliase für die Marketplace-Schlüssel

• Version: Die Aliase erfordern Claude Code v2.1.232 oder höher, und ältere Clients ignorieren sie. Behalten Sie in einer Datei, die von einer gemischten Flotte gelesen wird, die kanonischen Namen bei.
• Beide Schreibweisen gesetzt: Wenn eine Datei beide Schreibweisen setzt, gilt der Wert des kanonischen Schlüssels.

​

Allowlist mit strictKnownMarketplaces

• github: { "source": "github", "repo": "your-org/approved-plugins" }, mit optionalem ref und path.
• github-Owner-Platzhalter: { "source": "github", "repo": "your-org/*" } trifft auf jedes Repository unter diesem Owner zu. Das * muss für den gesamten Repository-Namen stehen. Claude Code ignoriert Einträge wie */plugins und your-org/tools-* als ungültig, sodass sie auf nichts zutreffen. Erfordert Claude Code v2.1.223 oder höher.
• git: { "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }, mit optionalem ref und path.
• url: { "source": "url", "url": "https://plugins.example.com/marketplace.json" }, mit optionalen headers.
• file und directory: { "source": "file", "path": "/opt/marketplace/marketplace.json" } oder { "source": "directory", "path": "/opt/marketplace/plugins" }, mit absoluten Pfaden.
• hostPattern: { "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }, abgeglichen mit dem Host von github-, git- und url-Quellen. Das Muster trifft an beliebiger Stelle im Hostnamen zu. Verankern Sie es daher wie gezeigt mit ^ und $, um den gesamten Host abzugleichen. Eine github-Quelle gilt immer als github.com. Verwenden Sie einen hostPattern-Eintrag für einen GitHub Enterprise Server- oder GitLab-Host, auf dem Entwickler ihre eigenen Marketplaces erstellen. Die GHES-Seite enthält das ausgearbeitete Beispiel.
• pathPattern: { "source": "pathPattern", "pathPattern": "^/opt/approved/" }, abgeglichen mit dem path von file- und directory-Quellen. Das Muster trifft an beliebiger Stelle im Pfad zu. Beginnen Sie es daher mit ^, um ein Verzeichnispräfix festzulegen. ".*" lässt jeden lokalen Pfad zu.
• skills-dir: { "source": "skills-dir" } trifft auf keinen Marketplace zu. Was dieser Eintrag bewirkt, erfahren Sie unter Skills-Verzeichnis-Plugins weiterhin laden.

​

Wie Einträge abgeglichen werden

• Ein Eintrag ohne ref deckt keine Quelle mit ref: "main" ab.
• Ein Eintrag für your-org/your-marketplace deckt keine git-URL ab, die dasselbe Repository klont.
• Ein abschließender Schrägstrich, ein .git-Suffix oder ssh:// anstelle von https:// ist ein anderer Wert. Wenn ein Marketplace über mehr als eine URL geklont werden kann, bevorzugen Sie einen hostPattern-Eintrag.

​

Skills-Verzeichnis-Plugins weiterhin laden

​

Auf claude.ai gehostete Marketplaces

​

Alle Quellen sperren

​

Blocklist mit blockedMarketplaces

• Git-URLs werden kanonisiert, sodass die Formen git@ und https://, .git-Suffixe und abschließende Schrägstriche eines github.com-Repositorys alle auf denselben Eintrag zutreffen.
• Ein github-Eintrag blockiert auch die entsprechende git-URL und umgekehrt.
• Bei einem owner/*-Eintrag wird beim Vergleich des Owners die Groß- und Kleinschreibung nicht berücksichtigt.
• Ein Eintrag ohne ref oder path blockiert jede Ref und jeden Pfad der Repositorys, auf die er zutrifft.

{
  "blockedMarketplaces": [
    { "source": "github", "repo": "untrusted-org/*" }
  ]
}

​

Den offiziellen Marketplace und Ihren eigenen zulassen

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "anthropics/claude-plugins-official" },
    { "source": "github", "repo": "your-org/*" },
    { "source": "skills-dir" }
  ],
  "extraKnownMarketplaces": {
    "claude-plugins-official": {
      "source": { "source": "github", "repo": "anthropics/claude-plugins-official" }
    },
    "your-marketplace": {
      "source": { "source": "github", "repo": "your-org/your-marketplace" }
    }
  },
  "enabledPlugins": {
    "code-formatter@your-marketplace": true,
    "deploy-helper@your-marketplace": true
  },
  "disableSideloadFlags": true
}

• Die Allowlist registriert nichts: Ein extraKnownMarketplaces-Eintrag tut dies, und er muss selbst die Allowlist passieren. Claude Code lehnt die Registrierung eines verwalteten Marketplace ab, dessen Quelle nicht auf die Allowlist zutrifft.
• Der offizielle Marketplace registriert sich nur in einer interaktiven Terminal-Sitzung selbst: Selbst dort registriert er sich nur, wenn die Allowlist es zulässt. Ein -p-Lauf oder ein Terminal, das mit einer Cloud-Sitzung verbunden ist, registriert ihn nie.
• Ein blockierter Versuch wird gespeichert: Wenn ein Rechner jemals unter einer Richtlinie lief, die den offiziellen Marketplace blockiert hat, zeichnet Claude Code den blockierten Versuch auf und versucht es nach einer Änderung der Richtlinie nicht erneut. Eine []-Sperre ist eine solche Richtlinie. Dieser Rechner registriert ihn erst wieder über einen extraKnownMarketplaces-Eintrag wie den in dieser Richtlinie, über einen enabledPlugins-Eintrag für eines seiner Plugins oder über ein manuelles /plugin marketplace add.

​

Aktualisierungsrichtlinie festlegen

​

Schalten Sie Auto-Update pro Marketplace ein oder aus

• Wenn der verwaltete Eintrag das Feld setzt, lehnt Claude Code den /plugin-Toggle des Benutzers mit einem Fehler ab, der mit Auto-update for '<name>' is set by beginnt.
• Wenn der verwaltete Eintrag das Feld nicht setzt, bleibt der Toggle des Benutzers erhalten.

​

Schalten Sie Updates für die ganze Flotte aus

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

​

Weisen Sie Release-Kanäle Benutzergruppen zu

• Stellen Sie separate endpunktseitig verwaltete Einstellungen, z. B. eine verwaltete Einstellungsdatei oder ein MDM-Profil, für die Geräte jeder Gruppe bereit. Um zu überprüfen, ob die Datei oder das Profil pro Gruppe auf einem Gerät gilt, das auch eine organisationsweite Quelle hat, siehe Wie Claude Code verwaltete Quellen kombiniert.
• Definieren Sie eine Claude Apps Gateway-Richtlinie pro Gruppe. Standardmäßig wendet das Gateway die erste Richtlinie an, deren Abgleichsregel zu einem Benutzer passt, daher ordnen Sie die Richtlinien so, dass jeder Benutzer die Richtlinie seiner Gruppe erreicht. Die extraKnownMarketplaces-Karte dieser Richtlinie wird nicht mit einer anderen Richtlinie zusammengeführt, daher listen Sie darin jeden Marketplace auf, den die Gruppe benötigt, nicht nur ihren Kanal-Marketplace.

{
  "extraKnownMarketplaces": {
    "stable-tools": {
      "source": { "source": "github", "repo": "your-org/stable-tools" }
    }
  }
}

​

Plugins empfehlen

​

Überprüfen und überprüfen

​

OpenTelemetry-Ereignisse

​

Analytics-API

​

Planen Sie, was verwaltete Einstellungen nicht erzwingen können

• Pro-Benutzer- oder Pro-Gruppen-Targeting: Jeder Plugin-Schlüssel gilt für jeden Benutzer, der die Einstellungen erhält. Serverseitig verwaltete Einstellungen stellen eine Konfiguration pro Organisation bereit. Für Pro-Gruppen-Richtlinie verwenden Sie separate endpunktseitig verwaltete Einstellungen oder Gateway-Richtlinien, wie unter Weisen Sie Release-Kanäle Benutzergruppen zu.
• Einschränken von Einträgen in einem zulässigen Marketplace: Die Zulassungsliste erfüllt Marketplace-Quellen. Um ein Plugin aus einem zulässigen Marketplace zu blockieren, setzen Sie es auf false in verwalteten enabledPlugins.
• Verstecken Sie /plugin: Kein Schlüssel deaktiviert den Befehl. Das nächste Äquivalent kombiniert eine Zulassungsliste, die nur Ihren Marketplace benennt, verwaltete enabledPlugins-Einträge für die Plugins, die Sie bereitstellen, und disableSideloadFlags.
• Gating --plugin-dir durch die Zulassungsliste: Die Zulassungsliste deckt --plugin-dir nicht ab. disableSideloadFlags tut es.
• Erzwingen Sie die claude.ai-Plugin-Toggles durch diese Schlüssel: Organisationseinstellungen > Plugins & Skills setzt nicht die Schlüssel auf dieser Seite. Was Mitglieder und Ihre Organisation dort einschalten, erreicht die CLI als synchronisierte Plugins, die ihre eigenen Steuerelemente haben.

​

Richtlinie fehlerbeheben

• Die verwaltete Datei wurde nicht geparst: Wenn eine managed-settings.json kein gültiges JSON ist, weigert sich Claude Code zu starten und druckt einen Fehler, der die Datei benennt. Eine Datei, die geparst wird, aber einen ungültigen Eintrag hat, behält den Rest ihrer Richtlinie. Siehe Ungültige Einträge in verwalteten Einstellungen.
• Die verwaltete Quelle wurde nicht geladen: Führen Sie /status aus und suchen Sie nach Enterprise managed settings in der Setting sources-Zeile. Wenn es fehlt, wurde die Quelle nicht geladen.
• Ein Benutzer meldet blocked by enterprise policy: Die Meldung benennt den Marketplace oder seine Quelle. Für eine Zulassungsliste listet sie auch die zulässigen Quellen auf. Die benutzerorientierten Einträge befinden sich unter Fehlerbehebung für Plugins.
• Ein Plugin, das der Benutzer in ~/.claude/settings.json deaktiviert hat, lädt immer noch: Eine andere Einstellungsquelle hat es erneut aktiviert, z. B. ein verwalteter enabledPlugins-Eintrag, der es erzwingt. /plugin und claude plugin list zeigen Disabled in ~/.claude/settings.json but still loads mit dieser Einstellungsquelle.

​

Nächste Schritte

• Marketplace-Referenz: Die source-Werte, die extraKnownMarketplaces, strictKnownMarketplaces und blockedMarketplaces akzeptieren
• Hosten und verwalten Sie einen Marketplace: Betreiben Sie den Marketplace, auf den Ihre Richtlinie verweist
• Plugin-Sicherheit und Vertrauen: Was ein Plugin auf einem Computer tun kann und wie man eines vor der Installation überprüft
• Mods für Ihre Organisation verwalten: Deaktivieren oder beschränken Sie Mods, die Plugins, die JavaScript in Claude Code ausführen
• Serverseitig verwaltete Einstellungen: Stellen Sie diese Schlüssel aus der claude.ai-Administratorkonsole bereit
• Fehlerbehebung für Plugins: Die Meldungen, die Benutzer sehen, wenn die Richtlinie sie blockiert