Plugin-Marktplätze - Claude 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 bestehende Marktplätze nutzen und eigene für die Team-Verteilung erstellen.

Überblick

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
Team-Verteilung: 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
Für die Erstellung 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 hinzufügen, das .claude-plugin/marketplace.json enthält

/plugin marketplace add owner/repo

Git-Repositories hinzufügen

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 hinzufügen, das .claude-plugin/marketplace.json enthält

/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

Sobald 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 zu sehen
Installation testen: Versuchen Sie, ein Plugin zu installieren, um zu überprüfen, ob der Marktplatz korrekt 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 automatisch diese Marktplätze und alle im enabledPlugins-Feld angegebenen Plugins.

Eigenen Marktplatz erstellen

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

Marktplatz-Datei erstellen

Erstellen Sie .claude-plugin/marketplace.json im Stammverzeichnis Ihres Repositories:

{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Automatische Code-Formatierung beim Speichern",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Deployment-Automatisierungstools"
    }
  ]
}

Marktplatz-Schema

Erforderliche Felder

Feld	Typ	Beschreibung
`name`	string	Marktplatz-Identifikator (kebab-case, keine Leerzeichen)
`owner`	object	Marktplatz-Betreuer-Informationen
`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 marktplatzspezifische Felder (source, category, tags, strict), wobei name erforderlich ist.

Erforderliche Felder:

Feld	Typ	Beschreibung
`name`	string	Plugin-Identifikator (kebab-case, keine Leerzeichen)
`source`	string\|object	Wo 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 für Organisation
`tags`	array	Tags für Suchbarkeit
`strict`	boolean	Plugin.json im Plugin-Ordner erforderlich (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-Manifest-Datei enthalten, und Marktplatz-Felder 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-Komponenten-Standorte überschreiben und zusätzliche Metadaten bereitstellen. Beachten Sie, dass ${CLAUDE_PLUGIN_ROOT} eine Umgebungsvariable ist, die zum Installationsverzeichnis des Plugins aufgelöst wird (für Details siehe Umgebungsvariablen):

{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "Enterprise-Workflow-Automatisierungstools",
  "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 marktplatzspezifische Felder (source, strict, category, tags). Das 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 existiert. Wenn strict: true (Standard), ergänzen Marktplatz-Felder die eigene Manifest-Datei 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:

Repository erstellen: 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-Kollaborationsfunktionen.

Auf anderen Git-Services hosten

Jeder Git-Hosting-Service funktioniert für die Marktplatz-Verteilung, unter Verwendung einer URL zu einem beliebigen Git-Repository. Zum Beispiel mit GitLab:

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

Lokale Marktplätze für die Entwicklung verwenden

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-Listen und Metadaten aus der Marktplatz-Quelle.

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.

Marktplätze troubleshooten

Häufige Marktplatz-Probleme

Marktplatz lädt nicht

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

Überprüfen Sie, ob die Marktplatz-URL zugänglich ist
Prüfen Sie, dass .claude-plugin/marketplace.json am angegebenen Pfad existiert
Stellen Sie sicher, dass die JSON-Syntax mit claude plugin validate gültig ist
Für private Repositories bestätigen Sie, dass Sie Zugriffsberechtigungen haben

Plugin-Installationsfehler

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

Überprüfen Sie, ob Plugin-Quell-URLs zugänglich sind
Prüfen Sie, dass Plugin-Verzeichnisse erforderliche Dateien enthalten
Für GitHub-Quellen stellen Sie sicher, dass Repositories öffentlich sind oder Sie Zugriff haben
Testen Sie Plugin-Quellen manuell durch Klonen/Herunterladen

Validierung und Testen

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 technisches Troubleshooting siehe Plugins-Referenz.

Nächste Schritte

Für Marktplatz-Nutzer

Community-Marktplätze entdecken: Suchen Sie auf GitHub nach Claude Code Plugin-Sammlungen
Feedback beitragen: Melden Sie Probleme und schlagen Sie Verbesserungen an Marktplatz-Betreuer 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 rund um spezifische Anwendungsfälle
Versionierung etablieren: Implementieren Sie klare Versionierungs- und Update-Richtlinien
Community-Engagement: Sammeln Sie Feedback und pflegen Sie aktive Marktplatz-Communities
Dokumentation: Stellen Sie klare README-Dateien bereit, die Ihre Marktplatz-Inhalte 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 - Installieren und Verwenden von Plugins
Plugins-Referenz - Vollständige technische Spezifikationen und Schemas
Plugin-Entwicklung - Erstellen eigener Plugins
Einstellungen - Plugin-Konfigurationsoptionen

Erste Schritte

Mit Claude Code entwickeln

Claude Code SDK

Bereitstellung

Verwaltung

Konfiguration

Referenz

Ressourcen

​Überblick

​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

​Eigenen Marktplatz erstellen

​Voraussetzungen für die Marktplatz-Erstellung

​Marktplatz-Datei erstellen

​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

​Lokale Marktplätze für die Entwicklung verwenden

​Marktplatz-Operationen verwalten

​Bekannte Marktplätze auflisten

​Marktplatz-Metadaten aktualisieren

​Marktplatz entfernen

​Marktplätze troubleshooten

​Häufige Marktplatz-Probleme

​Marktplatz lädt nicht

​Plugin-Installationsfehler

​Validierung und Testen

​Nächste Schritte

​Für Marktplatz-Nutzer

​Für Marktplatz-Ersteller

​Für Organisationen

​Siehe auch

Überblick

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

Eigenen Marktplatz erstellen

Voraussetzungen für die Marktplatz-Erstellung

Marktplatz-Datei erstellen

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

Lokale Marktplätze für die Entwicklung verwenden

Marktplatz-Operationen verwalten

Bekannte Marktplätze auflisten

Marktplatz-Metadaten aktualisieren

Marktplatz entfernen

Marktplätze troubleshooten

Häufige Marktplatz-Probleme

Marktplatz lädt nicht

Plugin-Installationsfehler

Validierung und Testen

Nächste Schritte

Für Marktplatz-Nutzer

Für Marktplatz-Ersteller

Für Organisationen

Siehe auch