Zum Hauptinhalt springen

Claude Cowork-Plugins für Ihre Organisation verwalten

Plugin-Marktplätze ermöglichen es Inhabern von Team- und Enterprise-Plänen, kuratierte Plugins über Claude Cowork 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.

Inhaber und Primäre Inhaber von Team- und Enterprise-Plänen können Organisations-Plugins auf Claude Desktop verwalten.

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

Es gibt zwei Möglichkeiten, Plugins zu einem 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 – beispielsweise einen GitHub-synchronisierten Marktplatz für Ihre Kern-Plugins und einen separaten manuellen Marktplatz für Ad-hoc-Tools.


Manuellen Marktplatz einrichten

  1. Öffnen Sie Claude Desktop und gehen Sie zu Organisationseinstellungen > Plugins.

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

  3. Wenn dies Ihr erstes Mal beim Einrichten eines Marktplatzes ist, wird „Zu einem neuen Marktplatz hochladen" automatisch ausgewählt."

    1. Sie können „Zu einem vorhandenen Marktplatz hinzufügen

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

  5. Ziehen Sie Ihre Dateien einfach hinein, oder klicken Sie auf die Upload-Aufforderung und wählen Sie Ihre Datei.

    1. Hinweis: Die Datei muss eine gültige .zip-Datei unter 50 MB sein.

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

  7. 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 nicht zuerst löschen.


GitHub-synchronisierten Marktplatz einrichten

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 Repos sind für Organisations-Marktplätze nicht zulässig. Repos, die auf benutzerdefinierten GitHub Enterprise Server-Instanzen gehostet werden, werden nicht unterstützt. Ihr Repo muss auf github.com gehostet sein.

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:

Repository verbinden

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

  2. Gehen Sie zu Organisationseinstellungen > Plugins.

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

  4. 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.

Können Sie Ihr Repo nicht sehen? Stellen Sie sicher, dass die Claude GitHub App in diesem Repository installiert ist.

Wie die Synchronisierung funktioniert

Eine erste Synchronisierung wird automatisch ausgeführt, wenn Sie ein Repository verbinden. Danach können Organisationsinhaber sich für fortgesetzte automatische Updates pro Marktplatz anmelden, indem sie zu Organisationseinstellungen > Plugins gehen (unter Bibliotheken), auf die Menüschaltfläche in der oberen rechten Ecke des Marktplatzes klicken und dann „Automatisch synchronisieren

Der GitHub-Marktplatz wird dann automatisch synchronisiert, wenn ein PR in diesem Repo zusammengeführt wird. Sie können Synchronisierungen auch manuell auslösen, indem Sie auf dem Marktplatz auf „Aktualisieren" klicken."

Während einer Synchronisierung vergleicht Cowork den neuesten Commit in Ihrem Repo 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 Marktplatz durch den aktuellen Status des Repos. Synchronisierungen können je nach Anzahl der Plugins bis zu 30 Minuten dauern.

Wichtig: Wenn eine Synchronisierung fehlschlägt, können Plugins für Ihre Teammitglieder vorübergehend entfernt werden. Wenn dies geschieht, überprüfen Sie die Fehlermeldung, beheben Sie das Problem in Ihrem Repo, pushen Sie das Update und lösen Sie die Synchronisierung erneut aus. Sobald die Synchronisierung erfolgreich ist, überprüfen Sie, ob Ihre Installationseinstellungen noch korrekt eingestellt sind – sie wurden möglicherweise während des Fehlers zurückgesetzt.


Plugin-Verteilung steuern

Sobald Ihr Marktplatz Plugins hat, steuern Sie deren Verteilung mithilfe von Installationseinstellungen. Für jedes Plugin können Sie eine von vier Optionen festlegen:

Einstellung

Was es tut

Was Mitglieder sehen

Standardmäßig installiert

Wird automatisch für alle Organisationsmitglieder installiert

Das Plugin wird in ihrer Installationsliste 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 Einstellen von Plugins.

Erforderlich

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

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

Einstellungen festlegen

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

  2. Wählen Sie 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 in Cowork. Automatisch installierte Plugins werden in ihrer Installationsliste automatisch angezeigt. Verfügbare Plugins werden im Katalog zur Selbstbedienungsinstallation angezeigt.

Mitglieder können von der Organisation verwaltete Plugins nicht bearbeiten, was widersprüchliche Änderungen an gemeinsamen Tools verhindert.


Plugin-Zugriff nach Gruppe anpassen

Enterprise-Administratoren können die organisationsweite Installationseinstellung eines Plugins für bestimmte Gruppen außer Kraft setzen. Sie können beispielsweise ein Plugin für die Engineering-Gruppe automatisch installieren, es der Legal-Gruppe zur Selbstinstallation verfügbar machen 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-Overrides 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 einen Gruppen-Override für ein Plugin festlegen, ersetzt es 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, um einen Gruppen-Override hinzuzufügen.

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

Sowohl manuell erstellte Gruppen als auch 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 das gleiche Plugin angehört, wird die permissivste Einstellung angewendet. Die Reihenfolge von am meisten bis am wenigsten permissiv 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 ist das Gegenteil davon, wie Gruppen-Ausgabenlimits aufgelöst werden. Ausgabenlimits wenden standardmäßig den restriktivsten Wert an, da sie als Budgetkontrolle dienen. Plugin-Zugriff wendet den permissivsten Wert an, da Gruppen hier dazu bestimmt sind, den Zugriff für Teams zu ermöglichen, die ein Tool benötigen – nicht 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 – beispielsweise wenn sie von Ihrem Identitätsanbieter gelöscht wird – bleibt der Override in der Admin-Benutzeroberfläche erhalten, wird aber als verwaist gekennzeichnet. Es 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 Overrides aus den Einstellungen für benutzerdefinierten Zugriff des Plugins löschen.

Bleiben Gruppeneinstellungen über Marketplace-Neusynchronisierungen erhalten?

Ja. Gruppen-Overrides 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 dem gleichen Plugin-Namen hoch. Die neue Version ersetzt die vorhandene automatisch. Plugin-Namen sind der eindeutige Bezeichner – legal ersetzt immer legal.

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

Max. Plugin-ZIP-Größe (Upload)

50 MB

Auf Client- und Server-Seite erzwungen

Max. Plugins pro Marketplace (manuell)

100

Pro Marketplace

Max. Plugins pro Marketplace (GitHub-Synchronisierung)

500

Pro Marketplace

Max. Plugin-Namenslänge

64 Zeichen

Muss Kleinbuchstaben mit Bindestrichen verwenden

Synchronisierungs-Timeout

30 Minuten

Pro Synchronisierungsvorgang

GitHub-Repository-Sichtbarkeit

Nur privat oder intern

Muss auf github.com gehostet sein. Öffentliche Repos und GitHub Enterprise Server-Instanzen werden nicht unterstützt.


Benennungsregeln

Plugin-Namen müssen Kleinbuchstaben mit Bindestrichen 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.


Wählen Sie 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

Sie möchten automatische Update-Verbreitung

GitHub-Synchronisierung

Sie benötigen 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 Repo

Manueller Upload


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 ungenutzte 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 starten 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

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 Organisationssynchronisierung 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"), pushen Sie dann 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 – sie könnten zurückgesetzt worden sein.

GitHub-Repository wird beim Verbinden nicht angezeigt

Stellen Sie sicher, dass die Cowork 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.

Hat dies deine Frage beantwortet?