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 gelten, wenn ein Benutzer einen Marketplace hinzufügt und bei jedem Install, Update, Refresh und Auto-Update.
• Beim Sitzungsstart: Die Listen gelten erneut für bereits installierte Plugins, sodass ein installiertes Plugin, dessen Marketplace-Quelle nicht mehr übereinstimmt, nicht geladen wird. /plugin listet es mit Marketplace "<name>" is not in the allowed marketplace list oder Marketplace "<name>" is blocked by enterprise policy auf.

• Die claude.ai-Admin-Konsole: Claude Code erzwingt beide Listen in den Sitzungen, die server-verwaltete Einstellungen lesen. claude.ai überprüft sie auch, wenn jemand in Ihrer Organisation einen neuen Marketplace aus einem Git-Repository auf claude.ai oder aus Anpassen in der Claude Desktop-App außerhalb der Code-Registerkarte hinzufügt. Dies umfasst einen Marketplace, den ein Mitglied für sein eigenes Konto hinzufügt, und einen, der für die gesamte Organisation unter Organisationseinstellungen > Plugins hinzugefügt wird. claude.ai lehnt ein Repository ab, das die Zulassungsliste nicht zulässt oder das die Blockliste nennt. Es überprüft einen Marketplace nicht erneut, der an beiden Stellen hinzugefügt wurde, bevor Sie die Listen festlegten, und es überprüft hochgeladene Plugins nicht.
• Eine verwaltete Einstellungsdatei, eine Richtlinie auf Betriebssystemebene oder eine andere verwaltete Quelle: Claude Code erzwingt beide Listen, wo es diese Quelle liest. claude.ai liest sie nicht.

​

Kontrollmatrix

• enabledPlugins: Sie können es in jedem Bereich festlegen, und verwaltete Einstellungen sperren es.
• syncClaudeAiPlugins: Jeder Benutzer kann es auch in seinen eigenen Benutzer- oder lokalen Einstellungen festlegen. Siehe seinen Bereich in der Einstellungsreferenz.
• CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL: Dies ist eine Umgebungsvariable, die Sie über den verwalteten env-Block bereitstellen, der unter Updates für die gesamte Flotte ausschalten angezeigt wird.

​

Aliase für die Marketplace-Schlüssel

• Version: Die Aliase erfordern Claude Code v2.1.232 oder später, und ältere Clients ignorieren sie. Behalten Sie in einer Datei, die eine gemischte Flotte liest, die kanonischen Namen.
• Beide Schreibweisen gesetzt: Wenn eine Datei beide Schreibweisen setzt, gilt der Wert des kanonischen Schlüssels.

​

Zulassungsliste mit strictKnownMarketplaces

• github: { "source": "github", "repo": "your-org/approved-plugins" }, mit optionalem ref und path.
• github-Besitzer-Wildcard: { "source": "github", "repo": "your-org/*" } stimmt mit jedem Repository unter diesem Besitzer überein. 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 nichts abgleichen. Erfordert Claude Code v2.1.223 oder später.
• 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 gegen den Host von github, git und url-Quellen. Das Muster stimmt überall im Hostnamen überein, daher verankern Sie es mit ^ und $ wie gezeigt, um den gesamten Host abzugleichen. Eine github-Quelle zählt 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 hat das durchgearbeitete Beispiel.
• pathPattern: { "source": "pathPattern", "pathPattern": "^/opt/approved/" }, abgeglichen gegen den path von file- und directory-Quellen. Das Muster stimmt überall im Pfad überein, daher beginnen Sie es mit ^, um ein Verzeichnispräfix zu fixieren. ".*" erlaubt jeden lokalen Pfad.
• skills-dir: { "source": "skills-dir" } hält Skills-Verzeichnis-Plugins beim Laden unter einer Zulassungsliste und stimmt mit keinem Marketplace überein.

​

Wie Einträge abgleichen

• 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 das gleiche Repository klont.
• Ein nachgestellter Schrägstrich, ein .git-Suffix oder ssh:// anstelle von https:// ist ein anderer Wert. Wenn ein Marketplace von mehr als einer URL geklont werden kann, bevorzugen Sie einen hostPattern-Eintrag.

​

Skills-Verzeichnis-Plugins laden halten

​

Auf claude.ai gehostete Marketplaces

​

Jede Quelle sperren

​

Blockliste mit blockedMarketplaces

• Git-URLs werden kanonisiert, sodass die git@- und https://-Formen, .git-Suffixe und nachgestellte Schrägstriche eines github.com-Repositorys alle den gleichen Eintrag abgleichen.
• Ein github-Eintrag blockiert auch die äquivalente git-URL und umgekehrt.
• Für einen owner/*-Eintrag ist der Besitzervergleich case-insensitiv.
• Ein Eintrag ohne ref oder path blockiert jeden ref und path der Repositorys, die er abgleicht.

{
  "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 Zulassungsliste registriert nichts: Ein extraKnownMarketplaces-Eintrag tut es, und er muss selbst die Zulassungsliste bestehen. Claude Code weigert sich, einen verwalteten Marketplace zu registrieren, dessen Quelle die Zulassungsliste nicht abgleicht.
• Der offizielle Marketplace registriert sich nur in einer interaktiven Terminal-Sitzung: Auch dort registriert er sich nur, wenn die Zulassungsliste es zulässt. Ein -p-Lauf oder ein Terminal, das an eine Cloud-Sitzung angehängt ist, registriert es nie.
• Ein blockierter Versuch wird erinnert: Wenn ein Computer jemals unter einer Richtlinie lief, die den offiziellen Marketplace blockierte, zeichnet Claude Code den blockierten Versuch auf und versucht nicht erneut, nachdem die Richtlinie geändert wird. Eine []-Sperrung ist eine solche Richtlinie. Dieser Computer registriert ihn wieder nur durch einen extraKnownMarketplaces-Eintrag wie den in dieser Richtlinie, einen enabledPlugins-Eintrag für eines seiner Plugins oder 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. Das Gateway wendet 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 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
• 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