Was sind Claude Code Plugins und der Plugin-Marketplace?

Je mehr du Claude Code nutzt, desto mehr sammeln sich eigene Slash-Befehle, häufig genutzte Subagenten, MCP-Server und Hooks an. Ein plugin ist der Mechanismus, der sie zu einer einzigen Einheit bündelt, die du versionieren, teilen und über Teams und Projekte hinweg wiederverwenden kannst, und ein marketplace ist der Ort, an dem sie verteilt werden (plugins erschienen im Oktober 2025 als öffentliche Beta; 2026 kamen ein offizielles Verzeichnis sowie die Suche/Auflistung über /plugin hinzu).

Dieser Artikel behandelt was ein plugin ist, seinen Aufbau, die Verwendung, marketplaces, das Erstellen und Veröffentlichen eigener plugins sowie Verteilungsbereich und Sicherheit — auf Basis der offiziellen Dokumentation. Drei Kernpunkte vorab. (1) Ein plugin ist ein einziges Verzeichnis, das „Skills / Befehle / Subagenten / Hooks / MCP-Server" bündelt, mit .claude-plugin/plugin.json als Manifest. (2) Verwende /plugin, um einen marketplace hinzuzufügen, und install, um ein plugin hinzuzufügen. (3) Eigene zu erstellen ist einfach — lege eine plugin.json und eine SKILL.md ab, teste mit claude --plugin-dir und veröffentliche per git.

1. Was ein Claude Code plugin ist

Die offizielle Definition: Ein plugin ist „ein in sich geschlossenes Verzeichnis, das eigene Claude-Code-Funktionalität bündelt, damit sie versioniert, geteilt und wiederverwendet werden kann." Ein einzelnes plugin kann eine beliebige Kombination der folgenden Elemente enthalten:

Kurz gesagt ist ein plugin „eine Claude-Code-Erweiterung, in eine teilbare Form verpackt." Anpassungen, die du früher einzeln konfiguriert hast, werden in einem Repository gesammelt, sodass dein gesamtes Team dasselbe Setup reproduziert. Du kannst auch LSP-Server, Hintergrundüberwachungen und ausführbare Dateien (bin/) einbinden, aber die sechs oben genannten reichen für den Anfang.

2. Aufbau eines plugins

Es gibt eine wichtige Regel zum Aufbau: nur plugin.json gehört in .claude-plugin/. Die Verzeichnisse commands/, agents/, skills/ und hooks/ liegen im plugin-Stammverzeichnis (nicht in .claude-plugin/).

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # manifest — ONLY this file lives here
├── skills/
│   └── code-review/SKILL.md
├── agents/
│   └── security-reviewer.md
├── hooks/hooks.json
├── .mcp.json
└── README.md

Ein minimales plugin.json-Manifest:

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

name ist die Kennung und zugleich der Skill-Namensraum (ein Skill wird etwa als /my-first-plugin:hello aufgerufen). version ist optional: ist sie gesetzt, erhalten Nutzer Updates nur, wenn du sie erhöhst. Lässt du version bei der Verteilung über git weg, dient die commit SHA als Version (jeder Commit ist eine neue Version).

3. Verwendung — /plugin und marketplaces

Die Installation erfolgt über /plugin, das einen tabbasierten Manager öffnet (Discover / Installed / Marketplaces / Errors). Die wichtigsten Befehle:

# Add a marketplace (the distribution catalog)
/plugin marketplace add anthropics/claude-code        # a GitHub owner/repo
/plugin marketplace add ./my-marketplace              # a local path
/plugin marketplace add https://example.com/marketplace.json

# Install / manage plugins (user scope by default)
/plugin install plugin-name@marketplace-name
/plugin enable  plugin-name@marketplace-name
/plugin disable plugin-name@marketplace-name
/plugin uninstall plugin-name@marketplace-name

# List (filter with --enabled / --disabled). /plugin also has a search bar
/plugin list
/plugin list --enabled

# Apply changes without restart
/reload-plugins

„Einen marketplace hinzufügen" = „einen Katalog registrieren," wodurch für sich genommen noch kein plugin installiert wird — du fügst den Katalog hinzu und installst die plugins dann einzeln. Für Skripte gibt es nicht-interaktive CLI-Entsprechungen wie claude plugin install …. Wenn der gebündelte MCP-Server eines plugins keine Verbindung herstellt, siehe Behebung von MCP-Verbindungsfehlern.

4. Was ein marketplace ist

Ein marketplace ist ein Katalog mit einer .claude-plugin/marketplace.json, die plugins auflistet und angibt, woher jedes zu beziehen ist (ein git-Repository, ein lokaler Pfad oder eine gehostete Datei). Es gibt offizielle und einen Community-marketplace.

Wenn du also plugins nur nutzen möchtest, ist der offizielle marketplace sofort einsatzbereit. Den Community-Katalog oder einen eigenen internen fügst du nach Bedarf hinzu.

5. Eigene erstellen und veröffentlichen

Eines zu erstellen ist überraschend einfach. Beginne damit, ein Manifest und einen Skill abzulegen und dann lokal zu testen.

# 1) Scaffold
mkdir -p my-first-plugin/.claude-plugin my-first-plugin/skills/hello
# write .claude-plugin/plugin.json and skills/hello/SKILL.md

# 2) Test without installing (a .zip works too)
claude --plugin-dir ./my-first-plugin

Zum Veröffentlichen legst du einfach eine .claude-plugin/marketplace.json im Stammverzeichnis eines git-Repositorys ab. Nutzer fügen ihn mit /plugin marketplace add owner/repo hinzu.

{
  "name": "my-plugins",
  "owner": { "name": "Your Name" },
  "plugins": [
    {
      "name": "quality-review-plugin",
      "source": "./plugins/quality-review-plugin",
      "description": "Adds a quick code-review skill"
    }
  ]
}

Versionierung wird in dieser Reihenfolge aufgelöst: version in plugin.json → (sonst) version im marketplace-Eintrag → (sonst) die commit SHA. Wenn du version festlegst, erhöhe sie bei jeder Veröffentlichung (vergisst du es, erhalten Nutzer keine Updates). Validiere vor der Veröffentlichung mit claude plugin validate .. Um in den offiziellen Community-Katalog aufgenommen zu werden, bewirbst du dich über das Einreichungsformular (es gelten Bedingungen wie Team/Enterprise u. a.).

6. Verteilungsbereich und Sicherheit

Installationen haben einen Geltungsbereich (scope): user (Standard, alle Projekte) / project (alle Repo-Mitarbeitenden, in .claude/settings.json erfasst) / local (nur du, dieses Repo) / managed (vom Admin verteilt, nicht durch Nutzer änderbar). Für die Team-Verteilung trägst du extraKnownMarketplaces und enabledPlugins in die .claude/settings.json des Projekts ein, und Mitglieder werden zur Installation aufgefordert, sobald sie dem Ordner vertrauen.

Zusammenfassung

Ein Claude Code plugin bündelt Skills, Slash-Befehle, Subagenten, Hooks und MCP-Server in einem Verzeichnis, das du versionieren, teilen und wiederverwenden kannst (das Manifest ist .claude-plugin/plugin.json; commands/ usw. gehören ins Stammverzeichnis). Sie werden über marketplaces verteilt, und der offizielle (claude.com/plugins) ist sofort verfügbar. Installiere mit /plugin marketplace add → /plugin install → (nach Bedarf) /plugin list, Suche, /reload-plugins.

Eigene zu erstellen ist ein kurzer Weg: lege eine plugin.json und eine SKILL.md ab, teste mit claude --plugin-dir und veröffentliche dann, indem du eine marketplace.json in ein git-Repository legst. Die Geltungsbereiche sind user / project / local / managed, mit Team-Verteilung über .claude/settings.json. Aber plugins können beliebigen Code ausführen, also installiere nur von vertrauenswürdigen Anbietern und schränke Quellen in Organisationen mit strictKnownMarketplaces ein. Plugins können außerdem Hooks bündeln, die an Lebenszyklus-Punkten automatisch ausgeführt werden – wie sie funktionieren, zeigt die ausführliche Analyse. Verwandt: Claude Agent Skills, MCP, Claude Code Artifacts.

FAQ

Q. Was ist der Unterschied zwischen einem plugin und einem Skill?
A. Ein Skill ist eine der Komponenten innerhalb eines plugins. Ein plugin ist eine Verteilungseinheit (Verzeichnis), die Skills plus Slash-Befehle, Subagenten, Hooks und MCP-Server bündelt. Das plugin ist die „Box", um deine häufig genutzten Skills und Befehle an ein Team auszuliefern; ein Skill ist eines der „Anleitungsblätter" in dieser Box.

Q. Wie installiere ich ein plugin?
A. Füge zuerst einen marketplace (Katalog) mit /plugin marketplace add owner/repo hinzu und installiere dann einzeln mit /plugin install plugin-name@marketplace-name. Der offizielle marketplace (claude-plugins-official) ist ab dem ersten Start automatisch verfügbar, und du kannst unter claude.com/plugins oder über /plugin Discover stöbern. Umschalten mit /plugin enable|disable; auflisten mit /plugin list.

Q. Kann ich ein eigenes plugin erstellen und verteilen?
A. Ja. Lege eine .claude-plugin/plugin.json (Manifest) und eine skills/…/SKILL.md ab und teste ohne Installation mit claude --plugin-dir ./your-plugin. Zum Veröffentlichen legst du einfach eine .claude-plugin/marketplace.json im Stammverzeichnis eines git-Repositorys ab; Nutzer fügen ihn mit /plugin marketplace add owner/repo hinzu. Denk daran: nur plugin.json gehört in .claude-plugin/ — skills/ usw. liegen im Stammverzeichnis.

Q. Wie funktioniert die Versionierung?
A. Sie wird so aufgelöst: version in plugin.json → (sonst) version im marketplace-Eintrag → (sonst) die git commit SHA. Wenn du version setzt, erreichen Updates die Nutzer nur, wenn du sie erhöhst, also erhöhe sie bei jeder Veröffentlichung (sonst bleiben Nutzer auf der alten). Lässt du version weg, ist jeder Commit eine neue Version. Validiere vor der Veröffentlichung mit claude plugin validate ..

Q. Sind plugins von Dritten sicher?
A. Nicht bedingungslos. Die offizielle Dokumentation weist darauf hin, dass ein plugin „beliebigen Code mit deinen Rechten ausführen kann," und Anthropic überprüft plugins von Dritten oder deren gebündeltes MCP nicht. Installiere nur von vertrauenswürdigen Anbietern und prüfe den Code, wenn du unsicher bist. Organisationen können erlaubte Quellen mit strictKnownMarketplaces einschränken ([] für eine vollständige Sperre).