Claude Code Plugins: Der vollständige Leitfaden für Skills, Hooks und Marketplace

Claude Code Plugins erweitern den KI-Assistenten um wiederverwendbare Funktionen, die du einmal einrichtest und dauerhaft nutzt. Wer regelmäßig mit Claude Code arbeitet, stößt schnell an die Grenzen der Standardkonfiguration. Plugins lösen dieses Problem, indem sie neue Befehle, automatisierte Abläufe und spezialisierte Agenten direkt in den Workflow integrieren.

Was sind Claude Code Plugins und warum sind sie nützlich?

Ein Claude Code Plugin ist ein Erweiterungspaket, das neue Fähigkeiten in die CLI bringt. Plugins bündeln Skills, Hooks, Agents und Commands zu einer installierbaren Einheit. Du aktivierst sie mit einem einzigen Befehl und sie stehen sofort in jeder Sitzung zur Verfügung.

Ohne Plugins schreibst du bei jedem Projekt dieselben Anweisungen erneut. Mit einem Plugin definierst du diese Anweisungen einmal und rufst sie mit einem kurzen Skill-Namen ab. Das spart Zeit und hält die Qualität der Ergebnisse konsistent.

Besonders nützlich sind Plugins für Teams: Ein Entwickler konfiguriert das Plugin, alle anderen installieren es und arbeiten sofort mit denselben Regeln und Workflows. Das fügt sich gut in eine breitere Workflow-Automatisierung ein, die über Claude Code hinausgeht. Wer sich auch für den Open-Source-Kontext von Claude interessiert, findet auf unserer Seite zu OpenClaude einen guten Einstieg in das Ökosystem.

Wie der Claude Code Plugin-Marketplace funktioniert

Der Marketplace ist das zentrale Verzeichnis für öffentlich verfügbare Claude Code Plugins. Anthropic betreibt einen offiziellen Marktplatz, auf dem sowohl eigene als auch von der Community veröffentlichte Plugins gelistet sind. Jedes Plugin enthält eine Beschreibung, eine Versionsnummer und eine Installationsanleitung.

Du durchsuchst den Marketplace direkt aus Claude Code heraus oder über das Web-Interface. Die Suche filtert nach Kategorie, Popularität und Kompatibilität. Sobald du ein Plugin gefunden hast, brauchst du nur den Plugin-Namen und führst den Installationsbefehl aus.

Jedes Plugin im Marketplace durchläuft vor der Veröffentlichung eine Sicherheitsprüfung. Anthropic prüft den Code auf bekannte Schwachstellen und Datenschutzverstöße. Community-Plugins tragen ein entsprechendes Label, das sie von offiziell zertifizierten Erweiterungen unterscheidet.

Plugins installieren: Schritt-für-Schritt-Anleitung

Das Installieren eines Claude Code Plugins dauert unter einer Minute. Du benötigst eine laufende Claude Code Installation und einen Plugin-Namen aus dem Marketplace.

Plugin über den /plugin-Befehl hinzufügen

Öffne Claude Code und führe den folgenden Befehl aus, um ein Plugin hinzuzufügen. Ersetze plugin-name mit dem tatsächlichen Namen aus dem Marketplace:

/plugin install plugin-name

Claude Code lädt das Plugin herunter, validiert es und aktiviert es für die aktuelle Sitzung. Du siehst eine Bestätigung mit der installierten Version und den verfügbaren Skill-Namen.

Plugin global für alle Projekte aktivieren

Standardmäßig installiert Claude Code Plugins projektspezifisch in das lokale .claude/-Verzeichnis. Um ein Plugin global zu aktivieren und in jedem Projekt zu nutzen, hängst du das Flag --global an:

/plugin install plugin-name --global

Globale Plugins werden in ~/.claude/plugins/ gespeichert und bei jedem Start automatisch geladen. Eine explizite Aktivierung pro Sitzung entfällt damit.

Installierte Plugins auflisten und prüfen

Mit diesem Befehl siehst du alle aktiven Plugins auf einen Blick:

/plugin list

Die Ausgabe zeigt Skill-Namen, Versionsnummern und den Aktivierungsstatus jedes installierten Plugins. Mit dem Flag --verbose bekommst du zusätzlich die Pfade und geladenen Hooks.

Skills und Hooks: Die wichtigsten Plugin-Typen erklärt

Innerhalb eines Plugins gibt es verschiedene Komponenten. Skills und Hooks decken zusammen den Großteil aller Plugin-Funktionen ab und bilden das Fundament jeder Claude Code Erweiterung.

Was sind Skills?

Ein Skill ist ein wiederverwendbarer Verhaltensblock, den du mit einem Slash-Befehl aufrufst. Du verwendest den Skill-Namen direkt im Terminal, zum Beispiel:

/review --strict

Der Skill enthält vordefinierte Anweisungen, Templates oder Workflows. Claude Code führt diese aus, als hättest du sie manuell eingetippt. Skills eignen sich für Aufgaben, die sich täglich wiederholen: Code-Reviews, Test-Generierung, Dokumentation, Deployment-Checklisten.

Jeder Skill trägt einen eindeutigen Skill-Namen, der im Plugin-Manifest definiert wird. Dieser Name darf keine Sonderzeichen oder Leerzeichen enthalten und muss systemweit eindeutig sein.

Was sind Hooks?

Hooks reagieren automatisch auf Ereignisse in Claude Code. Du konfigurierst einen Hook so, dass er vor oder nach bestimmten Aktionen ausgeführt wird, ohne dass du ihn manuell aufrufst.

Typische Hook-Trigger sind:

• PreToolUse: Läuft bevor Claude Code ein Tool aufruft.
• PostToolUse: Läuft nach einem abgeschlossenen Tool-Aufruf.
• Stop: Läuft wenn eine Claude Code Sitzung beendet wird.
• SessionStart: Läuft bei jeder neuen Sitzung automatisch.

Ein praktisches Beispiel: Du richtest einen Hook ein, der nach jedem Datei-Edit automatisch einen Linter ausführt. Der Hook läuft im Hintergrund, während du weiterarbeitest.

Unterschied im Überblick

Agents und Commands: Erweiterte Plugin-Funktionen nutzen

Neben Skills und Hooks bieten Plugins zwei weitere Komponenten: Agents und Commands. Diese kommen in komplexeren Plugins zum Einsatz, die über einfache Verhaltensregeln hinausgehen.

Agents in Plugins

Ein Agent innerhalb eines Plugins ist ein spezialisierter Sub-Prozess, der eigenständig mehrstufige Aufgaben übernimmt. Du übergibst dem Agenten einen Task, er plant die Schritte selbst und führt sie mit den verfügbaren Tools aus. Agents arbeiten auch parallel, wenn mehrere unabhängige Aufgaben gleichzeitig anfallen.

Ein Plugin kann mehrere Agents definieren, jeden mit einem anderen Spezialisierungsgebiet. Ein SEO-Plugin könnte beispielsweise einen Analyse-Agenten und einen Schreib-Agenten beinhalten, die koordiniert zusammenarbeiten. Wer die Möglichkeiten dieser Agents im Unternehmenskontext erkunden möchte, findet auf unserer Seite zu KI-Unterstützung weiterführende Informationen.

Commands definieren

Commands sind Slash-Befehle, die ein Plugin dem System hinzufügt. Im Unterschied zu Skills sind Commands direkter: Sie lösen eine konkrete Aktion aus, statt ein komplexes Verhalten zu definieren. Ein Command sieht im Aufruf so aus:

/plugin-command --flag wert

Commands nehmen Argumente entgegen und geben strukturierten Output zurück. Du kannst ihre Ausgabe in Hooks weiterverwenden oder in Shell-Skripte pipeln.

JSON-Konfiguration: So richtest du Plugins korrekt ein

Jedes Claude Code Plugin verwendet eine JSON-Konfigurationsdatei, die seine Struktur beschreibt. Diese Datei heißt in der Regel plugin.json und liegt im Wurzelverzeichnis des Plugins.

Eine minimale JSON-Konfiguration für ein eigenes Plugin sieht so aus:

{
  "name": "mein-plugin",
  "version": "1.0.0",
  "description": "Automatisiert Code-Reviews für TypeScript",
  "skills": [
    {
      "name": "review",
      "description": "Führt einen strukturierten Code-Review durch",
      "file": "skills/review.md"
    }
  ],
  "hooks": [
    {
      "event": "PostToolUse",
      "command": "bash scripts/lint.sh"
    }
  ]
}

Die JSON-Konfiguration referenziert alle Komponenten des Plugins. Jeder Skill-Name muss eindeutig sein und darf keine Leerzeichen enthalten. Hooks verweisen auf ausführbare Skripte oder Shell-Befehle, die Claude Code nach dem jeweiligen Ereignis startet.

Plugin-Einstellungen in der globalen settings.json

Claude Code liest Plugin-Einstellungen auch aus der globalen settings.json. Dort aktivierst, deaktivierst oder konfigurierst du Plugins mit Umgebungsvariablen:

{
  "plugins": {
    "mein-plugin": {
      "enabled": true,
      "config": {
        "API_KEY": "dein-api-schluessel",
        "language": "de"
      }
    }
  }
}

Diese Trennung zwischen Plugin-Manifest und Nutzer-Konfiguration hält sensible Zugangsdaten aus dem versionierten Plugin-Code heraus. Besonders in Team-Projekten ist das ein wichtiger Sicherheitsfaktor.

Offizieller Anthropic-Marktplatz vs. Community-Plugins

Nicht alle Plugins kommen aus demselben Verzeichnis. Du unterscheidest zwischen offiziell von Anthropic entwickelten Plugins und Community-Plugins, die externe Entwickler veröffentlichen.

Offizielle Plugins aus der Claude Code Dokumentation von Anthropic durchlaufen eine gründliche Sicherheitsprüfung und werden langfristig gepflegt. Sie erscheinen im Marketplace mit einem “Verified”-Badge. Community-Plugins verlangen mehr Eigenverantwortung: Lies den Quellcode, bevor du sie in produktive Systeme integrierst.

Die wichtigsten Unterschiede auf einen Blick:

• Offizielle Plugins: Sicherheitsgeprüft, langfristig gepflegt, direkt von Anthropic supportet.
• Community-Plugins: Größere Auswahl, schnellere Innovation, höheres Eigenrisiko beim Einsatz.
• Interne Plugins: Selbst entwickelt, nicht im Marketplace gelistet, nur im eigenen Team verwendet.

Für Unternehmensumgebungen empfiehlt sich eine Plugin-Allowlist in der settings.json, die nur geprüfte Pakete zulässt und nicht autorisierte Installationen blockiert.

Häufige Fehler beim Einrichten von Claude Code Plugins vermeiden

Die meisten Installationsprobleme entstehen durch Konfigurationsfehler in der JSON-Datei oder durch Namenskonflikte zwischen Plugins. Die drei häufigsten Stolpersteine kennst du nach diesem Abschnitt.

Skill-Namen-Konflikte zwischen Plugins

Wenn zwei Plugins denselben Skill-Namen definieren, lädt Claude Code nur das zuletzt installierte. Du prüfst Konflikte mit:

/plugin list --verbose

Die Ausgabe zeigt, welcher Skill welchem Plugin zugeordnet ist. Benenne einen der Skill-Namen in der jeweiligen plugin.json um, um den Konflikt dauerhaft zu lösen.

Hook-Skripte ohne Ausführungsrechte

Ein Hook, der auf ein Shell-Skript verweist, schlägt lautlos fehl, wenn das Skript keine Ausführungsrechte hat. Setze die Rechte einmalig mit:

chmod +x scripts/mein-hook.sh

Das ist der häufigste Grund, warum Hooks nach der Installation still versagen, ohne eine Fehlermeldung auszugeben.

Ungültige JSON-Syntax in plugin.json

Claude Code lehnt Plugins mit fehlerhaftem JSON kommentarlos ab. Prüfe die Konfigurationsdatei vor der Installation mit dem eingebauten Python-Validator:

cat plugin.json | python3 -m json.tool

Ein fehlendes Komma oder eine falsch geschlossene geschweifte Klammer verhindert die gesamte Plugin-Aktivierung. Der Validator zeigt dir die genaue Zeile mit dem Syntaxfehler.

Häufige Fragen zu Claude Code Plugins

Was ist der Unterschied zwischen Skills und Hooks?

Skills rufst du manuell mit ihrem Skill-Namen auf. Du tippst den Slash-Befehl und Claude Code führt den definierten Workflow aus. Hooks laufen automatisch bei bestimmten Ereignissen, ohne dass du eingreifst. Ein Hook reagiert auf den Systemzustand, ein Skill auf deinen Aufruf.

Kann ich eigene Claude Code Plugins erstellen?

Ja. Du erstellst ein Verzeichnis mit einer gültigen plugin.json und den dazugehörigen Skill-Dateien. Danach installierst du das Plugin lokal über den Pfad:

/plugin install ./pfad/zu/meinem-plugin

Eigene Plugins lassen sich auch im Community-Marketplace veröffentlichen, indem du ein Pull Request im offiziellen Repository einreichst.

Funktionieren Claude Code Plugins auch in Claude Desktop?

Die Plugin-Architektur ist spezifisch für Claude Code. Claude Desktop verwendet ein eigenes Erweiterungsmodell, das auf dem Model Context Protocol (MCP) basiert. Einige Konzepte überschneiden sich, aber Plugins aus dem Claude Code Marketplace lassen sich nicht direkt in Claude Desktop importieren.

Wie aktualisiere ich ein installiertes Plugin?

Du aktualisierst ein Plugin mit dem Update-Befehl:

/plugin update plugin-name

Claude Code lädt die neueste Version aus dem Marketplace und ersetzt die bestehende Installation. Deine lokale Konfiguration in settings.json bleibt dabei unverändert.

Was ist der Unterschied zwischen einem Plugin und einem MCP-Server?

Ein MCP-Server stellt Tools und Ressourcen über das Model Context Protocol bereit, typischerweise als separater Prozess, der parallel zu Claude Code läuft. Ein Plugin ist direkter Bestandteil der Claude Code Konfiguration und enthält Skills, Hooks und Commands ohne externen Serverprozess. MCP-Server eignen sich für komplexe Integrationen mit externen APIs, Plugins für Claude-interne Workflows und Verhaltensregeln.