Ein Marketplace hosten und verwalten

​

Hosten Sie Ihren Marketplace

​

Registrieren Sie den Marketplace für alle in einem Repository

​

Vermeiden Sie relative Pfad-Einträge in einem URL-gehosteten Marketplace

​

Bearbeiten Sie Plugins direkt in einem gemeinsamen Verzeichnis

​

Halten Sie Plugin-Dateien aus Git LFS fern

​

Teilen Sie Dateien innerhalb eines Marketplace mit Symlinks

• Innerhalb des eigenen Verzeichnisses des Plugins: Der Symlink wird als relativer Symlink im Cache beibehalten, sodass er zur Laufzeit weiterhin zum kopierten Ziel aufgelöst wird.
• Anderswo innerhalb desselben Marketplace: Der Symlink wird dereferenziert. Der Inhalt des Ziels wird an seiner Stelle in den Cache kopiert. Dies ermöglicht es dem skills/-Verzeichnis eines Meta-Plugins, auf Skills zu verlinken, die von anderen Plugins im Marketplace definiert sind.
• Außerhalb des Marketplace: Der Symlink wird aus Sicherheitsgründen übersprungen.

ln -s ../../shared-plugin/skills/foo ./skills/foo

​

Verteilen Sie über Organisationseinstellungen

• Marketplace-Repository: Auf github.com und gitlab.com muss es privat oder intern sein
• Plugin-Quellen: Jede Plugin-Quelle muss vom Typ github, url oder git-subdir sein, oder ein relativer Pfad, der mit ./ beginnt
• Top-Level bin/-Verzeichnis: claude.ai lehnt ein Plugin ab, das eines hat, und synchronisiert den Rest des Marketplace. Die Fehlermeldung beginnt mit Plugin contains a top-level bin/ directory. Halten Sie ausführbare Dateien in einem anderen Verzeichnis, wie scripts/, und verweisen Sie auf sie als ${CLAUDE_PLUGIN_ROOT}/scripts/<name> aus Ihren Hooks oder MCP-Server-Konfigurationen

​

Gewähren Sie Zugriff auf einen privaten Marketplace

• GitHub owner/repo: Claude Code prüft ssh -T git@github.com und klont über SSH, wenn die Prüfung erfolgreich ist. Wenn die Prüfung fehlschlägt oder der SSH-Klon selbst fehlschlägt, klont es über HTTPS. Benutzer auf Maschinen ohne GitHub SSH-Schlüssel können CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 setzen, um die Prüfung zu überspringen und über HTTPS zu klonen.
• git@host:path.git: SSH.
• https://example.com/repo.git: HTTPS.

• SSH: Der Schlüssel muss ohne Passphrase-Eingabeaufforderung funktionieren, zum Beispiel weil er in ssh-agent geladen ist. Der Host muss bereits in known_hosts sein.
• HTTPS: Claude Code lässt den Git-Credential-Helper des Benutzers aktiviert, verbietet ihm aber zu fragen. Eine Anmeldedaten, die der Helper bereits speichert, funktioniert; eine, die er fragen müsste, schlägt fehl. Auf GitHub speichert gh auth login gefolgt von gh auth setup-git eine.

​

Bedienen Sie Benutzer, die kein Git-Host-Konto haben

• archive: eine ZIP-Datei, die über HTTPS heruntergeladen wird. Benutzer benötigen weder git noch ein Konto, nur Netzwerkzugriff auf die URL. Erfordert Claude Code v2.1.224 oder später. Fixieren Sie jedes Archiv mit sha256, damit Claude Code einen geänderten Download ablehnt. Um Anmeldedaten mit dem Download zu senden, siehe Authentifizieren Sie Archive-Downloads.
• Ein öffentliches Git-Repository: Claude Code klont eine öffentliche url- oder git-subdir-Quelle über HTTPS ohne Anmeldedaten, wenn der Eintrag eine https://-URL angibt. Für eine github-Quelle oder eine git-subdir-Quelle, die als owner/repo geschrieben ist, setzen Benutzer ohne GitHub SSH-Schlüssel CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1.

​

Was die Hintergrund-Autoupdate mit Anmeldedaten macht

• SSH-Remotes: Ein Schlüssel, der in ssh-agent geladen ist, authentifiziert die Prüfung.
• HTTPS-Remotes mit gespeicherten Anmeldedaten: Ein Helper, der gespeicherte Anmeldedaten ohne Aufforderung bereitstellen kann, authentifiziert die Prüfung. Git Credential Manager, der macOS Keychain-Helper und git-credential-store funktionieren auf diese Weise, sobald sie Anmeldedaten für den Host halten.
• HTTPS-Remotes mit einem Helper, der fragen muss: Der Helper kann nicht im Hintergrund antworten. Die Aktualisierung schlägt stillschweigend fehl und der vorhandene Checkout bleibt an Ort und Stelle, sodass die Plugins des Benutzers aus dem letzten synchronisierten Zustand weiterhin funktionieren.

• Der Checkout ist auf dem neuesten Stand: Claude Code lässt ihn, wie er ist.
• Die Prüfung findet neue Commits oder schlägt fehl, weil sie den Remote nicht erreichen oder sich nicht authentifizieren kann: Claude Code klont den Marketplace erneut und ersetzt den vorhandenen Checkout durch den neuen Klon. Wenn dieser Klon fehlschlägt, bleibt der vorhandene Checkout an Ort und Stelle. Der erneute Klon kann bei großen Repositories nach 120 Sekunden abbrechen.

• Speichern Sie Anmeldedaten: Melden Sie sich zuerst beim Credential-Helper an, damit er Anmeldedaten für den Host hält. Für GitHub führen Sie gh auth login aus, dann gh auth setup-git.
• Halten Sie den Checkout bei Fehler: Wenn der Benutzer CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1 setzt, behält Claude Code den vorhandenen Checkout bei, ohne den erneuten Klon zu versuchen, wenn die Hintergrund-Prüfung den Remote nicht erreichen oder sich nicht authentifizieren kann. Plugins funktionieren weiterhin aus dem letzten synchronisierten Zustand.

​

Rollen Sie für ein ganzes Unternehmen aus

• Eintrag-Quellen, die kein Git-Konto benötigen: Bedienen Sie Benutzer, die kein Git-Host-Konto haben
• Ein vorausgefülltes Plugins-Verzeichnis: Seed-Container und CI, das auch Benutzer bedient, die kein Git-Host-Konto haben
• claude.ai-Organisationseinstellungen: Verteilen Sie über Organisationseinstellungen, wo die Git-Anmeldedaten Ihrer Benutzer nicht beteiligt sind

​

Halten Sie Benutzer auf dem neuesten Stand

​

Schalten Sie Autoupdate ein

• Teilen Sie Benutzern mit, dass sie es einschalten sollen: Jeder Benutzer geht zu Marketplaces in /plugin, wählt Ihren Marketplace aus und wählt Enable auto-update.
• Bitten Sie einen Administrator, es zu setzen: Wenn ein Administrator "autoUpdate": true auf dem extraKnownMarketplaces-Eintrag Ihres Marketplace in verwalteten Einstellungen setzt, ist es für alle eingeschaltet, die diese Einstellungen erhalten. Siehe Legen Sie die Update-Richtlinie fest.

​

Geben Sie eine neue Version frei

• Erhöhen Sie version bei jeder Veröffentlichung: Benutzer bleiben auf ihrer zwischengespeicherten Kopie, bis sich der String ändert. Wenn Sie "version": "1.0.0" setzen und neue Commits hochladen, ohne es zu ändern, erhalten Benutzer sie nicht.
• Lassen Sie version weg: Benutzer verfolgen stattdessen Ihre Commits. Lassen Sie version sowohl aus plugin.json als auch aus dem Marketplace-Eintrag weg.

​

Halten Sie Benutzer auf einer Version

• ref und sha auf dem Plugin-Eintrag: ref benennt einen Branch oder Tag und sha benennt einen Commit für eine github-, url- oder git-subdir-Quelle. Siehe Plugin-Quellen.
• #<ref> auf dem Befehl zum Hinzufügen: Benutzer, die your-org/your-marketplace#stable hinzufügen, erhalten diesen Branch oder Tag des Katalogs. Für zwei Release-Linien auf einmal siehe Führen Sie Release-Kanäle aus.
• <plugin>--v<version>-Tags: Ein Versionsbereich einer Abhängigkeit wird gegen diese Tags aufgelöst. Siehe Geben Sie ein Plugin frei, auf das andere angewiesen sind.

​

Ändern Sie den Befehl einer Befehl-Quelle

• Keine weiteren Hintergrund-Läufe: Der einmalige Lauf pro Sitzung des Befehls stoppt für diesen Benutzer, sodass die neue Ausgabe des Tools ihn nicht erreicht.
• Ein Eintrag in der Registerkarte /plugin Errors: Der Eintrag zeigt den neuen Befehl und den claude plugin update-Befehl zum Ausführen.

​

Führen Sie Release-Kanäle aus

{
  "name": "stable-tools",
  "owner": { "name": "Your Org" },
  "plugins": [
    { "name": "code-formatter", "source": { "source": "github", "repo": "your-org/code-formatter", "ref": "stable" } }
  ]
}

{
  "name": "latest-tools",
  "owner": { "name": "Your Org" },
  "plugins": [
    { "name": "code-formatter", "source": { "source": "github", "repo": "your-org/code-formatter", "ref": "latest" } }
  ]
}

​

Benennen Sie ein Plugin um oder entfernen Sie es

​

Migrieren Sie Benutzer mit einer Umbenennungs-Map

{
  "name": "your-marketplace",
  "owner": { "name": "Your Org" },
  "plugins": [
    { "name": "code-formatter", "source": "./plugins/code-formatter" }
  ],
  "renames": {
    "formatter": "code-formatter",
    "legacy-linter": null
  }
}

• Umbenannter Eintrag: Das Plugin lädt unter seinem neuen Namen. claude plugin list und die Details des Plugins unter /plugin zeigen Renamed to "code-formatter" in the "your-marketplace" marketplace einmal, und Claude Code schreibt den alten Schlüssel in den neuen in enabledPlugins und pluginConfigs in den Benutzer-, Projekt- und lokalen Einstellungsbereichen um.
• null-Eintrag: Der alte Schlüssel wird aus diesen Bereichen gelöscht und der Benutzer sieht Removed from the "your-marketplace" marketplace.
• In verwalteten Einstellungen aktiviert: Das Plugin lädt immer noch unter seinem neuen Namen, aber Claude Code kann verwaltete Einstellungen nicht umschreiben, daher wiederholt sich die Benachrichtigung, bis ein Administrator enabledPlugins dort aktualisiert.

​

Deinstallieren Sie entfernte Plugins von den Maschinen der Benutzer

1. Vergleicht, was Benutzer von Ihrem Marketplace installiert haben, gegen die Einträge und die renames-Map, und behandelt jedes Plugin, das weder aufgelistet noch umbenannt ist, als entfernt.
2. Deinstalliert jedes entfernte Plugin aus den Benutzer-, Projekt- und lokalen Bereichen. Plugins, die nur verwaltete Einstellungen installiert haben, bleiben an Ort und Stelle.
3. Listet jedes entfernte Plugin unter einer Flagged-Überschrift in /plugin mit dem Status Removed from marketplace auf.

​

Authentifizieren Sie Archive-Downloads

• Die url-Quelle des Marketplace: Die url-Quelle, von der Sie den Marketplace registriert haben, wie ein extraKnownMarketplaces-Eintrag.
• Der Eintrag des Plugins: Auf Claude Code v2.1.238 oder später können Sie es stattdessen auf dem marketplace.json-Eintrag des Plugins setzen, neben source.

​

Fügen Sie einen headersHelper zu einem Plugin-Eintrag hinzu

{
  "name": "my-plugin",
  "description": "Formatting commands for internal services",
  "strict": false,
  "source": {
    "source": "archive",
    "url": "https://registry.example.com/plugins/my-plugin-2.1.0.zip"
  },
  "headersHelper": "/opt/bin/mint-registry-token.sh"
}

​

Schreiben Sie den headersHelper-Befehl

• Befehlstext: Höchstens 500 Zeichen druckbares ASCII, ohne einen Lauf von vier oder mehr Leerzeichen.
• Ausgabe: Drucken Sie ein JSON-Objekt von Header-Namen und String-Werten auf stdout, dann beenden Sie 0 innerhalb von 10 Sekunden.
• Shell und Arbeitsverzeichnis: Claude Code führt den Befehl durch sh oder durch cmd.exe unter Windows aus. Das Arbeitsverzeichnis ist das Konfigurationsverzeichnis, das ~/.claude oder CLAUDE_CONFIG_DIR ist. Geben Sie einen absoluten Pfad oder einen Befehl auf PATH an, da ein relativer Pfad gegen dieses Verzeichnis aufgelöst wird, nicht gegen das Projekt des Benutzers.
• Variablen, die Claude Code entfernt: Wenn der Befehl in einem marketplace.json-Eintrag oder in einer Projekt-.claude/settings.json oder .claude/settings.local.json gesetzt ist, entfernt Claude Code aus der Umgebung jede Variable, deren Name wie eine Anmeldedaten aussieht, nach der gleichen Regel, die es auf einen MCP headersHelper anwendet. ANTHROPIC_API_KEY und MY_REGISTRY_TOKEN werden beide entfernt, daher lesen Sie die Anmeldedaten aus einer Datei oder einem Credential-Store. Diese Entfernung gilt nicht für einen Befehl, der in Benutzereinstellungen, einer --settings-Datei oder verwalteten Einstellungen gesetzt ist.
• Variablen, die Claude Code setzt: CLAUDE_CODE_MARKETPLACE_URL und CLAUDE_CODE_MARKETPLACE_NAME für den Befehl einer url-Quelle, und CLAUDE_CODE_PLUGIN_NAME und CLAUDE_CODE_PLUGIN_ARCHIVE_URL für den Befehl eines Eintrags. CLAUDE_CODE_MARKETPLACE_NAME ist beim ersten Abruf nach dem Hinzufügen eines Marketplace durch URL nicht gesetzt, da dieser Abruf der ist, der den Namen liefert.

{"Authorization": "Bearer eyJhbGciOiJSUzI1NiJ9"}

​

Wenn Claude Code einen headersHelper-Befehl überspringt oder seine Ausgabe ablegt

• Befehl schlägt fehl: Wenn der Befehl mit Nicht-Null beendet wird, über 10 Sekunden läuft oder etwas anderes als ein JSON-Objekt von String-Werten druckt, findet der Abruf oder Download, für den der Befehl ausgeführt wurde, nicht statt.
• Marketplace-URL beginnt nicht mit https://: Der Befehl dieser url-Quelle wird nicht ausgeführt, und Anfragen tragen nur die in ihrem headers-Feld aufgelisteten Header.
• Umleitung verlässt den Ursprung: Wenn ein Download von der Archive-URL-Ursprung umgeleitet wird, trägt die umgeleitete Anfrage keine headers-Werte oder Befehlsausgabe von der Marketplace url-Quelle oder dem Plugin-Eintrag.
• Eintrag setzt einen Routing- oder Identity-Header: Claude Code legt Request-Routing- und Client-Identity-Namen wie Host, Cookie und X-Forwarded-* aus einem Eintrag headers und Befehlsausgabe ab und behält Authentifizierungsnamen wie Authorization. Jeder marketplace.json-Eintrag wird auf diese Weise gefiltert. Für einen Inline-Plugin-Eintrag in Einstellungen siehe extraKnownMarketplaces.
• Befehl in den Einstellungen eines --add-dir-Verzeichnisses gesetzt: Der Befehl wird ignoriert, auf einer url-Quelle und auf einem Inline-Plugin-Eintrag gleichermaßen, und nur die headers dieser Datei werden gesendet.
• Verwaltete Einstellungen blockieren den Befehl: Das Setzen von disableCommandPluginSources auf true blockiert headersHelper-Befehle, und allowManagedHooksOnly blockiert sie auch, es sei denn, disableCommandPluginSources ist explizit false. Unter beiden Blöcken führt Claude Code den Befehl immer noch für einen Marketplace aus, den verwaltete Einstellungen selbst deklarieren.

​

Wie Benutzer einen headersHelper-Befehl akzeptieren

​

Installationen und Updates, die einen Befehl ablehnen, anstatt zu fragen

• Installation mehrerer Plugins auf einmal, von einer Plugin-Suggestion oder als Abhängigkeit eines anderen Plugins: Claude Code weigert das Plugin, das den Befehl hat, und leitet den Benutzer zur eigenen Ansicht dieses Plugins in /plugin. Die anderen Plugins in einer Massen-Installation installieren immer noch. Ein Plugin, das vom abgelehnten Plugin abhängt, schlägt bei der Installation fehl, bis der Benutzer das abgelehnte Plugin selbst installiert.
• Hintergrund-Autoupdate oder Sitzungsstart für ein Plugin, dessen Archiv nie heruntergeladen wurde: Claude Code listet das Plugin in der Registerkarte /plugin Errors auf, damit der Benutzer weiß, dass er es selbst installieren oder aktualisieren muss.

​

Wenn der Befehl einer Marketplace url-Quelle ausgeführt wird

​

Hängen Sie von anderen Plugins ab und empfehlen Sie sie

• Versionsbereiche: Eine Abhängigkeit kann einen Semver-Bereich tragen.
• Cross-Marketplace-Abhängigkeiten: Eine Abhängigkeit von einem anderen Marketplace installiert nur, wenn Ihr Marketplace diesen Marketplace in allowCrossMarketplaceDependenciesOn auflistet.

​

Arbeiten Sie um, was ein Marketplace nicht kann

• Beschränken Sie, was sonst Benutzer installieren: Die Marketplace-Zulassungsliste ist eine verwaltete Einstellung, strictKnownMarketplaces. Siehe Beschränken Sie, was Benutzer installieren können.
• Installieren oder aktivieren Sie ein Plugin, ohne dass der Benutzer fragt: Kein Eintrag-Feld installiert ein Plugin. Verwaltete enabledPlugins tut das für eine Flotte; siehe Vorinstallieren und erfordern Sie Plugins.
• Zeigen Sie verschiedene Einträge verschiedenen Benutzern: Einträge tragen kein Audience-Feld, und jeder Benutzer, der den Marketplace hinzufügt, sieht den gesamten Katalog. Hosten Sie separate Marketplaces für separate Audiences.
• Markieren Sie ein Plugin als veraltet: Es gibt keinen Veraltungszustand. Die Option ist, den Eintrag zu entfernen, seinen Namen in renames auf null zu ordnen und optional forceRemoveDeletedPlugins zu setzen.
• Schalten Sie Autoupdate für Ihre Benutzer ein: Jeder Benutzer schaltet es unter Marketplaces in /plugin ein, oder ein Administrator setzt autoUpdate in verwalteten Einstellungen. Siehe Schalten Sie Autoupdate ein.
• Tragen Sie Git-Anmeldedaten: Kein Marketplace-Feld hält ein Git-Token. Der Zugriff auf einen Git-gehosteten Marketplace oder ein Plugin folgt dem Git-Setup des Benutzers, pro Gewähren Sie Zugriff auf einen privaten Marketplace. Für archive-Quellen kann ein Eintrag stattdessen headers oder headersHelper setzen.

​

Nächste Schritte

• Marketplace-Referenz: marketplace.json-Felder, Quelltypen und Validierungsmeldungen
• Verwalten Sie Plugins für Ihre Organisation: Fordern Sie an, beschränken Sie oder seeden Sie Ihren Marketplace in den Maschinen Ihrer Organisation
• Plugin-Abhängigkeiten: Taggen Sie Releases, damit Plugins, die von Ihrem abhängen, Versionen auflösen können
• Beheben Sie Probleme mit Plugins: Die Fehler, die Ihre Benutzer beim Hinzufügen oder Aktualisieren von Ihrem Marketplace sehen