Claude-Code-Plugins: Kosten und Installation erklärt

Was ein Claude-Code-Plugin ist

Ein Claude-Code-Plugin ist ein Verzeichnis mit Komponenten, das Claude Code als eine Einheit lädt und verwaltet. Diese Komponenten sind Skills, Agents, Hooks, MCP-Server, LSP-Server und Hintergrundmonitore. Durch die Installation eines Plugins werden alle Bestandteile unter einem Namen hinzugefügt. Beim Deaktivieren werden sie auf dieselbe Weise entfernt.

Ein Plugin verleiht dem Agent keine Fähigkeiten, über die er nicht bereits verfügt. Jeder Bestandteil eines Plugins lässt sich manuell in einem .claude/-Verzeichnis anlegen. Das Plugin ist die Verpackungsebene: Sie ermöglicht, diese Bestandteile zu versionieren, an fünfzehn Personen zu verteilen und später zu aktualisieren, ohne alle zum Kopieren von Dateien aufzufordern. Das ist der gesamte Zweck. Die meisten Missverständnisse zu Plugins entstehen, weil sie als neue Art von Fähigkeit verstanden werden.

Das optionale Manifest unter .claude-plugin/plugin.json legt den Namen des Plugins fest. Dieser Name wird zum Namespace. Ein Skill in einem Plugin namens commit-commands wird als /commit-commands:commit aufgerufen. Daher können zwei Plugins jeweils einen Skill namens commit bereitstellen, ohne dass einer den anderen überschreibt. Plugin-Agents sind in der @-Mention-Liste auf dieselbe Weise abgegrenzt, etwa als plugin-name:agent-name.

Plugin, Skill, MCP-Server oder Regeldatei

Diese vier Begriffe werden so verwendet, als würden sie miteinander konkurrieren. Das tun sie nicht. Die Abgrenzung sollte einmal klar benannt werden.

• Ein Skill ist eine einzelne Anleitungseinheit, die Claude lädt, wenn die Aufgabe dies erfordert. Siehe was ein Agent Skill tatsächlich ist.
• Ein MCP-Server ist ein separater Prozess, der dem Agenten über ein Protokoll Tools bereitstellt. Häufig handelt es sich um einen Netzwerkdienst, den Sie selbst betreiben.
• Eine Regeldatei wie CLAUDE.md ist Projektkontext. Sie wird zu Beginn der Sitzung eingelesen und gilt für alles.
• Ein Plugin ist ein Container, der Skills, Agenten, Hooks und MCP-Serverdefinitionen gemeinsam enthalten kann. Zusätzlich enthält es eine Versionsnummer und einen Distributionskanal.

Die Frage, die ein Plugin beantwortet, lautet daher nicht: „Was kann der Agent tun?“ Sie lautet: „Wie verteile ich das an mein Team und aktualisiere es im nächsten Monat?“ Wenn Sie zwischen den ersten drei Optionen wählen, behandelt der Vergleich von Skills, MCP-Servern und Regeldateien diese Entscheidung ausführlich. Wenn es Ihnen um den MCP-Teil geht, behandelt das Betreiben eigener MCP-Server auf einem VPS die Hosting-Seite.

Wo Plugins liegen und was darin enthalten ist

Ein über einen Marketplace installiertes Plugin wird nach ~/.claude/plugins/cache in einen lokalen Cache kopiert. Es wird nicht an dem Ort ausgeführt, an dem es geklont wurde. Jede installierte Version erhält ein eigenes Verzeichnis. Beim Aktualisieren oder Deinstallieren wird das Verzeichnis der alten Version als verwaist markiert und etwa zwei Wochen später gelöscht. Eine Sitzung, die die alte Version bereits geladen hat, kann dadurch weiterarbeiten, statt während einer Aufgabe fehlschlagen.

Da sich der Pfad bei jeder Aktualisierung ändert, darf ein Plugin seinen eigenen Speicherort niemals fest im Code hinterlegen. Hooks und MCP-Konfigurationen innerhalb eines Plugins verwenden ${CLAUDE_PLUGIN_ROOT}. Dieser Ausdruck wird in das aktuelle Installationsverzeichnis aufgelöst. Zustände, die eine Aktualisierung überdauern müssen, gehören nach ${CLAUDE_PLUGIN_DATA}. Dieser Ausdruck wird in ein stabiles Verzeichnis unter ~/.claude/plugins/data/ aufgelöst.

Nur das eigene Verzeichnis des Plugins wird in den Cache kopiert. Daraus ergibt sich ein Problem, das häufig erst spät auffällt. Ein Pfad, der außerhalb des Plugin-Stammverzeichnisses liegt, beispielsweise ../shared-utils, funktioniert während der Entwicklung mit einem lokalen Pfad und schlägt nach der Installation fehl, weil diese Dateien nicht kopiert wurden.

Die Struktur sieht so aus.

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── code-review/
│       └── SKILL.md
├── agents/
├── hooks/
│   └── hooks.json
├── .mcp.json
└── bin/

Nur plugin.json gehört in .claude-plugin/. Alles andere liegt im Plugin-Stammverzeichnis. Wenn skills/ oder hooks/ in .claude-plugin/ abgelegt werden, ist das der häufigste Grund dafür, dass ein Plugin problemlos installiert wird und anschließend überhaupt nichts tut: Claude Code sucht diese Verzeichnisse im Stammverzeichnis, findet sie dort nicht und lädt ein Plugin ohne Komponenten.

Das Manifest selbst ist kurz.

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

So installieren Sie ein Claude-Code-Plugin

Die Installation erfolgt in zwei Schritten. Der erste Schritt installiert noch nichts. Sie fügen zunächst einen Marketplace hinzu, also einen Plugin-Katalog. Danach installieren Sie einzelne Plugins daraus. Der offizielle Marketplace von Anthropic, claude-plugins-official, wird beim ersten interaktiven Start von Claude Code automatisch für Sie registriert. Andere Marketplaces fügen Sie selbst hinzu.

/plugin marketplace add anthropics/claude-code
/plugin install commit-commands@claude-code-plugins

Beachten Sie, dass das Repository anthropics/claude-code heißt, der Marketplace jedoch claude-code-plugins. Der Name stammt aus der Katalogdatei im Repository und nicht aus dem Repository-Pfad. Lesen Sie den Marketplace-Namen daher auf dem Tab Marketplaces von /plugin ab, bevor Sie einen Installationsbefehl eingeben.

Lesen Sie nach der Installation die Zusammenfassungszeile. Plugin is now active. bedeutet, dass die Komponenten in dieser Sitzung geladen sind. Run /reload-plugins to activate. bedeutet, dass sie nicht geladen sind und Sie diesen Befehl ausführen müssen. Wenn /reload-plugins warnt, dass die Konversation erneut eingelesen wird, führen Sie den Befehl als /reload-plugins --force erneut aus. Prüfen Sie anschließend, ob das Plugin tatsächlich vorhanden ist: /plugin zeigt es auf dem Tab Installed an, /help listet seine Skills unter Custom commands auf. Alles, was nicht geladen werden konnte, erscheint auf dem Tab Errors einschließlich des Grundes.

Bei der Installation müssen Sie einen Geltungsbereich auswählen. Dieser legt fest, wer das Plugin erhält. Der Benutzer-Geltungsbereich gilt für Sie und für jedes Projekt. Der Projekt-Geltungsbereich schreibt das Plugin im Repository unter .claude/settings.json in enabledPlugins, sodass es allen angeboten wird, die das Repository klonen. Der lokale Geltungsbereich gilt nur für Sie und nur in diesem Repository.

Verwenden Sie für ein Script, ein Dockerfile oder jede Sitzung ohne interaktives Panel die Shell-Form. Sie installiert das Plugin standardmäßig im Benutzer-Geltungsbereich, sofern Sie nicht --scope übergeben.

claude plugin install commit-commands@claude-code-plugins --scope project
claude plugin list

claude plugin install wird außerhalb einer Sitzung ausgeführt. Eine bereits geöffnete Sitzung erkennt das neue Plugin daher erst nach der Ausführung von /reload-plugins oder nach dem Start einer neuen Sitzung.

Die Verwaltung installierter Plugins funktioniert an beiden Stellen nach demselben Muster. /plugin list gibt die installierten Plugins aus und akzeptiert --enabled oder --disabled. /plugin disable name@marketplace deaktiviert ein Plugin, ohne es zu entfernen. /plugin enable aktiviert es wieder, und /plugin uninstall entfernt es. Die Slash-Befehle öffnen das Plugin-Panel, um die Änderung anzuwenden. Deshalb sollten Sie in Scripts die entsprechenden Shell-Varianten claude plugin ... verwenden.

Um einen Marketplace einem gesamten Team bereitzustellen, tragen Sie ihn in .claude/settings.json des Projekts ein. Mitglieder werden zur Installation aufgefordert, sobald sie dem Repository-Ordner vertrauen.

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

Wenn Sie ein eigenes Plugin entwickeln, können Sie den Marketplace vollständig überspringen. claude --plugin-dir ./my-plugin lädt ein Verzeichnis für diese Sitzung. /reload-plugins übernimmt Ihre Änderungen ohne Neustart. claude plugin validate ./my-plugin prüft das Manifest, die Frontmatter von Skill und Agent sowie hooks/hooks.json, bevor andere das Plugin verwenden.

Was kostet ein Claude-Code-Plugin?

Der Mechanismus ist kostenlos. Im August 2026 fallen keine Kosten dafür an, einen Marketplace hinzuzufügen, ein Plugin zu installieren oder es aktiviert zu lassen. Die offiziellen und Community-Marketplaces sind öffentliche Git-Repositories, und ein Plugin ist ein Verzeichnis mit Textdateien.

Was ein Plugin kostet, sind Tokens. Tokens werden tatsächlich über Ihre Abonnementnutzung oder Ihre API-Abrechnung gemessen. Diese Kosten entstehen auf drei verschiedene Arten, die sich unterschiedlich verhalten.

Kosten für den dauerhaften Kontext. Die Inhalte eines Plugins werden in Ihren Kontext aufgenommen und bei jeder Eingabe der Sitzung erneut gelesen. Vor der Installation zeigt die /plugin-Detailansicht eine Context cost-Schätzung in Tokens sowie einen Will install-Abschnitt mit den Commands, Skills, Agents, Hooks sowie MCP- und LSP-Servern, die Sie hinzufügen werden. Lesen Sie beides. Plugins aus lokalen oder benutzerdefinierten Marketplaces liefern diese Daten möglicherweise nicht. Dann müssen Sie den Aufwand selbst schätzen. Ein Plugin, das einen MCP-Server bündelt, ist normalerweise am umfangreichsten, weil Tool-Definitionen groß sind. Bei Modellen mit Unterstützung für die MCP-Tool-Suche werden diese Definitionen jedoch erst geladen, wenn ein Tool benötigt wird.

Kosten bei der Ausführung. Wenn Sie den Skill eines Plugins ausführen, werden dessen Anweisungen an die Konversation angehängt. Der Inhalt des Skills wird daher nur bei seiner Verwendung berechnet. Ein Agent verhält sich anders. Ein Subagent führt eine eigene Konversation mit einem eigenen System-Prompt und einem eigenen Cache aus. Dabei gibt es zu Beginn keine Cache-Treffer. Ein Plugin, dessen Workflow Agents startet, kostet daher deutlich mehr, als seine Kontextschätzung vermuten lässt.

Cache-Kosten. Wenn Sie ein Plugin während einer Sitzung aktivieren oder deaktivieren, kann die nächste Anfrage die gesamte Konversation erneut verarbeiten müssen. Skills, Commands, Agents, Hooks, LSP-Server, Monitore und Themes tun dies nie. Ihre Inhalte werden hinter dem bestehenden Verlauf angehängt. Die nächste Anfrage berechnet daher den neuen Inhalt und liest alles davor weiterhin aus dem Cache. Die Ausnahme ist ein Plugin, das einen MCP-Server bereitstellt. Wenn dessen Tools durch die Tool-Suche verzögert geladen werden, bleibt der Cache erhalten. Wenn sie in den Prompt-Präfix geladen werden, liest die nächste Anfrage die gesamte Konversation erneut als nicht zwischengespeicherten Input. Genau deshalb warnt /reload-plugins in diesem Fall und verweigert den Vorgang, bis Sie --force übergeben.

Sie können dies beobachten, statt es zu schätzen. Jede API-Antwort enthält cache_read_input_tokens und cache_creation_input_tokens. Eine benutzerdefinierte Statuszeile mit der aktuellen Token-Nutzung zeigt Ihnen beide Werte direkt an. In einer gesunden Sitzung werden deutlich mehr Tokens gelesen als erzeugt. Wenn die Anzahl der erzeugten Tokens über viele Eingaben hinweg hoch bleibt, ändert sich etwas in Ihrem Präfix bei jeder Eingabe. Einen umfassenderen Überblick darüber, was das Kontextfenster füllt, finden Sie unter Verwalten des Claude-Code-Kontextfensters und Was diese Token-Zählwerte tatsächlich bedeuten.

Ein wenig Aufräumarbeit macht sich bezahlt. Der Tab Installed gruppiert Plugins, die Sie seit mindestens zwei Wochen nicht verwendet haben, unter der Überschrift Not used recently. In der Detailansicht wird außerdem eine Last used-Zeile angezeigt. Diese Plugins kosten Sie in jeder Sitzung weiterhin Startzeit und Kontext. Deaktivieren oder deinstallieren Sie sie.

Ein Plugin wird mit Ihren Berechtigungen ausgeführt

Die eigene Dokumentation von Anthropic formuliert es eindeutig: Plugins und Marktplätze sind Komponenten mit weitreichendem Vertrauen. Sie können auf Ihrem Rechner beliebigen Code mit den Berechtigungen Ihres Benutzers ausführen. Das ist keine hypothetische Gefahr. Die Hooks eines Plugins führen bei Sitzungsereignissen Shell-Befehle aus, auch vor und nach Tool-Aufrufen. Das Verzeichnis bin/ des Plugins wird in PATH des Bash-Tools aufgenommen, solange das Plugin aktiviert ist. Die MCP-Server des Plugins sind Prozesse, die das Plugin startet. Nichts davon ist von Ihrem Benutzerkonto isoliert.

Auf einem Laptop wird dieses Risiko durch den Zugriff eingeschränkt, den Ihr Desktop-Benutzer hat. Auf einem Server ist das normalerweise nicht der Fall. Das Konto, unter dem der Agent läuft, besitzt häufig SSH-Schlüssel, Deployment-Tokens, eine aktive Cloud-CLI-Sitzung und Zugriff auf den Docker-Socket. Daher bedeutet „beliebiger Code mit Ihren Benutzerrechten“ praktisch: Zugriff auf die Maschine. Wenn Claude Code auf einem VPS läuft, lesen Sie vor jeder Installation wie Sie Claude Code sicher auf einem VPS ausführen. Lesen Sie außerdem wie Sie Zugangsdaten vor einem Agenten schützen, bevor Sie ein Plugin installieren, das mit einem externen Dienst kommuniziert.

Einige Schutzmechanismen gibt es dennoch. Es ist wichtig zu wissen, welche das sind. Ein Plugin mit Projektbereich stammt aus dem Repository und nicht von Ihnen. Es wird daher erst geladen, nachdem Sie dem Workspace vertrauen. Seine MCP-Server benötigen weiterhin eine separate Genehmigung pro Server. Seine LSP-Server warten auf diese Vertrauensfreigabe. Hintergrundüberwachungen werden überhaupt nicht geladen. Von Plugins bereitgestellte Agents dürfen keine Hooks, MCP-Server oder einen Berechtigungsmodus deklarieren. Marketplace-Plugins werden mit übersprungenen Symlinks in den Cache kopiert, wenn diese außerhalb des Marktplatzes liegen. Ein Plugin kann dadurch keine beliebigen Dateien des Hosts einbinden.

Nichts davon ersetzt die Prüfung dessen, was Sie installieren. Prüfen Sie die Liste Will install. Bevorzugen Sie Plugins, deren Quellcode Sie öffnen und lesen können. Halten Sie die Plugins Ihres Teams in einem Marketplace-Repository, das Sie kontrollieren. Führen Sie claude plugin validate für alles aus, was Sie selbst schreiben.

FAQ

Verursachen Claude Code-Plug-ins zusätzliche Kosten?

Nein. Für das Plug-in-System, das Hinzufügen eines Marketplace oder die Installation eines Plug-ins fallen keine Gebühren an. Berechnet wird die Token-Nutzung, die wie jeder andere Kontext über Ihren Tarif oder Ihre API-Ausgaben abgerechnet wird. Ein Plug-in fügt bei jeder Interaktion dauerhaften Kontext hinzu. Beim Aufruf eines seiner Skills oder Agents kommt weiterer Kontext hinzu. Wenn es einen MCP-Server bereitstellt, dessen Tools in den Prompt-Präfix geladen werden, kann außerdem eine teure, nicht aus dem Cache bediente Interaktion erzwungen werden. Die Detailansicht /plugin zeigt vor der Installation eine Context cost-Schätzung.

Was ist der Unterschied zwischen einem Plug-in und einem Skill?

Ein Skill ist eine einzelne Anweisungseinheit. Ein Plug-in ist ein Paket, das Skills, Agents, Hooks, MCP-Server, LSP-Server und Monitore enthalten kann. Es verfügt über einen Namen und eine Version und wird aus einem Marketplace installiert. Schreiben Sie einen eigenständigen Skill in .claude/, wenn er für Sie und dieses Projekt bestimmt ist. Ein zweckgebundener Skill wie Ponytail, das den Agent zu der kleinsten funktionierenden Änderung führt ist dafür das klarste Beispiel: eine Datei mit einer einzigen Regel, bis Ihr Team ihn ebenfalls benötigt. Wandeln Sie ihn in ein Plug-in um, wenn andere Personen ihn benötigen und er im Laufe der Zeit aktualisiert werden muss. Plug-in-Skills verwenden Namespaces. Daher wird ein Skill innerhalb eines Plug-ins als /plugin-name:skill-name statt als /skill-name aufgerufen.

Mein Plug-in wurde installiert, aber seine Skills werden nicht angezeigt. Was ist falsch?

Prüfen Sie zuerst die Installationszusammenfassung. Wenn dort Run /reload-plugins to activate. stand, sind die Komponenten noch nicht geladen. Wenn der Reload darauf hinweist, dass die Konversation erneut eingelesen wird, führen Sie ihn als /reload-plugins --force erneut aus. Wenn die Komponenten geladen wurden, aber nichts angezeigt wird, öffnen Sie /plugin und lesen Sie den Tab Errors. Der häufigste strukturelle Fehler besteht darin, skills/, agents/ oder hooks/ innerhalb von .claude-plugin/ abzulegen. Dort sucht Claude Code nicht danach. Denken Sie daran, dass Plug-in-Skills Namespaces verwenden. Sie suchen daher im Tab Custom commands von /help nach /plugin-name:skill-name. Als letzte Möglichkeit führen Sie rm -rf ~/.claude/plugins/cache aus, starten Sie neu und installieren Sie das Plug-in erneut.

Kann ich Plug-ins ohne das interaktive Panel installieren?

Ja. Verwenden Sie den Shell-Befehl claude plugin install name@marketplace. Er installiert standardmäßig im Benutzerbereich, sofern Sie nicht --scope project oder --scope local übergeben. Der Befehl funktioniert in Skripten, Images und nicht interaktiven Umgebungen, in denen das Panel /plugin nicht verfügbar ist. Da er außerhalb einer Sitzung ausgeführt wird, benötigt eine bereits geöffnete Sitzung /reload-plugins, bevor das Plug-in wirksam wird.

Ist es sicher, ein Plug-in aus einem Marketplace zu installieren, den ich auf GitHub gefunden habe?

Behandeln Sie es so, als würden Sie das Installationsskript dieses Repositorys unter Ihrem eigenen Benutzerkonto ausführen. Das kommt dem tatsächlichen Verhalten nahe. Ein Plug-in kann über Hooks Shell-Befehle ausführen, ausführbare Dateien zum PATH des Bash-Tools hinzufügen und MCP-Server starten. All dies geschieht mit den Berechtigungen Ihres Benutzerkontos. Anthropic kontrolliert oder überprüft die Inhalte von Plug-ins anderer Anbieter nicht. Installieren Sie aus Quellen, deren Inhalte Sie lesen können. Prüfen Sie vor der Bestätigung die Liste Will install. Seien Sie auf einem Server strenger als auf einem Laptop, da das dort verwendete Konto normalerweise Schlüssel und Tokens enthält, die für Angreifer wertvoll sind.