Claude-Code-Plugins: installieren, prüfen und entfernen

Ein Plugin bündelt Anweisungen oder Werkzeuge, die Sie zwischen Projekten mitnehmen möchten. Testen Sie die Installation zunächst mit einem eigenen Paket: eine ausdrücklich aufgerufene Skill gibt eine bekannte Zeichenfolge zurück. Ein fremdes Paket mit unbekannten Hooks ist dafür nicht nötig.

Das Beispiel setzt macOS/Linux und ein eingerichtetes Claude Code voraus. Unter Windows können Sie dieselben JSON- und Markdown-Dateien im Editor erstellen; die Shell-Befehle verwenden Bash oder Zsh. Eine Modellantwort benötigt eine funktionierende Verbindung. Die Strukturprüfung erfolgt unabhängig davon.

Drei Dateien anlegen

Beginnen Sie in einem neuen, leeren Verzeichnis:

mkdir -p plugin-lab/.claude-plugin
mkdir -p plugin-lab/plugins/load-check/.claude-plugin
mkdir -p plugin-lab/plugins/load-check/skills/ping

Speichern Sie das Manifest in plugin-lab/plugins/load-check/.claude-plugin/plugin.json:

{
  "name": "load-check",
  "version": "1.0.0",
  "description": "Local plugin loading exercise"
}

In plugin-lab/plugins/load-check/skills/ping/SKILL.md:

---
description: Return a marker to verify this local plugin is loaded.
disable-model-invocation: true
---

Return exactly PLUGIN_READY. Do not use tools or change files.

In plugin-lab/.claude-plugin/marketplace.json:

{
  "name": "local-load-lab",
  "owner": {"name": "Local developer"},
  "plugins": [
    {"name": "load-check", "source": "./plugins/load-check"}
  ]
}

Der Marketplace verweist auf das Paket. Darin enthält .claude-plugin das Manifest; skills liegt daneben. Eine Ablage von skills innerhalb von .claude-plugin widerspricht der dokumentierten Struktur.

Prüfen und installieren

Im Ausgangsverzeichnis:

claude --version
claude plugin validate ./plugin-lab/plugins/load-check
claude plugin validate ./plugin-lab
claude

Beheben Sie bei einem Validierungsfehler zuerst das Problem in der genannten Datei. Eine gültige Struktur belegt weder gute Anweisungen noch die Sicherheit eines beliebigen Plugins.

In der Claude-Code-Sitzung:

/plugin marketplace add ./plugin-lab
/plugin install load-check@local-load-lab

Wählen Sie im Installationsdialog Local, um den Versuch auf das aktuelle Projekt zu beschränken. Lesen Sie vor der Bestätigung, wo die Einstellung gespeichert wird. Falls die Zusammenfassung ein Neuladen verlangt, führen Sie /reload-plugins aus. Der Ablauf steht im Marketplace-Leitfaden.

Die geladene Skill prüfen

/plugin list
/load-check:ping

Der erste Befehl sollte das installierte Paket anzeigen, der zweite PLUGIN_READY zurückgeben. Der vollständige Name /load-check:ping enthält den Plugin-Namensraum und unterscheidet die Skill von gleichnamigen Skills anderer Pakete.

Kontrollieren Sie außerdem das Arbeitsverzeichnis: Die Skill darf keine Dateien ändern. Das Verbot, Werkzeuge zu benutzen, ist eine Modellanweisung und keine eigene Systemberechtigungsgrenze. Den Zugriff steuern die Claude-Code-Berechtigungen.

Fehlt der Befehl, prüfen Sie der Reihe nach den Manifestnamen, den Pfad skills/ping/SKILL.md, den Installationsbereich, den Zustand enabled und den Bedarf zum Neuladen. Marketplace-Laden und Start mit --plugin-dir sind getrennte Tests.

Deaktivieren, aktualisieren und entfernen

claude plugin disable load-check@local-load-lab --scope local
claude plugin enable load-check@local-load-lab --scope local
claude plugin update load-check@local-load-lab --scope local
claude plugin uninstall load-check@local-load-lab --scope local

Führen Sie die Befehle einzeln im selben Projekt aus und kontrollieren Sie das Ergebnis. --scope local entspricht dem gewählten Bereich; ohne diese Option verwenden update und uninstall standardmäßig user. Starten Sie nach dem Update neu, falls der CLI dies verlangt. Öffnen Sie nach Deaktivierung oder Deinstallation eine neue Sitzung und prüfen Sie, dass die Skill fehlt; nach Aktivierung wiederholen Sie den Test.

Ändern Sie für einen Inhaltstest zuerst den Marker der ursprünglichen Skill und erhöhen Sie die Paketversion. Aktualisieren Sie anschließend Marketplace und installiertes Plugin nach der Verwaltungsanleitung. Änderungen an der Quelldatei erreichen eine zwischengespeicherte installierte Kopie nicht zwangsläufig.

Vor der Installation fremder Plugins

Prüfen Sie den Paketinhalt. Eine Text-Skill, ein Shell-Hook und ein MCP-Server haben unterschiedliche Auswirkungen. Kontrollieren Sie Befehle, externe Adressen und Anweisungen, die Geheimnisse verlangen. Erteilen Sie keine zusätzlichen Rechte allein zur Beseitigung einer Fehlermeldung.

Wiederholen Sie im Arbeitsprojekt den kurzen Ablauf: bekannter Bereich, sichtbare Komponente, erwartete Aktion, Dateiprüfung und klare Deaktivierung. Die Plugin-Referenz beschreibt Format und Validator vollständig.