Skip to main content
Ein Claude Code Plugin zu veröffentlichen bedeutet, es in einem Marketplace aufzulisten – einem JSON-Katalog, der Plugins auflistet und angibt, wo jedes abgerufen werden kann – damit andere Personen es nach Name installieren können und Ihre Updates erhalten. Sie können Ihren eigenen Marketplace betreiben oder Ihr Plugin bei Anthropics Community Marketplace einreichen. Um ein Plugin ohne Veröffentlichung zu teilen, senden Sie Personen das Plugin-Verzeichnis oder eine .zip davon zum selbst Laden. Diese Seite ist für den Autor eines funktionierenden Plugins, der bereit ist, es zu teilen.
Diese Fälle werden auf anderen Seiten behandelt:
Beginnen Sie mit Wählen Sie, wie Sie verteilen, um die Verteilungsoptionen zu vergleichen. Wenn Sie Ihre Route bereits kennen, gehen Sie zu Bereiten Sie Ihr Plugin für die Veröffentlichung vor, und folgen Sie dann dem Abschnitt Ihrer Route für das, was Sie Ihren Benutzern mitteilen und wie sie Ihre Updates erhalten.

​
Wählen Sie, wie Sie verteilen

Wählen Sie eine Verteilungsoption basierend darauf, wer das Plugin installieren muss: Auto-Update ist eine Einstellung pro Marketplace auf der Benutzerseite, die neue Versionen im Hintergrund abruft.

​
Bereiten Sie Ihr Plugin für die Veröffentlichung vor

Der Name, die Version, die Validierung und eine Installation von einem Marketplace entscheiden, ob eine Veröffentlichung für die Personen funktioniert, die sie installieren. Überprüfen Sie diese vor der ersten Veröffentlichung und erneut vor jeder späteren.
1

Wählen Sie einen permanenten Namen

Benutzer installieren, aktivieren und konfigurieren Ihr Plugin nach name@marketplace, daher ist ein umbenanntes Plugin für jede vorhandene Installation ein anderes Plugin. Wählen Sie einen Kebab-Case-Namen wie deploy-helper, da claude plugin validate vor anderen Formen warnt, und behandeln Sie ihn als permanent. Setzen Sie displayName in plugin.json für das Label, das Benutzer sehen.
2

Entscheiden Sie, wie Sie versionieren

Wenn Sie version in plugin.json setzen und später Commits pushen, ohne es zu ändern, druckt claude plugin update <name> is already at the latest version (1.0.0). und Benutzer behalten die alte Kopie. Erhöhen Sie entweder version bei jeder Veröffentlichung, oder lassen Sie sie in einem Git-gehosteten Marketplace weg, damit Claude Code stattdessen den Commit SHA verwendet. Siehe Versionen und Updates.
3

Validieren

Führen Sie in Ihrer Shell claude plugin validate --strict ./your-plugin aus. Ein sauberer Durchlauf druckt ✔ Validation passed.
  • In CI: Behalten Sie --strict bei, das auch den Durchlauf mit Exit-Code 1 bei Warnungen wie einem unbekannten Manifest-Feld oder einer fehlenden version fehlschlagen lässt. Lassen Sie --strict weg, wenn Sie sich im vorherigen Schritt entschieden haben, version wegzulassen.
  • Pfade: Die Validierung meldet Komponentenpfade, die nicht mit ./ beginnen. Beziehen Sie sich in Hook-Befehlen und MCP-Server-Konfigurationen auf Dateien als ${CLAUDE_PLUGIN_ROOT}/.... Siehe Pfadregeln.
4

Installieren Sie es von einem lokalen Marketplace

Fügen Sie in Ihrer Shell einen lokalen Marketplace hinzu, der das Plugin mit claude plugin marketplace add ./path-to-marketplace auflistet, installieren Sie das Plugin davon, und starten Sie eine Sitzung, um zu bestätigen, dass es geladen wird.
5

Füllen Sie die Metadaten aus, die Benutzer sehen

Setzen Sie description, author, homepage und repository in plugin.json, und fügen Sie eine README.md im Plugin-Root hinzu. homepage muss als URL analysierbar sein. Die Manifest-Referenz listet jedes Feld auf.
6

Führen Sie Ihre Eval-Suite aus

Wenn Sie eine Eval-Suite haben, führen Sie claude plugin eval in Ihrer Shell aus. Sie führt die Testfälle des Plugins aus und bewertet die Ergebnisse, was Regressionen erfasst, wenn Sie das Plugin ändern. Siehe Testen Sie Plugins mit Evals.

​
Teilen Sie ein Plugin ohne einen Marketplace

Wenn sich das Plugin in einem Git-Repository befindet, können Personen es klonen und den Checkout laden, oder Claude Code von ihrer Shell mit --plugin-url starten, das auf eine .zip zeigt, die Sie an eine Veröffentlichung anhängen. Um Ihre nächste Version zu erhalten, pullen oder laden sie erneut herunter. Wenn es sich nicht in einem Repository befindet, senden Sie ihnen das Verzeichnis oder eine .zip davon. Sie laden es auf eine von zwei Arten:
  • Für eine Sitzung: Sie starten Claude Code von ihrer Shell mit claude --plugin-dir ./deploy-helper, wobei der Pfad der Klon, der entpackte Ordner oder die .zip selbst ist. Siehe Flags, die ein Plugin für eine Sitzung laden.
  • Für jede Sitzung: Sie verschieben das Plugin-Verzeichnis mit seiner .claude-plugin/plugin.json unter ~/.claude/skills/, damit Claude Code es in jeder Sitzung lädt.
Das Hinzufügen einer .claude-plugin/marketplace.json zu demselben Repository ist das, was Personen ermöglicht, nach Name zu installieren und mit einem Befehl zu aktualisieren; siehe Veröffentlichen Sie über Ihren eigenen Marketplace.

​
Versenden Sie ein Plugin mit Ihrem eigenen Tool

Wenn Sie eine CLI oder SDK verwalten, veröffentlichen Sie das Plugin in einem Marketplace und lassen Sie Ihren Installer oder die Post-Install-Nachricht die zwei Befehle ausführen oder drucken, die ein Benutzer benötigt: claude plugin marketplace add <source>, dann claude plugin install <name>@<marketplace>. Für die In-Session-Erkennung, wenn jemand Ihr Tool verwendet, siehe Empfehlen Sie Ihr Plugin von Ihrer CLI.

​
Veröffentlichen Sie über Ihren eigenen Marketplace

Ihr eigener Marketplace ist eine .claude-plugin/marketplace.json-Datei, die Ihr Plugin auflistet und zu einem Git-Repository hinzugefügt wird. Sobald sich die Datei im Repository befindet, wird das Plugin veröffentlicht, ohne Einreichungsformular. Sie können die Datei im eigenen Repository des Plugins oder in einem separaten aufbewahren.

​
Fügen Sie die Marketplace-Datei zu Ihrem Repository hinzu

Um vom eigenen Repository des Plugins aus zu veröffentlichen, speichern Sie die Marketplace-Datei neben plugin.json in .claude-plugin/, mit einem Eintrag, dessen source "./" ist, das Repository-Root. Geben Sie dem Eintrag denselben name wie plugin.json, gemäß Halten Sie den Eintragnamen und den Manifest-Namen gleich:
.claude-plugin/marketplace.json
Führen Sie in Ihrer Shell claude plugin validate . im Repository aus, um die Datei vor dem Push zu überprüfen. Erstellen Sie einen Marketplace behandelt das Layout mit mehreren Plugins in einem Repository.

​
Kontrollieren Sie, wer installieren kann

Jeder, der das Repository klonen kann, kann davon installieren, daher ist der Marketplace auch privat, wenn das Repository privat ist. Für Hosts außer einem Git-Repository siehe Hosten Sie einen Marketplace. Um alle in einem Unternehmen zu erreichen, einschließlich Personen, die kein Git verwenden, siehe Rollout für ein ganzes Unternehmen.

​
Teilen Sie Benutzern mit, wie sie installieren

Teilen Sie Ihren Benutzern mit, den Marketplace hinzuzufügen und dann das Plugin von ihrer Shell zu installieren, wobei Sie die Quelle und Namen durch Ihre ersetzen:
  • Fügen Sie den Marketplace einmal hinzu: claude plugin marketplace add your-org/your-marketplace, wobei das Argument eine GitHub owner/repo-Kurzform, eine URL oder ein Pfad ist
  • Installieren Sie das Plugin: claude plugin install deploy-helper@your-marketplace
  • Oder tun Sie beides von innerhalb einer Sitzung: /plugin install deploy-helper --marketplace your-org/your-marketplace. Erfordert Claude Code v2.1.275 oder später. Siehe Fügen Sie einen Marketplace hinzu und installieren Sie in einem Befehl

​
Versenden Sie Updates an Benutzer

Benutzer erhalten eine Veröffentlichung, wenn sie danach fragen oder wenn Auto-Update für Ihren Marketplace aktiviert ist:
  • Auf Anfrage: claude plugin update deploy-helper@your-marketplace in der Shell des Benutzers aktualisiert den Marketplace und installiert die neue Kopie, wenn sich die Version Ihres Plugins geändert hat
  • Auto-Update: standardmäßig für Ihren Marketplace deaktiviert. Siehe Aktivieren Sie Auto-Update. Sobald aktiviert, tut es dasselbe wie claude plugin update mit einer Verzögerung nach dem Sitzungsstart
Installieren Sie Plugins behandelt die Befehle auf der Benutzerseite, und wenn Auto-Update ausgeführt wird behandelt das Timing.

​
Reichen Sie beim Community Marketplace ein

Anthropics Community Marketplace, claude-community, ist der öffentliche Marketplace, der Plugins auflistet, die über das Plugin-Verzeichnis-Einreichungsformular eingereicht wurden. Benutzer fügen den Community Marketplace in einer Claude Code-Sitzung mit /plugin marketplace add anthropics/claude-plugins-community hinzu und installieren davon als @claude-community. Für die Unterschiede zwischen dem Community Marketplace und dem offiziellen Marketplace siehe Anthropics Marketplaces. Um Ihr Plugin beim Community Marketplace einzureichen, verwenden Sie eines der In-App-Formulare: Das claude.ai-Formular erfordert eine Team- oder Enterprise-Organisation und die Directory-Berechtigung, die Eigentümer standardmäßig haben. Einzelne Autoren, die nicht Teil einer Team- oder Enterprise-Organisation sind, können stattdessen das Console-Formular verwenden. Führen Sie in Ihrer Shell claude plugin validate ./your-plugin lokal aus, bevor Sie einreichen, wobei Sie ./your-plugin durch den Pfad zu Ihrem Plugin-Verzeichnis ersetzen. Wenn die Validierung erfolgreich ist, druckt Claude Code ✔ Validation passed, oder ✔ Validation passed with warnings, wenn es Warnungen gibt. Warnungen führen nicht zu Validierungsfehlern; fügen Sie --strict hinzu, um sie als Fehler zu behandeln. Aufgelistete Plugins erscheinen im anthropics/claude-plugins-community-Katalog, in fast jedem Fall an einen bestimmten Commit SHA angeheftet. Es kann eine Verzögerung zwischen der Einreichung und dem Erscheinen Ihres Plugins in marketplace.json geben. Um zu überprüfen, ob Ihr Plugin bereits installierbar ist, suchen Sie nach seinem Namen im Community-Katalog. Der offizielle Marketplace, claude-plugins-official, akzeptiert keine Einreichungen über diese Formulare. Wenn Sie mit einem Anthropic-Partner-Kontakt zusammenarbeiten, fragen Sie ihn nach einer Auflistung im offiziellen Marketplace.

​
Versenden Sie Updates, Umbenennungen und Entfernungen

​
Veröffentlichen Sie eine neue Version

Wenn Sie über Ihren eigenen Marketplace veröffentlichen und Ihre plugin.json version setzt, erhöhen Sie sie und pushen Sie. Benutzer, die claude plugin update ausführen oder Auto-Update aktiviert haben, erhalten dann die neue Version, wie unter Versenden Sie Updates an Benutzer beschrieben.

​
Markieren Sie eine Veröffentlichung

Markieren Sie die Veröffentlichung in Git, wenn andere Plugins einen Versionsbereich auf Ihrem deklarieren, da diese Bereiche gegen Tags aufgelöst werden. Andernfalls benötigen Sie keinen Tag. Um zu markieren, führen Sie claude plugin tag in Ihrer Shell aus dem Plugin-Verzeichnis aus. Es erstellt einen {name}--v{version}-Tag. Fügen Sie --push hinzu, um den Tag an origin zu senden. Die plugin tag-Referenz listet ihre Flags auf.

​
Benennen Sie ein Plugin um oder entfernen Sie es

Ändern Sie niemals den name eines veröffentlichten Plugins. Nach einer Umbenennung verlieren Benutzer, die es bereits installiert haben, das Plugin, da ihre Installation unter dem alten Namen aufgezeichnet ist. Ein renames-Eintrag in Ihrer Marketplace-Datei migriert sie stattdessen. Ändern Sie displayName, wenn Sie ein anderes Label möchten. Wenn eine Umbenennung unvermeidlich ist, verwenden Sie die renames-Zuordnung der Marketplace-Datei, damit vorhandene Installationen migrieren, anstatt mit Plugin "<name>" not found in marketplace fehlzuschlagen. Um ein Plugin aus dem Marketplace zu entfernen, oder für die vollständigen renames-Details, siehe Benennen Sie ein Plugin um oder entfernen Sie es auf der Hosting-Seite. Die Marketplace-Referenz hat das Feld.

​
Deklarieren Sie Abhängigkeiten

Wenn Ihr Plugin ein anderes Plugin aus demselben Marketplace benötigt, das aktiviert sein soll, listen Sie es im dependencies-Array von plugin.json auf. Jeder Eintrag ist ein einfacher Name oder ein Objekt mit einem Semver-version-Bereich. Wenn ein Benutzer Ihr Plugin installiert, installiert und aktiviert Claude Code auch die Abhängigkeit. Plugin-Abhängigkeiten behandelt die Bereichssyntax, Marketplace-übergreifende Abhängigkeiten und wie Benutzer Abhängigkeiten, die sie nicht mehr benötigen, bereinigen.

​
Nächste Schritte