Wenn Sie einen Plugin-Marketplace für Ihre Organisation betreiben, können Sie Claude Code so konfigurieren, dass bestimmte Plugins Benutzern basierend auf ihrer aktuellen Arbeit vorgeschlagen werden. Fügen Sie einen relevance-Block zum Plugin-Eintrag in marketplace.json hinzu und genehmigen Sie den Marketplace in verwalteten Einstellungen. Wenn eine Benutzersitzung einem der deklarierten Signale entspricht, zeigt Claude Code einen Installationsvorschlag für dieses Plugin an.
Marketplace-deklarierte Vorschläge sind pro Marketplace durch verwaltete Einstellungen optional. Kein relevance-Deklaration eines Marketplace erzeugt Vorschläge, bis ein Administrator ihn zur Genehmigungsliste hinzufügt, einschließlich des offiziellen Anthropic-Marketplace. Claude Code enthält auch einen integrierten Vorschlag, der unabhängig von dieser Genehmigungsliste ist; dieser Tipp und alle Marketplace-deklarierten Tipps sind deaktiviert, wenn spinnerTipsEnabled auf false gesetzt ist.
Diese Funktion erfordert Claude Code v2.1.152 oder später. Ältere Clients ignorieren das relevance-Feld.
Diese Seite ist für Marketplace-Betreiber und Enterprise-Administratoren. Wenn Sie Plugins installieren möchten, siehe Plugins entdecken und installieren.
Funktionsweise
Jeder Plugin-Eintrag in marketplace.json kann ein relevance-Objekt enthalten. Das Objekt benennt ein Thema und ein oder mehrere Signale. Ein Signal ist ein Muster, das Claude Code gegen die aktuelle Sitzung testet, z. B. das Arbeitsverzeichnis oder Dateien, die Claude gelesen hat.
Signal-Matching erfolgt lokal auf dem Computer des Benutzers. Das Matching erzeugt keinen Netzwerkverkehr und meldet nicht, welche Signale übereinstimmten oder deren Werte an Anthropic oder den Marketplace-Betreiber.
Wenn ein Signal übereinstimmt und das Plugin nicht bereits installiert ist, zeigt Claude Code das Plugin an drei Stellen an:
- Spinner-Tipp: Eine Meldung „Arbeiten mit Thema? Installieren Sie das Plugin-Plugin” mit dem
/plugin install-Befehl wird unter dem Spinner angezeigt, während Claude antwortet.
- Sitzungsstart-Vorschlag: Wenn das
cwd-Signal dem Arbeitsverzeichnis entspricht, wird eine einzeilige plugin suggestion: <name>@<marketplace> · /plugin-Benachrichtigung vor dem ersten Turn angezeigt. Diese Oberfläche erfordert Claude Code v2.1.153 oder später.
/plugin Discover-Registerkarte: Das Plugin wird oben in der Discover-Liste mit einer Anmerkung wie „für dieses Verzeichnis empfohlen” oder „für Stripe-Befehle empfohlen” angeheftet. Diese Oberfläche erfordert Claude Code v2.1.154 oder später.
Der Spinner-Tipp und die Sitzungsstart-Benachrichtigung sind Teil des Spinner-Tipps-Systems. Beide sind deaktiviert, wenn der Benutzer oder das Projekt spinnerTipsEnabled auf false setzt oder wenn ein benutzerdefinierter spinnerTipsOverride mit excludeDefault konfiguriert ist. Das Anheften auf der Discover-Registerkarte ist unabhängig von Tipp-Einstellungen.
Claude Code installiert ein Plugin niemals automatisch. Der Benutzer bestätigt immer.
Relevanz zu einem Plugin-Eintrag hinzufügen
Fügen Sie ein relevance-Objekt zum Plugin-Eintrag in Ihrer marketplace.json hinzu. Das folgende Beispiel deklariert, dass das terraform-helpers-Plugin relevant ist, wenn Claude eine .tf-Datei liest oder wenn Claude terraform ausführt:
{
"name": "acme-corp-plugins",
"owner": { "name": "Acme Platform Team" },
"plugins": [
{
"name": "terraform-helpers",
"source": "./plugins/terraform-helpers",
"description": "Acme conventions and helpers for Terraform",
"relevance": {
"topic": "Terraform",
"signals": {
"cli": ["terraform"],
"filesRead": ["**/*.tf"]
}
}
}
]
}
relevance-Block aber ohne übereinstimmendes Signal verhält sich wie jeder andere Marketplace-Eintrag. Es wird in der Discover-Liste an seiner normalen Position angezeigt und wird niemals als Spinner-Tipp angezeigt.
Feldverweis
relevance
| Feld | Typ | Beschreibung |
|---|
topic | string | Optional. Der Ausdruck, der „Arbeiten mit Thema?” im Spinner-Tipp ausfüllt. Oft der Produktname, z. B. Stripe. Verwenden Sie eine Domäne wie design, wenn der Plugin-Name nicht natürlich als Thema gelesen wird. Standardmäßig der Plugin-Name mit jedem Bindestrich-Segment kapitalisiert. Die Sitzungsstart-Benachrichtigung verwendet diesen Wert nicht. Maximal 64 Zeichen. |
signals | object | Matcher, die bestimmen, wann das Plugin relevant ist. Mindestens ein Signal ist erforderlich, damit das Plugin vorschlagbar ist. Siehe die Tabelle unten. |
relevance.signals
| Feld | Typ | Beschreibung |
|---|
cwd | array of strings | Glob-Muster, die gegen das Arbeitsverzeichnis der Sitzung abgeglichen werden. Abgeglichen als absoluter Pfad und, wenn sich in einem Git-Repository befindet, als Pfad relativ zum Repository-Root. Schrägstrich-normalisiert und Groß-/Kleinschreibung-insensitiv. Jedes Muster passt zum Verzeichnis selbst und allem darunter, daher verhalten sich infra, infra/ und infra/** identisch. Dies ist das einzige Signal, das beim Sitzungsstart vor dem ersten Turn übereinstimmen kann. Maximal 10 Muster mit je 256 Zeichen. |
cli | array of strings | Befehlsnamen aus Shell-Befehlen, die Claude in dieser Sitzung ausgeführt hat, z. B. ["stripe"]. Gilt auf jeder Plattform: Befehle, die unter Windows über PowerShell oder Git Bash ausgeführt werden, werden auf die gleiche Weise aufgezeichnet. Claude Code zeichnet einen Befehlsnamen pro Shell-Tool-Aufruf auf: das erste Token nach allen führenden Umgebungsvariablenzuweisungen und sudo. Zusammengesetzte Befehle tragen nur ihren führenden Befehl bei, daher zeichnet cd infra && terraform plan cd auf, nicht terraform. Exakte Übereinstimmung. Maximal 10 Einträge mit je 64 Zeichen. |
hosts | array of strings | Hostnamen in http://- oder https://-URLs in Bash-Befehlen dieser Sitzung, z. B. ["api.stripe.com"]. Nur reiner Hostname in Kleinbuchstaben: kein Schema, Port oder Pfad. Exakte Groß-/Kleinschreibung-insensitive Übereinstimmung. Maximal 20 Einträge mit je 128 Zeichen. |
filesRead | array of strings | Glob-Muster, die gegen die Pfade von Dateien abgeglichen werden, die Claude in dieser Sitzung gelesen hat, z. B. ["**/*.tf"]. Schrägstrich-normalisiert und Groß-/Kleinschreibung-insensitiv. Maximal 10 Muster mit je 256 Zeichen. |
manifestDeps | array of objects | Abhängigkeiten, die in Paketmanifesten deklariert sind, die Claude in dieser Sitzung gelesen hat. Jeder Eintrag ist { "file": "...", "pattern": "..." }, wobei file ein regulärer Ausdruck ist, der gegen den Pfad der Manifestdatei abgeglichen wird, wie er im Sitzungszustand aufgezeichnet ist, typischerweise ein absoluter Pfad, und pattern ein regulärer Ausdruck ist, der gegen den Inhalt dieser Datei abgeglichen wird. Verankern Sie file am Ende, z. B. [/\\\\]package\\.json$ in JSON-escaped-Form, da ein am Anfang verankertes Muster niemals einen absoluten Pfad passt. Pfade sind nicht Separator-normalisiert für dieses Signal, daher verwenden Windows-Pfade Backslashes. Manifestdateien größer als 512 KB werden übersprungen. Beide Werte sind JavaScript-RegExp-Quellzeichenfolgen mit maximal 256 Zeichen. file passt Groß-/Kleinschreibung-insensitiv. pattern ist Groß-/Kleinschreibung-sensitiv. Maximal 10 Einträge. |
cli, hosts, filesRead und manifestDeps benötigen Sitzungsverlauf, daher können sie nur auf dem Spinner-Tipp und der Discover-Registerkarte übereinstimmen. Nur cwd kann beim Sitzungsstart übereinstimmen. Die Signale filesRead und manifestDeps testen den aufgezeichneten Dateizustand der Sitzung, der auch Dateien enthält, die Claude geschrieben oder bearbeitet hat, und automatisch geladene CLAUDE.md-Speicherdateien.
Das folgende Beispiel verwendet manifestDeps, um ein Stripe-Plugin vorzuschlagen, sobald Claude eine package.json gelesen hat, die von stripe abhängt. Das file-Muster verwendet [/\\\\], damit es sowohl Schrägstrich- als auch Backslash-Pfad-Trennzeichen passt, und \\., damit der Punkt literal ist. In JSON wird jeder Backslash im regulären Ausdruck zweimal geschrieben.
{
"name": "stripe-helpers",
"source": "./plugins/stripe-helpers",
"relevance": {
"topic": "Stripe",
"signals": {
"manifestDeps": [
{
"file": "[/\\\\]package\\.json$",
"pattern": "\"stripe\"\\s*:"
}
]
}
}
}
Unbekannte Felder unter relevance und relevance.signals werden beim Laden ignoriert, damit ältere Claude Code-Clients Ihren Marketplace weiterhin laden. Führen Sie claude plugin validate aus, um sie als Warnungen anzuzeigen.
Vorschläge in verwalteten Einstellungen aktivieren
Das Deklarieren von relevance in marketplace.json ist allein nicht ausreichend. Ein Administrator muss den Marketplace in verwalteten Einstellungen genehmigen, bevor seine Vorschläge Benutzern angezeigt werden.
Fügen Sie den Marketplace-Namen zu pluginSuggestionMarketplaces hinzu. Für jeden Marketplace außer dem offiziellen Anthropic-Marketplace deklarieren Sie auch die Marketplace-Quelle in denselben verwalteten Einstellungen, entweder als Eintrag dieses Namens in extraKnownMarketplaces oder als Eintrag in strictKnownMarketplaces. Der genehmigte Name wird ignoriert, wenn der auf dem Computer registrierte Marketplace aus einer anderen Quelle stammt. Dies verhindert, dass eine unabhängige Quelle sich unter einem genehmigten Namen registriert, um ihre Plugins in Ihrer Organisation vorgeschlagen zu bekommen.
Die folgende managed-settings.json registriert einen Organisations-Marketplace aus einem GitHub-Repository und aktiviert seine Vorschläge:
{
"extraKnownMarketplaces": {
"acme-corp-plugins": {
"source": {
"source": "github",
"repo": "acme-corp/claude-plugins"
}
}
},
"pluginSuggestionMarketplaces": ["acme-corp-plugins"]
}
{
"pluginSuggestionMarketplaces": ["claude-plugins-official"]
}
pluginSuggestionMarketplaces und extraKnownMarketplaces für vollständige Konfigurationsdetails.
Was der Benutzer sieht
Wenn ein Signal während einer Sitzung übereinstimmt, lautet der Spinner-Tipp:
Working with Terraform? Install the terraform-helpers plugin:
/plugin install terraform-helpers@acme-corp-plugins
cwd-Signal die einzeilige Benachrichtigung:
plugin suggestion: terraform-helpers@acme-corp-plugins · /plugin
/plugin Discover-Registerkarte wird das Plugin oben in den anderen Ergebnissen mit einer Anmerkung angeheftet, die das übereinstimmende Signal benennt, z. B. suggested for this directory oder suggested for terraform commands. Die Discover-Registerkarte heftet ein bestimmtes Plugin einmal an; spätere Besuche listen es in normaler Reihenfolge auf. Das Anheften auf der Discover-Registerkarte erfordert Claude Code v2.1.154 oder später. In v2.1.152 wird nur der Spinner-Tipp angezeigt; die Sitzungsstart-Benachrichtigung wird in v2.1.153 hinzugefügt.
Validieren Sie Ihren Marketplace
Führen Sie claude plugin validate gegen Ihr Marketplace-Verzeichnis aus, um den relevance-Block vor der Veröffentlichung zu überprüfen:
claude plugin validate ./my-marketplace
relevance und relevance.signals als Warnungen, kennzeichnet einen relevance-Wert, der kein Objekt ist, und lehnt einen signals.hosts-Eintrag ab, der ein Schema, einen Port oder einen Pfad enthält.
Siehe auch
