Zum Hauptinhalt springen

Verwalten Sie Cowork-Plugins für Ihre Organisation

Heute aktualisiert

Plugin-Marktplätze ermöglichen es Team- und Enterprise-Plan-Inhabern, kuratierte Plugins über 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:

  • Manuelles Hochladen – 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 – zum Beispiel einen GitHub-synchronisierten Marktplatz für Ihre Kern-Plugins und einen separaten manuellen Marktplatz für Ad-hoc-Tools.


Einen 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 „In einen neuen Marktplatz hochladen" automatisch ausgewählt.

    1. Sie können „Zu einem vorhandenen Marktplatz hinzufügen" wählen, wenn Sie in Zukunft Plugins hochladen.

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

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

    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", um Ihre Plugins zu einem neuen Marktplatz hinzuzufügen.

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.


Einen GitHub-synchronisierten Marktplatz einrichten

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

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.

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. 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 (zum Beispiel 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 Cowork 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 Sie Synchronisierungen manuell auslösen, indem Sie auf „Nach Updates suchen" in Ihrem Marktplatz unter Organisationseinstellungen > Plugins 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 mit dem 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.


Kontrollieren Sie die Plugin-Verteilung

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

Einstellung

Was es tut

Was Mitglieder sehen

Automatische Installation

Wird automatisch für alle Organisationsmitglieder installiert

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

Verfügbar

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.

Einstellungen festlegen

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

  2. Wählen Sie die Installationseinstellung für jedes Plugin.

  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 installierten Liste automatisch angezeigt. Verfügbare Plugins werden im Katalog für die Selbstbedienungsinstallation angezeigt.

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


Aktualisieren und entfernen Sie Plugins

Manuelle Marktplätze

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 – legal ersetzt immer legal.

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

GitHub-synchronisierte Marktplätze

Pushen Sie Ihre Änderungen in das verbundene Repository, gehen Sie dann zu Organisationseinstellungen > Plugins, suchen Sie Ihren Marktplatz und klicken Sie auf „Nach Updates suchen", um eine Synchronisierung auszulösen. Jede Synchronisierung ersetzt alle Plugins mit dem aktuellen Status des Repos.

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

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

Max. Plugins pro Marktplatz (manuell)

100

Pro Marktplatz

Max. Plugins pro Marktplatz (GitHub-Synchronisierung)

500

Pro Marktplatz

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 (zum Beispiel deployment-tools, nicht Deployment Tools). Die folgenden Marktplatznamen 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-Marktplätze 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-Propagation

GitHub-Synchronisierung

Sie benötigen mehr als 100 Plugins in einem Marktplatz

GitHub-Synchronisierung

Schnelle Prototypisierung oder einmalige Tools

Manuelles Hochladen

Plugins, die von nicht-technischen Teams erstellt wurden

Manuelles Hochladen

Umgebungen ohne GitHub-Zugriff

Manuelles Hochladen

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

Manuelles Hochladen


Fehlerbehebung

Upload abgelehnt

Häufige Ursachen: Die Datei überschreitet 50 MB, es ist keine gültige ZIP-Datei oder der Marktplatz 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 Installationseinstellung des Plugins in Ihren Marktplatzeinstellungen. Wenn es auf Nicht verfügbar eingestellt ist, werden Mitglieder es nicht sehen. Bestätigen Sie auch, dass Cowork und Skills beide für Ihre Organisation 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 Marktplatz überprüfen.

GitHub-Synchronisierung schlägt mit Inhaltsfehler fehl

Ein oder mehrere Plugins in Ihrem Repo sind wahrscheinlich falsch formatiert. Beheben Sie das Formatierungsproblem, pushen Sie das Update zu GitHub und lösen Sie die Synchronisierung erneut aus. Informationen zu Plugin-Strukturanforderungen finden Sie in der Plugin-Referenzdokumentation.

Plugins verschwunden nach fehlgeschlagener Synchronisierung

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

Kann ein GitHub-Repo beim Verbinden nicht sehen

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?