Claude Code Plugins paketieren und im eigenen Marketplace veröffentlichen

Veröffentlicht am 16. Okt. • Zuerst erschienen auf wowhow.cloud

Ein Claude Code Plugin ist ein Verzeichnis, das Skills, Agents, Hooks und MCP Server bündelt, damit Claude Code sie als eine Einheit installiert, und ein Marketplace ist ein Git-Repository mit einer.claude-plugin/marketplace.json Datei, die Plugins auflistet. Im Plugin-Manifest ist nur name erforderlich. In der Marketplace-Datei sind nur name, owner und plugins erforderlich.

Ist das Repository privat, ist auch der Marketplace privat. Ich habe jeden Befehl und jedes Feld unten gegen die aktuelle Claude Code Dokumentation und claude plugin --help auf Version 2.1.299 geprüft. Im Folgenden: Plugin vs. Skill vs. MCP vs. Hook, das Layout und das Manifest, Plugin-Hooks vs. Hooks in der settings.json, das Marketplace-Schema, Updates, das Team-Rollout, eine Sicherheitscheckliste und ein Plugin, das du in 15 Minuten veröffentlichen kannst.

Ein Plugin ist Verpackung: Skills, Agents, Hooks und MCP Server werden unter einem Namen und einer Version gemeinsam installiert.

.claude-plugin/plugin.json enthält nur das Manifest. Alles andere liegt im Plugin-Stammverzeichnis.

Veröffentliche ein Repository mit.claude-plugin/marketplace.json. Nutzer führen /plugin marketplace add owner/repo aus und dann /plugin install name@marketplace.

Updates kommen nur an, wenn sich die Version ändert.

Für Teams: extraKnownMarketplaces und enabledPlugins in den verwalteten Einstellungen oder in der.claude/settings.json des Repositories.

Ein Plugin führt Code in deinem Namen aus. Lies vor der Installation seine Hooks,.mcp.json und bin/.

Skills, Subagents, Hooks und MCP Server funktionieren alle eigenständig. Ein Skill in ~/.claude/skills/ ist in jedem Projekt auf deinem Rechner verfügbar. Erstelle ein Plugin, wenn du mehrere Teile gemeinsam installiert, mit Teamkollegen geteilt oder mit Versionen versehen freigegeben haben möchtest. Plugin-Skills und -Agents erhalten den Plugin-Namen als Präfix, sodass zwei Plugins jeweils einen hello-Skill mitliefern können, ohne zu kollidieren. Zur Frage der Ebenen selbst siehe MCP vs CLI vs skills.

| Skill | SKILL.md Anweisungen, die Claude bei Bedarf lädt, auch als Befehl ausführbar | Nein, es lenkt Claude | skills/<name>/SKILL.md | Ein Ordner oder innerhalb eines Plugins |

| MCP Server | Tool-Server, mit dem sich Claude Code verbindet | Ja, ein stdio-Server ist ein Prozess auf deinem Rechner |.mcp.json | Konfigurationsdatei oder innerhalb eines Plugins |

| Hook | Befehl, den Claude Code bei einem Lebenszyklus-Ereignis ausführt | Ja, ein Shell-Befehl mit deinen Berechtigungen | settings.json oder hooks/hooks.json | Einstellungs-Snippet oder innerhalb eines Plugins |

| Plugin | Verzeichnis, das eine beliebige Kombination des oben Genannten mit einem Manifest bündelt | Wenn es Hooks, MCP Server, Monitore oder bin/ enthält | Plugin-Stammverzeichnis, mit optionaler.claude-plugin/plugin.json | Ein Marketplace-Eintrag, ein Zip oder --plugin-dir |

Ein Kostenpunkt: Ein aktiviertes Plugin ist Teil jeder Sitzung. Der Name und die Beschreibung jedes Skills, Agents und Befehls, die Claude eigenständig aufrufen kann, liegen in jeder Runde im Kontext und zählen zur Nutzung, selbst wenn nichts aus dem Plugin ausgeführt wird. Der Claude Max API Credits Planner zeigt, was ein größerer Kontext-Fußabdruck für ein Monatsbudget bedeutet.

Das Layout ist an genau einer Stelle streng. Lege innerhalb von.claude-plugin/ nur plugin.json ab. Dort gespeicherte Komponenten werden nicht geladen. Alle anderen Verzeichnisse liegen im Plugin-Stammverzeichnis:

deploy-tools/ ├──.claude-plugin/ │ └── plugin.json ├── skills/ │ └── deploy/ │ └── SKILL.md ├── agents/ │ └── reviewer.md ├── hooks/ │ └── hooks.json ├── bin/ (auf dem PATH des Bash-Tools, solange aktiviert) └──.mcp.json Vollbildmodus öffnen Vollbildmodus beenden Das Manifest ist optional. Ohne es lädt Claude Code die Komponenten aus diesen Standardorten und nimmt den Namen aus dem Marketplace-Eintrag oder dem Verzeichnis. Schreibe eines für Metadaten, eine Version oder Komponenten außerhalb der Standards. Wissenswerte Felder:

name: der einzige erforderliche Schlüssel. Kebab-Case. Jede Komponente wird darunter namespaced, sodass der Agent reviewer im Plugin deploy-tools als deploy-tools:reviewer erscheint.

version: ein String, wird nicht gegen Semver geprüft. Wird er gesetzt, bleiben Nutzer darauf eingefroren, bis du ihn änderst.

description, author (Objekt, name erforderlich), homepage (muss als URL interpretierbar sein, sonst lädt das Plugin nicht), repository, license, keywords, displayName.

skills, commands, agents, hooks, mcpServers: Pfade oder Inline-Konfiguration für Komponenten außerhalb der Standards. Pfade beginnen mit./ und bleiben innerhalb des Plugin-Stammverzeichnisses.

dependencies und userConfig (Werte, nach denen Claude Code fragt, wobei sensitive: true Geheimnisse aus der settings.json heraushält).

Skills liegen in skills/<name>/SKILL.md und werden als /plugin-name:skill-name ausgeführt. Agents sind Markdown-Dateien in agents/. Hooks kommen in hooks/hooks.json, MCP Server in.mcp.json. Eine CLAUDE.md im Plugin-Stammverzeichnis wird nicht als Kontext geladen, also platziere Anweisungen in einem Skill. Namen, die mit claude- oder anthropic- beginnen, bestehen die Validierung nicht. Ein unbekannter Schlüssel auf oberster Ebene wird nur mit einer Warnung entfernt.

Die Verschachtelung von event, matcher und handler ist identisch. Zwei Unterschiede sind wichtig. Eine Plugin-Hooks-Datei umschließt die Event-Map mit einem Schlüssel "hooks" auf oberster Ebene, und eine nackte Event-Map lädt nicht, während Inline-Hooks in plugin.json keine Hülle haben. Und mitgelieferte Skripte werden über ${CLAUDE_PLUGIN_ROOT} referenziert, das sich bei jedem Update ändert (nutze ${CLAUDE_PLUGIN_DATA} für Zustände, die überdauern müssen). Plugin-Hooks verschmelzen mit deinen Nutzer- und Projekt-Hooks. Hooks haben kein Präfix, daher läuft ein Hook, der in ein Plugin migriert, aber in der settings.json belassen wurde, doppelt.

Ein Marketplace ist ein Verzeichnis oder Repository mit.claude-plugin/marketplace.json. Erforderliche Schlüssel auf oberster Ebene sind name, owner (mit name) und plugins. Jeder Plugin-Eintrag benötigt name und source.

{ "name": "team-tools", "description": "Plugins for my team", "owner": { "name": "Your Name" }, "plugins": [ { "name": "no-bypass", "source": "./plugins/no-bypass", "description": "Blocks git --no-verify and teaches commit hygiene" } ] } Vollbildmodus öffnen Vollbildmodus beenden Die source ist ein relativer Pfad vom Marketplace-Stamm (das Verzeichnis, das.claude-plugin/ enthält, niemals mit..) oder ein Objekt: github (repo, ref, sha), url, git-subdir, npm, archive (Zip über HTTPS, optionaler sha256 Pin) oder command. Halte den Eintragsnamen identisch mit dem in der plugin.json des Plugins, sonst meldet die Installation über den Manifest-Namen, dass das Plugin nicht gefunden wurde. Namen wie claude-plugins-official und claude-community werden nur für Marketplaces akzeptiert, die von github.com/anthropics/ stammen.

Nutzer registrieren einen Marketplace einmalig und installieren dann nach Name. Innerhalb einer Sitzung:

/plugin marketplace add your-org/your-marketplace /plugin install no-bypass@team-tools Vollbildmodus öffnen Vollbildmodus beenden Aus einer Shell: claude plugin marketplace add und claude plugin install no-bypass@team-tools. Der add-Befehl nimmt ein GitHub owner/repo, eine Git-URL, eine gehostete marketplace.json URL oder einen lokalen Pfad. Hänge #<ref> an, um einen Branch oder Tag zu pinnen. Die Kurzform bedeutet immer github.com, GitLab-Nutzer benötigen also die vollständige URL. Ein über eine URL gehosteter Marketplace lädt nur das JSON herunter, daher schlagen Einträge mit relativen Pfaden dort fehl.

Hier verlieren Leute einen Nachmittag. Nutzer bekommen eine neue Kopie nur, wenn sich die berechnete Version ändert. Setze "version": "1.0.0", pushe zehn Commits, und claude plugin update meldet, dass das Plugin bereits auf dem neuesten Stand ist. Bump die version bei jeder Veröffentlichung oder lasse sie sowohl in plugin.json als auch im Marketplace-Eintrag weg, sodass der Commit SHA entscheidet. Setze sie niemals an beiden Stellen: plugin.json gewinnt stillschweigend.

Auto-Update ist standardmäßig ausgeschaltet, und marketplace.json hat dafür kein Feld. Jeder Nutzer aktiviert es unter Marketplaces in /plugin, oder ein Admin setzt "autoUpdate": true in den verwalteten Einstellungen. Andernfalls führen Nutzer claude plugin update name@marketplace aus. Pinne eine Veröffentlichung mit ref oder einem 40-Zeichen-sha im Eintrag. claude plugin tag erstellt ein Git-Tag {name}--v{version}. Benenne ein veröffentlichtes Plugin niemals um; füge stattdessen eine renames-Map zum Marketplace hinzu.

Für ein Team reicht ein privates GitHub-Repository: Jeder, der es klonen kann, kann daraus installieren. Claude Code hat selbst kein Git-Token, und marketplace.json hat kein Anmeldeinformationsfeld, daher nutzen Installationen die Git-Anmeldeinformationen des Rechners. Für HTTPS speichert gh auth login gefolgt von gh auth setup-git eine. Ohne GitHub-SSH-Schlüssel setze CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1. Der Haken: Auto-Update gegen ein privates Repository benötigt eine gespeicherte Anmeldeinformation, und ein Helper, der nachfragen müsste, scheitert lautlos.

Um den Marketplace für ein einzelnes Repository zu registrieren, führe claude plugin marketplace add your-org/your-marketplace --scope project aus und committe die.claude/settings.json, die dabei geschrieben wird. Sie greift, sobald ein Beitragender dem Ordner vertraut. Unternehmensweit kommen die verifizierten Einstellungsnamen in die verwalteten Einstellungen:

{ "extraKnownMarketplaces": { "team-tools": { "source": { "source": "github", "repo": "your-org/team-tools" }, "autoUpdate": true } }, "enabledPlugins": { "no-bypass@team-tools": true } } Vollbildmodus öffnen Vollbildmodus beenden Verwaltete Einstellungen schlagen jeden anderen Bereich, sodass das Deaktivieren des Plugins durch einen Nutzer das Laden nicht verhindert; false in verwalteten enabledPlugins blockiert ein Plugin überall. strictKnownMarketplaces (Alias allowedMarketplaces) ist eine Allowlist, blockedMarketplaces eine Blocklist, die zuerst geprüft wird, und disableSideloadFlags weist --plugin-dir zurück. Eine leere Allowlist blockiert jede Quelle, auch den offiziellen Marketplace, und jede Allowlist stoppt Plugins unter ~/.claude/skills/, es sei denn, du fügst { "source": "skills-dir" } hinzu. Die Aliase benötigen v2.1.232 oder neuer.

Claude Code registriert den offiziellen Marketplace (claude-plugins-official) beim ersten interaktiven Start automatisch, sofern eine verwaltete Richtlinie dies nicht blockiert. Community- und Demo-Marketplaces werden nicht automatisch hinzugefügt. Um alle Nutzer zu erreichen, veröffentlichen Sie ein öffentliches Marketplace-Repository und teilen die beiden Befehle mit, oder reichen Sie Ihren Eintrag bei Anthropics Verzeichnis unter claude.ai/directory/manage ein (dafür ist ein kostenpflichtiger claude.ai-Plan erforderlich; das Verzeichnis erreicht Claude Code über die Konto-Synchronisation als name@synced).

Der offizielle Marketplace nimmt über dieses Portal keine Einreichungen an. Anthropic ordnet Marketplaces dem Namen nach in die Stufen offiziell, Community und Third-Party ein und weist darauf hin, dass der Name nur verrät, wer den Katalog veröffentlicht, nicht was jedes einzelne Plugin tut.

Ein Plugin lässt sich für eine einzige Sitzung mit claude --plugin-dir./my-plugin laden (wiederholbar, akzeptiert auch eine.zip-Datei). Der Pfad muss auf das Wurzelverzeichnis eines einzelnen Plugins zeigen, nicht auf das Wurzelverzeichnis eines Marketplace, sonst wird nichts geladen und es erscheint keine Fehlermeldung. Nach Änderungen führen Sie /reload-plugins aus. Danach:

claude plugin validate./my-plugin prüft das Manifest sowie das Frontmatter jeder Skill-, Agent- und Command-Datei. In der CI zusätzlich mit --strict verwenden.

claude plugin validate./my-marketplace prüft die JSON-Datei und jeden Eintrag.

Mit claude plugin marketplace add./my-marketplace wird der Marketplace hinzugefügt, und daraus lässt sich installieren. Ein relativer Pfad auf ein nicht vorhandenes Verzeichnis besteht die Validierung und schlägt erst bei der Installation fehl.

claude plugin details my-plugin gibt die Komponentenübersicht aus.

In der Dokumentation wird CLAUDE_CONFIG_DIR als Konfigurationsverzeichnis genannt, das Claude Code anstelle von ~/.claude verwendet, aber es gibt keine Anleitung für eine isolierte Installation. Probieren Sie das daher zuerst auf einer Wegwerf-Maschine aus.

Anthropics Formulierung: Ein Plugin kann beliebigen Code auf Ihrem Rechner mit Ihren Nutzerrechten ausführen. Hooks, Monitore, MCP-Server und LSP-Server laufen außerhalb der Sandbox und Ihrer Berechtigungsregeln. Skills und Agents gelangen als Anweisungen in den Kontext. Lesen Sie ein Plugin wie ein Installationsskript. Zum Thema Container siehe Sandboxing von Claude Code und Codex.

Quelle. claude plugin marketplace list zeigt an, woher jeder Marketplace stammt.

Hooks. Lesen Sie hooks/hooks.json vollständig durch. Der Detailbereich zeigt nur, dass ein Hook existiert, nicht was er ausführt.

MCP. Lesen Sie.mcp.json: den Befehl oder die URL jedes Servers.

bin/. Alles dort landet auf dem PATH des Bash-Tools.

Inventar. claude --plugin-dir <dir> plugin details <name> listet bei einem Clone Skills, Agents, Hooks samt Ereignissen und Server auf.

Updates. Wenn Auto-Update aktiviert ist, können bereits geprüfte Dateien sich ändern. Für Marketplaces, die Sie nicht kontrollieren, pinnen Sie einen SHA.

Deinstallieren mit claude plugin uninstall im selben Scope, in dem installiert wurde; die zwischengespeicherten Dateien bleiben 14 Tage unter ~/.claude/plugins/cache/ liegen.

Ein Repository, ein Marketplace, ein Plugin namens no-bypass mit einem Skill und einem PreToolUse-Hook, der git... --no-verify blockiert.

team-tools/ ├──.claude-plugin/ │ └── marketplace.json └── plugins/ └── no-bypass/ ├──.claude-plugin/ │ └── plugin.json ├── skills/ │ └── commit-hygiene/ │ └── SKILL.md ├── hooks/ │ └── hooks.json └── scripts/ └── block-no-verify.sh Vollbildmodus öffnen Vollbildmodus schließen plugins/no-bypass/.claude-plugin/plugin.json

{ "name": "no-bypass", "description": "Blocks git --no-verify and teaches commit hygiene", "version": "1.0.0", "author": { "name": "Your Name" } } Vollbildmodus öffnen Vollbildmodus schließen plugins/no-bypass/skills/commit-hygiene/SKILL.md

--- name: commit-hygiene description: Commit rules for this repo. Use before running git commit. --- Never bypass git hooks. If a pre-commit hook fails, read the output, fix the cause, and commit again. Do not pass --no-verify. Keep commits small. Vollbildmodus öffnen Vollbildmodus schließen plugins/no-bypass/hooks/hooks.json (beachten Sie den übergeordneten "hooks"-Wrapper; die exec-Form mit args hält den Pfad als ein einziges Argument zusammen)

{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "bash", "args": [ "${CLAUDE_PLUGIN_ROOT}/scripts/block-no-verify.sh" ] } ] } ] } } Vollbildmodus öffnen Vollbildmodus schließen plugins/no-bypass/scripts/block-no-verify.sh

#!/bin/bash # Reads the PreToolUse JSON on stdin. Exit 2 blocks the call and # shows stderr to Claude. Needs jq on PATH. command = $( jq -r '.tool_input.command // ""' ) if echo " $command " | grep -qE 'git[[:space:]].*--no-verify'; then echo "Blocked: --no-verify skips git hooks. Fix the failing check instead." > &2 exit 2 fi exit 0 Vollbildmodus öffnen Vollbildmodus schließen Bei einem Bash-Aufruf erhält der Hook JSON auf der Standardeingabe, wobei der Befehl in tool_input.command steht. Der Exit-Code 2 blockiert den Aufruf und zeigt Claude die Standardfehlerausgabe. Verwenden Sie pro Hook genau eine Blockiermethode. Das Kurzflag git commit -n bewirkt dasselbe wie --no-verify und wird von diesem regulären Ausdruck nicht erfasst, erweitern Sie das Muster also, falls das relevant ist.

Die Datei.claude-plugin/marketplace.json im Repository-Wurzelverzeichnis ist die oben bereits gezeigte. Dann:

claude plugin validate./team-tools claude plugin validate./team-tools/plugins/no-bypass --strict claude --plugin-dir./team-tools/plugins/no-bypass git init && git add. && git commit -m "no-bypass 1.0.0" # push to github.com/your-org/team-tools, then on any machine: claude plugin marketplace add your-org/team-tools claude plugin install no-bypass@team-tools Vollbildmodus öffnen Vollbildmodus schließen Fragen Sie in der --plugin-dir-Sitzung Claude auf, git commit --no-verify -m test auszuführen. Der Aufruf wird blockiert und Claude sieht Ihre Meldung. Für ein beispielhaftes, installierbares und lesbares Plugin im Marketplace-Format liefert das Opus 5.5 Claude Code Plugin genau in diesem Layout fünf Schutz-Hooks, Effort-Presets und zehn Skills; kombinieren Sie es mit den Opus-5.5-Effort-Einstellungen und CLAUDE.md-Regeln.

Ein Skill reicht aus, solange er Ihnen oder einem einzelnen Projekt dient. Erstellen Sie ein Plugin, um mehrere Komponenten gemeinsam zu installieren, projektübergreifend zu teilen oder versioniert zu veröffentlichen.

Die Version wurde nicht geändert. Ist eine Version in plugin.json gesetzt, meldet claude plugin update bereits latest, bis Sie sie anheben. Lassen Sie das Feld alternativ weg, dann entscheidet der Commit-SHA.

Bei einem privaten Repository tragen Sie extraKnownMarketplaces und enabledPlugins in die Datei.claude/settings.json des Repositorys oder in die verwalteten Einstellungen ein. Repository-Einträge greifen, nachdem jeder Beitragende dem Ordner vertraut hat. Verwaltete Einstellungen lassen sich nicht überschreiben.

Nicht automatisch. Anthropic weist darauf hin, dass ein Plugin Code mit Ihren Nutzerrechten ausführen kann. Prüfen Sie Hooks, MCP-Konfiguration und bin/ unabhängig von der Stufe.

Ja, mit derselben Ereignis- und Matcher-Struktur, eingebettet in einen übergeordneten "hooks"-Schlüssel. Entfernen Sie das Original danach, sonst läuft es doppelt.