Plugin

Ein Plugin ist ein verteilbares Bündel von Claude Code-Erweiterungen. Es verpackt eine Sammlung von Komponenten, wie z. B. Skills, Agents, Hooks, MCP-Server oder LSP-Server, in einer einzigen Einheit zur einfacheren Verteilung und Verwaltung.

Die Plugin-Manifestdatei, eine Datei namens plugin.json, befindet sich im Verzeichnis .claude-plugin/ des Plugins. Skills, die in einem Plugin enthalten sind, befinden sich im Unterverzeichnis skills/. Diese Skills werden automatisch mit dem Namen des Plugins benannt. Beispielsweise ist ein Skill unter my-plugin/skills/review/SKILL.md als /my-plugin:review zugänglich. Diese Namensraumung verhindert Konflikte mit lokal oder innerhalb eines Projekts installierten Skills.

Für einen Skill, der sich direkt im Stammverzeichnis des Plugins befindet (ein Plugin-Root SKILL.md), wird der Befehlsname durch das Feld name in seinem Frontmatter bestimmt. Wenn das Feld name fehlt, wird der Verzeichnisname des Plugins als Befehlsname verwendet.

Umgekehrt kann ein Skill-Verzeichnis auch als Plugin fungieren, indem es eine Datei .claude-plugin/plugin.json enthält. Dies ermöglicht es einem einzelnen Skill-Verzeichnis, zusätzliche Komponenten wie Agents, Hooks und MCP-Server zu bündeln. Bei Verwendung dieser Methode innerhalb des Verzeichnisses .claude/skills/ eines Projekts muss zuerst der Dialog zur Arbeitsbereichvertrauensstellung akzeptiert werden.

Aus Sicherheitsgründen sind Subagents innerhalb von Plugins bestimmte Frontmatter-Felder deaktiviert: hooks, mcpServers und permissionMode. Um Änderungen an den Verzeichnissen hooks/, .mcp.json, agents/ und output-styles/ eines Plugins anzuwenden, müssen Sie den Befehl /reload-plugins ausführen.