Plugin-Marktplätze - Claude Code Docs

Plugin-Marktplätze sind Kataloge verfügbarer Plugins, die es einfach machen, Claude Code-Erweiterungen zu entdecken, zu installieren und zu verwalten. Diese Anleitung zeigt Ihnen, wie Sie vorhandene Marktplätze nutzen und Ihre eigenen für die Teamverteilung erstellen.

Übersicht

Ein Marktplatz ist eine JSON-Datei, die verfügbare Plugins auflistet und beschreibt, wo sie zu finden sind. Marktplätze bieten:

Zentralisierte Entdeckung: Durchsuchen Sie Plugins aus mehreren Quellen an einem Ort
Versionsverwaltung: Verfolgen und aktualisieren Sie Plugin-Versionen automatisch
Teamverteilung: Teilen Sie erforderliche Plugins in Ihrer Organisation
Flexible Quellen: Unterstützung für Git-Repositories, GitHub-Repos, lokale Pfade und Paketmanager

Voraussetzungen

Claude Code installiert und ausgeführt
Grundlegende Vertrautheit mit dem JSON-Dateiformat
Zum Erstellen von Marktplätzen: Git-Repository oder lokale Entwicklungsumgebung

Marktplätze hinzufügen und verwenden

Fügen Sie Marktplätze mit den /plugin marketplace-Befehlen hinzu, um auf Plugins aus verschiedenen Quellen zuzugreifen:

GitHub-Marktplätze hinzufügen

Ein GitHub-Repository mit .claude-plugin/marketplace.json hinzufügen

/plugin marketplace add owner/repo

Git-Repositories hinzufügen

Ein beliebiges Git-Repository hinzufügen

/plugin marketplace add https://gitlab.com/company/plugins.git

Lokale Marktplätze für die Entwicklung hinzufügen

Lokales Verzeichnis mit .claude-plugin/marketplace.json hinzufügen

/plugin marketplace add ./my-marketplace

Direkten Pfad zur marketplace.json-Datei hinzufügen

/plugin marketplace add ./path/to/marketplace.json

Remote marketplace.json über URL hinzufügen

/plugin marketplace add https://url.of/marketplace.json

Plugins aus Marktplätzen installieren

Nachdem Sie Marktplätze hinzugefügt haben, installieren Sie Plugins direkt:

Aus einem bekannten Marktplatz installieren

/plugin install plugin-name@marketplace-name

Verfügbare Plugins interaktiv durchsuchen

/plugin

Marktplatz-Installation überprüfen

Nach dem Hinzufügen eines Marktplatzes:

Marktplätze auflisten: Führen Sie /plugin marketplace list aus, um zu bestätigen, dass er hinzugefügt wurde
Plugins durchsuchen: Verwenden Sie /plugin, um verfügbare Plugins aus Ihrem Marktplatz anzuzeigen
Installation testen: Versuchen Sie, ein Plugin zu installieren, um zu überprüfen, ob der Marktplatz ordnungsgemäß funktioniert

Team-Marktplätze konfigurieren

Richten Sie die automatische Marktplatz-Installation für Team-Projekte ein, indem Sie erforderliche Marktplätze in .claude/settings.json angeben:

{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    },
    "project-specific": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/project-plugins.git"
      }
    }
  }
}

Wenn Team-Mitglieder dem Repository-Ordner vertrauen, installiert Claude Code diese Marktplätze und alle Plugins, die im Feld enabledPlugins angegeben sind, automatisch.

Erstellen Sie Ihren eigenen Marktplatz

Erstellen und verteilen Sie benutzerdefinierte Plugin-Sammlungen für Ihr Team oder Ihre Community.

Voraussetzungen für die Marktplatz-Erstellung

Git-Repository (GitHub, GitLab oder anderes Git-Hosting)
Verständnis des JSON-Dateiformats
Ein oder mehrere Plugins zum Verteilen

Erstellen Sie die Marktplatz-Datei

Erstellen Sie .claude-plugin/marketplace.json im Repository-Root:

{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Automatic code formatting on save",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Deployment automation tools"
    }
  ]
}

Marktplatz-Schema

Erforderliche Felder

Feld	Typ	Beschreibung
`name`	string	Marktplatz-Identifikator (Kebab-Case, keine Leerzeichen)
`owner`	object	Informationen zum Marktplatz-Verwalter
`plugins`	array	Liste verfügbarer Plugins

Optionale Metadaten

Feld	Typ	Beschreibung
`metadata.description`	string	Kurze Marktplatz-Beschreibung
`metadata.version`	string	Marktplatz-Version
`metadata.pluginRoot`	string	Basispfad für relative Plugin-Quellen

Plugin-Einträge

Plugin-Einträge basieren auf dem Plugin-Manifest-Schema (mit allen Feldern als optional) plus marktplatzspezifischen Feldern (source, category, tags, strict), wobei name erforderlich ist.

Erforderliche Felder:

Feld	Typ	Beschreibung
`name`	string	Plugin-Identifikator (Kebab-Case, keine Leerzeichen)
`source`	string\|object	Woher das Plugin abgerufen werden soll

Optionale Plugin-Felder

Standard-Metadatenfelder:

Feld	Typ	Beschreibung
`description`	string	Kurze Plugin-Beschreibung
`version`	string	Plugin-Version
`author`	object	Plugin-Autor-Informationen
`homepage`	string	Plugin-Homepage oder Dokumentations-URL
`repository`	string	Quellcode-Repository-URL
`license`	string	SPDX-Lizenz-Identifikator (z. B. MIT, Apache-2.0)
`keywords`	array	Tags für Plugin-Entdeckung und Kategorisierung
`category`	string	Plugin-Kategorie zur Organisation
`tags`	array	Tags für Suchbarkeit
`strict`	boolean	Erfordern Sie plugin.json im Plugin-Ordner (Standard: true) ¹

Komponenten-Konfigurationsfelder:

Feld	Typ	Beschreibung
`commands`	string\|array	Benutzerdefinierte Pfade zu Befehlsdateien oder -verzeichnissen
`agents`	string\|array	Benutzerdefinierte Pfade zu Agent-Dateien
`hooks`	string\|object	Benutzerdefinierte Hooks-Konfiguration oder Pfad zur Hooks-Datei
`mcpServers`	string\|object	MCP-Server-Konfigurationen oder Pfad zur MCP-Konfiguration

^{1 - Wenn strict: true (Standard), muss das Plugin eine plugin.json-Manifestdatei enthalten, und Marktplatzfelder ergänzen diese Werte. Wenn strict: false, ist die plugin.json optional. Wenn sie fehlt, dient der Marktplatz-Eintrag als vollständiges Plugin-Manifest.}

Plugin-Quellen

Relative Pfade

Für Plugins im selben Repository:

{
  "name": "my-plugin",
  "source": "./plugins/my-plugin"
}

GitHub-Repositories

{
  "name": "github-plugin",
  "source": {
    "source": "github",
    "repo": "owner/plugin-repo"
  }
}

Git-Repositories

{
  "name": "git-plugin",
  "source": {
    "source": "url",
    "url": "https://gitlab.com/team/plugin.git"
  }
}

Erweiterte Plugin-Einträge

Plugin-Einträge können Standard-Komponentenstandorte überschreiben und zusätzliche Metadaten bereitstellen. Beachten Sie, dass ${CLAUDE_PLUGIN_ROOT} eine Umgebungsvariable ist, die sich zum Plugin-Installationsverzeichnis auflöst (Details finden Sie unter Umgebungsvariablen):

{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "Enterprise workflow automation tools",
  "version": "2.1.0",
  "author": {
    "name": "Enterprise Team",
    "email": "[email protected]"
  },
  "homepage": "https://docs.company.com/plugins/enterprise-tools",
  "repository": "https://github.com/company/enterprise-plugin",
  "license": "MIT",
  "keywords": ["enterprise", "workflow", "automation"],
  "category": "productivity",
  "commands": [
    "./commands/core/",
    "./commands/enterprise/",
    "./commands/experimental/preview.md"
  ],
  "agents": [
    "./agents/security-reviewer.md",
    "./agents/compliance-checker.md"
  ],
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{"type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh"}]
      }
    ]
  },
  "mcpServers": {
    "enterprise-db": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"]
    }
  },
  "strict": false
}

Schema-Beziehung: Plugin-Einträge verwenden das Plugin-Manifest-Schema mit allen Feldern als optional, plus marktplatzspezifischen Feldern (source, strict, category, tags). Dies bedeutet, dass jedes Feld, das in einer plugin.json-Datei gültig ist, auch in einem Marktplatz-Eintrag verwendet werden kann. Wenn strict: false, dient der Marktplatz-Eintrag als vollständiges Plugin-Manifest, wenn keine plugin.json vorhanden ist. Wenn strict: true (Standard), ergänzen Marktplatzfelder die eigene Manifestdatei des Plugins.

Marktplätze hosten und verteilen

Wählen Sie die beste Hosting-Strategie für Ihre Plugin-Verteilungsanforderungen.

Auf GitHub hosten (empfohlen)

GitHub bietet die einfachste Verteilungsmethode:

Erstellen Sie ein Repository: Richten Sie ein neues Repository für Ihren Marktplatz ein
Marktplatz-Datei hinzufügen: Erstellen Sie .claude-plugin/marketplace.json mit Ihren Plugin-Definitionen
Mit Teams teilen: Team-Mitglieder fügen mit /plugin marketplace add owner/repo hinzu

Vorteile: Integrierte Versionskontrolle, Issue-Tracking und Team-Zusammenarbeitsfunktionen.

Auf anderen Git-Services hosten

Jeder Git-Hosting-Service funktioniert für die Marktplatz-Verteilung mit einer URL zu einem beliebigen Git-Repository. Beispielsweise mit GitLab:

/plugin marketplace add https://gitlab.com/company/plugins.git

Verwenden Sie lokale Marktplätze für die Entwicklung

Testen Sie Ihren Marktplatz lokal vor der Verteilung:

Lokalen Marktplatz zum Testen hinzufügen

/plugin marketplace add ./my-local-marketplace

Plugin-Installation testen

/plugin install test-plugin@my-local-marketplace

Marktplatz-Operationen verwalten

Bekannte Marktplätze auflisten

Alle konfigurierten Marktplätze auflisten

/plugin marketplace list

Zeigt alle konfigurierten Marktplätze mit ihren Quellen und Status an.

Marktplatz-Metadaten aktualisieren

/plugin marketplace update marketplace-name

Aktualisiert Plugin-Auflistungen und Metadaten aus der Marktplatz-Quelle.

Einen Marktplatz entfernen

/plugin marketplace remove marketplace-name

Entfernt den Marktplatz aus Ihrer Konfiguration.

Das Entfernen eines Marktplatzes deinstalliert alle Plugins, die Sie von ihm installiert haben.

Fehlerbehebung bei Marktplätzen

Häufige Marktplatz-Probleme

Marktplatz wird nicht geladen

Symptome: Kann Marktplatz nicht hinzufügen oder Plugins von ihm nicht sehen Lösungen:

Überprüfen Sie, ob die Marktplatz-URL erreichbar ist
Überprüfen Sie, ob .claude-plugin/marketplace.json unter dem angegebenen Pfad vorhanden ist
Stellen Sie sicher, dass die JSON-Syntax mit claude plugin validate gültig ist
Bestätigen Sie für private Repositories, dass Sie Zugriffsberechtigung haben

Plugin-Installationsfehler

Symptome: Marktplatz wird angezeigt, aber Plugin-Installation schlägt fehl Lösungen:

Überprüfen Sie, ob Plugin-Quell-URLs erreichbar sind
Überprüfen Sie, ob Plugin-Verzeichnisse erforderliche Dateien enthalten
Stellen Sie für GitHub-Quellen sicher, dass Repositories öffentlich sind oder Sie Zugriff haben
Testen Sie Plugin-Quellen manuell durch Klonen/Herunterladen

Validierung und Tests

Testen Sie Ihren Marktplatz vor dem Teilen:

Marktplatz-JSON-Syntax validieren

claude plugin validate .

Marktplatz zum Testen hinzufügen

/plugin marketplace add ./path/to/marketplace

Test-Plugin installieren

/plugin install test-plugin@marketplace-name

Für vollständige Plugin-Test-Workflows siehe Testen Sie Ihre Plugins lokal. Für technische Fehlerbehebung siehe Plugins-Referenz.

Nächste Schritte

Für Marktplatz-Benutzer

Community-Marktplätze entdecken: Durchsuchen Sie GitHub nach Claude Code-Plugin-Sammlungen
Feedback beitragen: Melden Sie Probleme und schlagen Sie Verbesserungen für Marktplatz-Verwalter vor
Nützliche Marktplätze teilen: Helfen Sie Ihrem Team, wertvolle Plugin-Sammlungen zu entdecken

Für Marktplatz-Ersteller

Plugin-Sammlungen erstellen: Erstellen Sie thematische Marktplätze um spezifische Anwendungsfälle
Versionierung etablieren: Implementieren Sie klare Versionierungs- und Aktualisierungsrichtlinien
Community-Engagement: Sammeln Sie Feedback und pflegen Sie aktive Marktplatz-Communities
Dokumentation: Stellen Sie klare README-Dateien bereit, die den Inhalt Ihres Marktplatzes erklären

Für Organisationen

Private Marktplätze: Richten Sie interne Marktplätze für proprietäre Tools ein
Governance-Richtlinien: Etablieren Sie Richtlinien für Plugin-Genehmigung und Sicherheitsüberprüfung
Schulungsressourcen: Helfen Sie Teams, nützliche Plugins effektiv zu entdecken und zu übernehmen

Siehe auch

Plugins - Installation und Verwendung von Plugins
Plugins-Referenz - Vollständige technische Spezifikationen und Schemas
Plugin-Entwicklung - Erstellen Sie Ihre eigenen Plugins
Einstellungen - Plugin-Konfigurationsoptionen

Verwaltung

​Übersicht

​Voraussetzungen

​Marktplätze hinzufügen und verwenden

​GitHub-Marktplätze hinzufügen

​Git-Repositories hinzufügen

​Lokale Marktplätze für die Entwicklung hinzufügen

​Plugins aus Marktplätzen installieren

​Marktplatz-Installation überprüfen

​Team-Marktplätze konfigurieren

​Erstellen Sie Ihren eigenen Marktplatz

​Voraussetzungen für die Marktplatz-Erstellung

​Erstellen Sie die Marktplatz-Datei

​Marktplatz-Schema

​Erforderliche Felder

​Optionale Metadaten

​Plugin-Einträge

​Optionale Plugin-Felder

​Plugin-Quellen

​Relative Pfade

​GitHub-Repositories

​Git-Repositories

​Erweiterte Plugin-Einträge

​Marktplätze hosten und verteilen

​Auf GitHub hosten (empfohlen)

​Auf anderen Git-Services hosten

​Verwenden Sie lokale Marktplätze für die Entwicklung

​Marktplatz-Operationen verwalten

​Bekannte Marktplätze auflisten

​Marktplatz-Metadaten aktualisieren

​Einen Marktplatz entfernen

​Fehlerbehebung bei Marktplätzen

​Häufige Marktplatz-Probleme

​Marktplatz wird nicht geladen

​Plugin-Installationsfehler

​Validierung und Tests

​Nächste Schritte

​Für Marktplatz-Benutzer

​Für Marktplatz-Ersteller

​Für Organisationen

​Siehe auch

Übersicht

Voraussetzungen

Marktplätze hinzufügen und verwenden

GitHub-Marktplätze hinzufügen

Git-Repositories hinzufügen

Lokale Marktplätze für die Entwicklung hinzufügen

Plugins aus Marktplätzen installieren

Marktplatz-Installation überprüfen

Team-Marktplätze konfigurieren

Erstellen Sie Ihren eigenen Marktplatz

Voraussetzungen für die Marktplatz-Erstellung

Erstellen Sie die Marktplatz-Datei

Marktplatz-Schema

Erforderliche Felder

Optionale Metadaten

Plugin-Einträge

Optionale Plugin-Felder

Plugin-Quellen

Relative Pfade

GitHub-Repositories

Git-Repositories

Erweiterte Plugin-Einträge

Marktplätze hosten und verteilen

Auf GitHub hosten (empfohlen)

Auf anderen Git-Services hosten

Verwenden Sie lokale Marktplätze für die Entwicklung

Marktplatz-Operationen verwalten

Bekannte Marktplätze auflisten

Marktplatz-Metadaten aktualisieren

Einen Marktplatz entfernen

Fehlerbehebung bei Marktplätzen

Häufige Marktplatz-Probleme

Marktplatz wird nicht geladen

Plugin-Installationsfehler

Validierung und Tests

Nächste Schritte

Für Marktplatz-Benutzer

Für Marktplatz-Ersteller

Für Organisationen

Siehe auch