Zum Hauptinhalt springen

Verwalten Sie Plugins für Ihre Organisation

Plugin-Marktplätze ermöglichen es Inhabern von Team- und Enterprise-Plänen, kuratierte Plugins an alle Mitglieder ihrer Organisation zu verteilen. Sie erstellen einen Marktplatz, fügen Plugins hinzu und kontrollieren genau, welche Plugins Ihre Teammitglieder sehen und verwenden können. Plugins, die Sie verteilen, erscheinen sowohl im Chat (im Web und im Chat-Tab in Claude Desktop) als auch in Claude Cowork.

Inhaber und Primäre Inhaber von Team- und Enterprise-Plänen können Organisations-Plugins in Organisationseinstellungen > Plugins verwalten.

Anforderungen: Cowork und Skills müssen beide für Ihre Organisation aktiviert sein, bevor Sie Plugin-Marktplätze verwenden können.


Verwenden Sie von Anthropic erstellte Marktplätze

Anthropic bietet integrierte Marktplätze mit Plugins für verschiedene Funktionen, wie Recht und Finanzen. Ein Knowledge-Work-Marktplatz wird standardmäßig zu Ihrer Organisation hinzugefügt.

So fügen Sie einen von Anthropic erstellten Marktplatz hinzu:

  1. Klicken Sie auf „Plugins hinzufügen"."

  2. Wählen Sie „Anthropic-Quellen durchsuchen"."

  3. Klicken Sie auf „Hinzufügen

So entfernen Sie den Knowledge-Work-Marktplatz, falls er für Ihre Teams nicht relevant ist:

  1. Suchen Sie Knowledge Work.

  2. Klicken Sie auf die Menüschaltfläche in der oberen rechten Ecke.

  3. Wählen Sie „Entfernen"."

Von Anthropic erstellte Marktplätze zeigen lesbare Namen wie „Knowledge Work" anstelle des zugrunde liegenden Repository-Slugs an."


Erstellen Sie Ihren eigenen Marktplatz

Neben den von Anthropic erstellten Marktplätzen können Sie Ihren eigenen erstellen. Es gibt zwei Möglichkeiten, Plugins zu einem von Ihnen erstellten Marktplatz hinzuzufügen:

  • Manueller Upload: Laden Sie einzelne Plugin-ZIP-Dateien über die Admin-Benutzeroberfläche hoch. Am besten für schnelle Iterationen, einmalige Tools oder Teams, die GitHub nicht für die Plugin-Entwicklung verwenden.

  • GitHub-Synchronisierung: Verbinden Sie ein privates GitHub-Repository und Cowork synchronisiert Plugins automatisch daraus. Am besten, wenn mehrere Entwickler an Plugins zusammenarbeiten oder Sie versionskontrollierte Updates möchten.

Sie können beide Ansätze parallel verwenden. Führen Sie beispielsweise einen GitHub-synchronisierten Marktplatz für Ihre Kern-Plugins und einen separaten manuellen Marktplatz für Ad-hoc-Tools aus.

Richten Sie einen manuellen Marktplatz ein

  1. Klicken Sie auf „Plugins hinzufügen" und wählen Sie „Eine Datei hochladen" als Quelle.

  2. Wenn dies Ihr erstes Mal ist, einen Marktplatz einzurichten, ist „In einen neuen Marktplatz hochladen" automatisch ausgewählt. Sie können später beim Hochladen von Plugins „Zu einem vorhandenen Marktplatz hinzufügen" wählen.

  3. Geben Sie einen Namen für Ihren Marktplatz ein.

  4. Ziehen Sie Ihre Dateien hinein oder klicken Sie auf die Upload-Aufforderung und wählen Sie Ihre Datei. Die Datei muss eine gültige .zip-Datei unter 50 MB sein.

  5. Wiederholen Sie dies für jedes Plugin, das Sie hinzufügen möchten.

  6. Klicken Sie auf „Hochladen

Wenn Sie ein Plugin mit demselben Namen wie ein vorhandenes hochladen, wird die vorherige Version automatisch überschrieben. Sie müssen die alte Version nicht zuerst löschen.

Richten Sie einen GitHub-synchronisierten Marktplatz ein

GitHub-Synchronisierung ermöglicht es Ihnen, Plugins als Code in einem Repository zu verwalten. Wenn Sie Änderungen pushen, können Sie eine Synchronisierung auslösen, um Ihren Marktplatz zu aktualisieren, entweder manuell oder automatisch.

Bereiten Sie Ihr Repository vor

Ihr Repository muss privat oder intern sein – öffentliche Repositories sind für Organisations-Marktplätze nicht zulässig. Sie können ein Repository verbinden, das auf github.com oder auf einer selbstgehosteten GitHub Enterprise Server-Instanz gehostet wird.

GitHub-synchronisierte Marktplätze unterstützen einen engeren Satz von source-Typen in marketplace.json als die Claude Code CLI. Relative Pfade zu Plugin-Ordnern im verbundenen Repository (z. B. "source": "./plugins/my-plugin") werden vollständig unterstützt. Die github-, url- und git-subdir-Quelltypen werden nur unterstützt, wenn das Ziel-Repository öffentlich ist. Die npm- und pip-Quelltypen werden nicht unterstützt. Wenn Ihr Plugin-Code in separaten privaten Repositories lebt, kopieren Sie diese Plugin-Ordner in das Marketplace-Repository (ein Git-Submodul, Git-Subtree oder ein CI-Schritt funktioniert gut) und referenzieren Sie sie mit relativen Pfaden.

Weitere Informationen zur Plugin-Struktur und Formatierung finden Sie in der Plugin-Referenzdokumentation.

Zusätzliche Ressourcen:

Verbinden Sie das Repository

  1. Stellen Sie sicher, dass sowohl Cowork als auch Skills für Ihre Organisation aktiviert sind.

  2. Klicken Sie auf „Plugin hinzufügen" und wählen Sie „GitHub" als Quelle.

  3. Geben Sie das Repository im Format owner/repo ein (z. B. acme-corp/claude-plugins).

Ihr persönliches GitHub-Token wird überprüft, um zu bestätigen, dass Sie Zugriff haben. Dann verwendet Cowork sein GitHub-App-Installationstoken für Synchronisierungsvorgänge.

Kannst du dein Repository nicht sehen? Stelle sicher, dass die Claude GitHub App in diesem Repository installiert ist.

So funktioniert die Synchronisierung

Eine initiale Synchronisierung wird automatisch ausgeführt, wenn du ein Repository verbindest. Danach können Organisationsinhaber sich für fortlaufende automatische Updates pro Marketplace anmelden, indem sie zu Organisationseinstellungen > Plugins gehen, auf die Menüschaltfläche in der oberen rechten Ecke des Marketplace klicken und dann "Automatisch synchronisieren" aktivieren:

Das Aktivieren der automatischen Synchronisierung erstellt einen Webhook im verbundenen Repository. Die Person, die den Schalter aktiviert, muss über Administratorzugriff auf dieses Repository auf GitHub verfügen. Dies wird über ihre persönliche GitHub-Verbindung überprüft, die von der Claude GitHub App-Installation getrennt ist. Ohne Administratorzugriff zeigt die Seite "Cannot access repository. Ensure the repository exists and the Claude GitHub App is installed" an, auch wenn die App korrekt installiert ist und manuelle Updates funktionieren.

Die Webhooks (Read & Write)-Berechtigung der Claude GitHub App muss auch bei der Installation genehmigt werden. Bei Installationen, die vor der Einführung dieser Berechtigung erstellt wurden, zeigt GitHub eine Aufforderung "Claude is requesting updated permissions" an, die ein Repository- oder Organisationsadministrator genehmigen muss.

Nach der Aktivierung wird die automatische Synchronisierung ausgeführt, wenn ein Pull Request mit einer Plugin-Versionsaktualisierung in den Standard-Branch des Repositorys zusammengeführt wird. Direkte Pushes zum Standard-Branch lösen keine Synchronisierung aus. Du kannst eine Synchronisierung jederzeit manuell auslösen, indem du auf dem Marketplace auf "Aktualisieren" klickst.

Während einer Synchronisierung vergleicht Cowork den neuesten Commit in deinem Repository mit dem zuletzt synchronisierten Commit. Wenn sich nichts geändert hat, wird die Synchronisierung übersprungen. Wenn es Änderungen gibt, liest Cowork das Manifest, validiert jedes Plugin und ersetzt alle Plugins im Marketplace durch den aktuellen Status des Repositorys. Synchronisierungen können je nach Anzahl der Plugins bis zu 30 Minuten dauern.

Wichtig: Wenn eine Synchronisierung fehlschlägt, können Plugins für deine Teammitglieder vorübergehend entfernt werden. Wenn dies geschieht, überprüfe die Fehlermeldung, behebe das Problem in deinem Repository, push das Update und löse die Synchronisierung erneut aus. Sobald die Synchronisierung erfolgreich ist, überprüfe, ob deine Installationseinstellungen noch korrekt eingestellt sind, da sie während des Fehlers möglicherweise zurückgesetzt wurden.

Wähle zwischen manuellem Upload und GitHub-Synchronisierung

Szenario

Empfohlener Ansatz

Plugins werden in der Versionskontrolle mit CI/CD verwaltet

GitHub-Synchronisierung

Mehrere Entwickler arbeiten an Plugins zusammen

GitHub-Synchronisierung

Du möchtest automatische Update-Verbreitung

GitHub-Synchronisierung

Du benötigst mehr als 100 Plugins in einem Marketplace

GitHub-Synchronisierung

Schnelle Prototypenerstellung oder einmalige Tools

Manueller Upload

Plugins, die von nicht-technischen Teams erstellt wurden

Manueller Upload

Umgebungen ohne GitHub-Zugriff

Manueller Upload

Testen eines Plugins vor dem Hinzufügen zu einem synchronisierten Repository

Manueller Upload


Kontrolliere die Plugin-Verteilung

Sobald dein Marketplace Plugins hat, kontrollierst du, wie sie verteilt werden, indem du Installationseinstellungen verwendest. Für jedes Plugin kannst du eine von vier Optionen festlegen:

Einstellung

Was es bewirkt

Was Mitglieder sehen

Standardmäßig installiert

Wird automatisch für alle Organisationsmitglieder installiert

Das Plugin wird in ihrer installierten Liste ohne weitere Aktion angezeigt. Mitglieder können es deinstallieren, wenn sie möchten.

Verfügbar zur Installation

Im Plugin-Katalog aufgelistet

Mitglieder sehen es beim Durchsuchen von Plugins und können es selbst installieren.

Nicht verfügbar

Vollständig aus dem Katalog ausgeblendet

Mitglieder können das Plugin nicht sehen oder installieren. Nützlich zum Staging oder Veralten von Plugins.

Erforderlich

Wird automatisch für alle Organisationsmitglieder installiert, ohne dass die Option zum Entfernen besteht

Das Plugin wird in ihrer installierten Liste ohne weitere Aktion angezeigt und kann nicht deaktiviert oder deinstalliert werden.

Einstellungen festlegen

  1. Navigiere in Organisationseinstellungen > Plugins zu deinem Marketplace.

  2. Wähle die Installationseinstellung für jedes Plugin aus.

  3. Änderungen werden in der nächsten Sitzung oder beim Plugin-Refresh jedes Mitglieds wirksam.

Was Mitglieder erleben

Mitglieder durchsuchen verfügbare Plugins über das Modal Plugins durchsuchen. Automatisch installierte Plugins werden automatisch in ihrer installierten Liste angezeigt. Verfügbare Plugins werden im Katalog für die Selbstbedienungsinstallation angezeigt.

Mitglieder können von der Organisation verwaltete Plugins nicht bearbeiten, was verhindert, dass Änderungen an gemeinsamen Tools in Konflikt geraten.


Plugin-Zugriff nach Gruppe anpassen

Enterprise-Administratoren können die organisationsweite Installationseinstellung eines Plugins für bestimmte Gruppen überschreiben. Sie können beispielsweise ein Plugin für die Engineering-Gruppe automatisch installieren, es der Legal-Gruppe zur eigenständigen Installation zur Verfügung stellen und es vor allen anderen verbergen.

Der Plugin-Zugriff auf Gruppenebene ist in Enterprise-Plänen verfügbar und kann von Administratoren und höher konfiguriert werden.

Wie Gruppenüberschreibungen funktionieren

Jedes Plugin in Ihrem Marketplace hat eine organisationsweite Installationseinstellung (Standardmäßig installiert, Zur Installation verfügbar, Erforderlich oder Nicht verfügbar). Standardmäßig erbt jede Gruppe diese organisationsweite Einstellung.

Wenn Sie eine Überschreibung auf Gruppenebene für ein Plugin festlegen, ersetzt diese die organisationsweite Einstellung für Mitglieder dieser Gruppe. Die Auflösungsreihenfolge ist: Gruppeneinstellung, dann organisationsweite Einstellung, dann Marketplace-Standard.

Plugin-Zugriff für eine Gruppe festlegen

  1. Navigieren Sie in Organisationseinstellungen > Plugins zu Ihrem Marketplace.

  2. Suchen Sie das Plugin, das Sie anpassen möchten.

  3. Klicken Sie in der Spalte Benutzerdefinierter Zugriff auf „Gruppen hinzufügen"."

  4. Wählen Sie die Gruppe aus und wählen Sie eine der oben aufgeführten Installationseinstellungen.

Sowohl manuell erstellte Gruppen als auch von SCIM bereitgestellte Gruppen von Ihrem Identitätsanbieter werden in der Gruppenauswahl angezeigt und funktionieren auf die gleiche Weise.

Was passiert, wenn ein Mitglied in mehreren Gruppen ist

Wenn ein Mitglied zwei oder mehr Gruppen mit unterschiedlichen Einstellungen für dasselbe Plugin angehört, wird die Einstellung mit den meisten Berechtigungen angewendet. Die Reihenfolge von den meisten zu den wenigsten Berechtigungen ist: Erforderlich > Standardmäßig installiert > Zur Installation verfügbar > Nicht verfügbar.

Wenn beispielsweise Gruppe A ein Plugin auf „Nicht verfügbar" setzt und Gruppe B es auf „Standardmäßig installiert" setzt, erhält ein Mitglied in beiden Gruppen das Plugin standardmäßig installiert.

Hinweis: Dies unterscheidet sich davon, wie Ausgabenlimits für Gruppen aufgelöst werden. Ausgabenlimits wenden entweder den höheren oder niedrigeren Gruppenwert an, je nach Ihrer Einstellung Ausgabenlimit für mehrere Gruppen. Der Plugin-Zugriff wendet den Wert mit den meisten Berechtigungen an, da Gruppen hier dazu bestimmt sind, den Zugriff für Teams zu ermöglichen, die ein Tool benötigen, nicht um als Sicherheitsgrenze zu fungieren. Wenn Sie ein Plugin hart blockieren müssen, setzen Sie seine organisationsweite Einstellung auf „Nicht verfügbar

Was passiert, wenn eine Gruppe gelöscht wird

Wenn eine Gruppe entfernt wird (z. B. aus Ihrem Identitätsanbieter gelöscht), bleibt die Überschreibung in der Admin-Benutzeroberfläche erhalten, wird aber als verwaist gekennzeichnet. Sie hat keine Auswirkung auf Mitglieder (da niemand einer gelöschten Gruppe angehört) und zählt nicht zum Badge für benutzerdefinierten Zugriff. Sie können verwaiste Überschreibungen aus den Einstellungen für benutzerdefinierten Zugriff des Plugins löschen.

Bleiben Gruppeneinstellungen über Marketplace-Neusynchronisierungen erhalten?

Ja. Überschreibungen auf Gruppenebene bleiben erhalten, wenn Sie einen mit GitHub verbundenen Marketplace neu synchronisieren. Sie werden nur entfernt, wenn das Plugin selbst aus dem Marketplace gelöscht wird.


Plugins aktualisieren und entfernen

Manuelle Marketplaces

Um ein Plugin zu aktualisieren, laden Sie eine neue ZIP-Datei mit demselben Plugin-Namen hoch. Die neue Version überschreibt die vorhandene automatisch. Plugin-Namen sind der eindeutige Bezeichner, daher wird legal immer legal ersetzen.

Um ein Plugin zu entfernen, löschen Sie es aus Ihrem Marketplace in Organisationseinstellungen > Plugins.

Mit GitHub synchronisierte Marketplaces

Pushen Sie Ihre Änderungen in das verbundene Repository, gehen Sie dann zu Organisationseinstellungen > Plugins, suchen Sie Ihren Marketplace und klicken Sie auf „Aktualisieren

Um ein Plugin zu entfernen, löschen Sie es aus dem Repository und lösen Sie eine Synchronisierung aus.


Limits

Limit

Wert

Hinweise

Maximale Plugin-ZIP-Größe (Upload)

50 MB

Wird sowohl auf der Client-Seite als auch auf der Server-Seite erzwungen

Maximale Plugins pro Marketplace (manuell)

100

Pro Marketplace

Maximale Plugins pro Marketplace (GitHub-Synchronisierung)

500

Pro Marketplace

Maximale Plugin-Namenslänge

64 Zeichen

Muss Kleinbuchstaben mit Bindestrichen verwenden

Synchronisierungs-Timeout

30 Minuten

Pro Synchronisierungsvorgang

GitHub-Repository-Sichtbarkeit

Nur privat oder intern

Gehostet auf github.com oder GitHub Enterprise Server. Öffentliche Repositorys werden nicht unterstützt.


Benennungsregeln

Plugin-Namen müssen Kleinbuchstaben mit Bindestrichen getrennt verwenden (z. B. deployment-tools, nicht Deployment Tools). Die folgenden Marketplace-Namen sind reserviert und können nicht verwendet werden:

  • claude-code-marketplace

  • claude-code-plugins

  • claude-plugins-official

  • anthropic-marketplace

  • anthropic-plugins

  • agent-skills

  • life-sciences

Namen, die offizielle Anthropic-Marketplaces imitieren, sind ebenfalls blockiert.

Hinweis: Plugin-Autoren können einen displayName festlegen, damit ein Plugin im Katalog einen lesbaren Namen anstelle seines Slug anzeigt. Wenn ein Autor keinen festlegt, zeigt das Plugin seinen Slug an (z. B. deployment-tools).


Fehlerbehebung

Upload abgelehnt

Häufige Ursachen: Die Datei überschreitet 50 MB, es ist keine gültige ZIP-Datei, oder der Marketplace hat das Limit von 100 Plugins erreicht. Überprüfen Sie die Dateigröße und das Format, und entfernen Sie nicht verwendete Plugins, wenn Sie die Kapazität erreicht haben.

Plugin wird für Mitglieder nicht angezeigt

Überprüfen Sie die Installationspräferenz des Plugins in Ihren Marketplace-Einstellungen. Wenn sie auf Nicht verfügbar eingestellt ist, werden Mitglieder es nicht sehen. Bestätigen Sie auch, dass Cowork und Skills für Ihre Organisation beide aktiviert sind.

Aktualisiertes Plugin wird für Mitglieder nicht angezeigt

Änderungen werden in der nächsten Sitzung oder beim Plugin-Refresh jedes Mitglieds wirksam. Wenn das Update immer noch nicht angezeigt wird, bestätigen Sie, dass der Upload erfolgreich war, indem Sie die Plugin-Version in Ihrem Marketplace überprüfen.

GitHub-Synchronisierung schlägt mit Inhaltsfehler fehl

Ein oder mehrere Plugins in Ihrem Repository sind wahrscheinlich falsch formatiert. Beheben Sie das Formatierungsproblem, pushen Sie das Update zu GitHub, und triggern Sie die Synchronisierung erneut. Anforderungen zur Plugin-Struktur finden Sie in der Plugin-Referenzdokumentation.

Synchronisierung schlägt mit "Externe Plugin-Quellen werden noch nicht unterstützt" fehl, oder Plugins werden übersprungen mit "Repository nicht auf github.com gefunden. Überprüfen Sie die URL und stellen Sie sicher, dass das Repository öffentlich ist."

Ein oder mehrere Plugin-Einträge in Ihrer marketplace.json verwenden eine source, die außerhalb des verbundenen Repositorys verweist (eine github-, url- oder git-subdir-Quelle), und das Ziel-Repository ist privat. Die Organisations-Synchronisierung kann derzeit externe Quellen nur aus öffentlichen Repositorys abrufen. Verschieben Sie die Plugin-Ordner in das Marketplace-Repository und ändern Sie die source jedes Eintrags in einen relativen Pfad (z. B. "./plugins/my-plugin"), dann pushen und synchronisieren Sie erneut. Alternativ können Sie die betroffenen Plugins einzeln über Anpassen > Plugin hinzufügen > Plugin erstellen > Plugin hochladen hochladen.

Plugins sind nach einer fehlgeschlagenen Synchronisierung verschwunden

Eine fehlgeschlagene GitHub-Synchronisierung kann Plugins vorübergehend aus Ihrem Marketplace entfernen. Beheben Sie das zugrunde liegende Problem, synchronisieren Sie erfolgreich erneut, und überprüfen Sie dann, ob die Installationspräferenzen korrekt eingestellt sind, da sie möglicherweise zurückgesetzt wurden.

GitHub-Repository wird beim Verbinden nicht angezeigt

Stellen Sie sicher, dass die Claude GitHub App in diesem Repository installiert ist. Ihr persönliches GitHub-Token wird zuerst überprüft, um den Zugriff zu bestätigen, aber die Synchronisierung selbst verwendet das GitHub App-Installationstoken.

"Repository kann nicht zugegriffen werden" beim Aktivieren von "Automatisch synchronisieren"

Wenn manuelle Updates funktionieren, aber das Aktivieren von "Automatisch synchronisieren" "Repository kann nicht zugegriffen werden. Stellen Sie sicher, dass das Repository vorhanden ist und die Claude GitHub App installiert ist" anzeigt, gibt es zwei wahrscheinliche Ursachen:

  • Sie haben keinen Admin-Zugriff auf das Repository. Das Aktivieren der automatischen Synchronisierung erstellt einen Webhook, der Admin-Zugriff auf das Repository über Ihre persönliche GitHub-Verbindung erfordert. Bitten Sie einen Repository-Admin, den Toggle zu aktivieren, oder lassen Sie Ihren GitHub-Zugriff erhöhen.

  • Die Webhooks-Berechtigung der Claude GitHub App wurde nicht genehmigt. Bei älteren Installationen zeigt GitHub eine "Claude fordert aktualisierte Berechtigungen an"-Aufforderung an. Ein Repository- oder Organisations-Admin muss die Webhooks (Lesen & Schreiben)-Berechtigung für die Installation genehmigen.

Hat dies deine Frage beantwortet?