Plugins für Claude Code erklärt

Ein Plugin für Claude Code ist ein Ordner, der Skills, Agenten, Hooks, MCP-Server und weitere Bausteine zu Claude Code hinzufügt, dem Coding-Agenten von Anthropic für die Kommandozeile. Plugins stammen aus Marktplätzen. Das sind Kataloge, die Sie aus einem GitHub-Repository, über eine Git-URL oder aus einem lokalen Ordner hinzufügen. Anthropics Anleitung zum Installieren von Plugins fordert Leser auf, vor der Installation zu prüfen, was ein Plugin hinzufügt, denn ein Plugin kann Hooks und MCP-Server ausführen.

Dieser Leitfaden folgt Claude Code 2.1.317, erschienen am 2. November 2026. Er zeigt, was ein Plugin enthalten kann, mit welchen Befehlen man eines installiert und entfernt und was der eingebaute Validator prüft. Getestet wurde auf einem Mac.

Wie Plugins in Claude Code funktionieren

Jedes Plugin hat ein Manifest, eine kleine JSON-Datei unter .claude-plugin/plugin.json. Laut Anthropics Plugin-Übersicht ist darin nur das Feld name Pflicht. Alles andere ist optional, und jeder Baustein hat seinen eigenen Platz:

Baustein	Wo er liegt	Was er tut
Skills	skills/<name>/SKILL.md	Anweisungen für eine Aufgabe, aufgerufen als /<plugin>:<name>
Agenten	agents/<name>.md	Hilfsagenten, an die Claude Arbeit abgeben kann
Hooks	hooks/hooks.json	Skripte, die zu festgelegten Zeitpunkten laufen, etwa bevor ein Tool läuft
Mods	ein Eintrag modules in hooks/hooks.json	JavaScript, das Fensterbereiche zeichnen und Befehle hinzufügen kann
MCP-Server	.mcp.json	Externe Tools, angebunden über das Model Context Protocol
LSP-Server	.lsp.json	Sprachhelfer der Art, wie sie Code-Editoren nutzen

MCP, das Model Context Protocol, ist ein Standardweg, um externe Tools mit einem KI-Agenten zu verbinden. Die Dokumentation erklärt Mods ganz schlicht: Ein Plugin mit einem Hooks-Modul „wird Mod genannt“.

Plugins erreichen Sie über Marktplätze. Der von Anthropic heißt claude-plugins-official, und Claude Code fügt ihn automatisch hinzu, wenn Sie zum ersten Mal eine interaktive Terminalsitzung starten. Der Community-Katalog claude-community wird nicht automatisch hinzugefügt. Claude Code akzeptiert die Namen des offiziellen Katalogs und des Community-Katalogs nur aus Repositorys unter github.com/anthropics/. Eine anderswo gehostete Kopie wird nicht mehr geladen und meldet den Fehler „Marketplace is registered from an untrusted source“ (Marktplatz ist aus einer nicht vertrauenswürdigen Quelle registriert).

So installieren, aktivieren und entfernen Sie ein Plugin

Jede Aktion gibt es in zwei Formen: als Befehl /plugin innerhalb einer Sitzung von Claude Code und als Befehl claude plugin in einem normalen Terminal. Die folgende Tabelle kombiniert Anthropics Dokumentation mit dem Hilfetext von Version 2.1.317.

Aktion	In einer Sitzung	Im Terminal
Marktplatz hinzufügen	/plugin marketplace add <source>	claude plugin marketplace add <source>
Installieren	/plugin install <plugin>@<marketplace>	claude plugin install <plugin>@<marketplace>
Ein- oder ausschalten	Tab „Installed“, dann die Leertaste	claude plugin enable <plugin> oder disable
Aktualisieren	Tab „Installed“, dann „Update now“	claude plugin update <plugin>
Entfernen	Tab „Installed“, dann „Uninstall“	claude plugin uninstall <plugin>
Details ansehen	Tab „Installed“	claude plugin details <name>

In einer Sitzung installiert /plugin install nicht sofort. Der Befehl öffnet ein Detailfenster, damit Sie das Plugin zuerst prüfen und einen Scope (Geltungsbereich) wählen können. Der Terminalbefehl installiert sofort, und zwar im Scope Benutzer, sofern Sie nicht --scope angeben.

Der Scope entscheidet, wer das Plugin bekommt:

• Benutzer (user) schreibt in ~/.claude/settings.json und aktiviert das Plugin in jedem Projekt auf Ihrem Rechner.
• Projekt (project) schreibt in .claude/settings.json, eine Datei, die Sie committen, damit Ihre Mitwirkenden sie teilen.
• Lokal (local) schreibt in .claude/settings.local.json und gilt nur für Sie, in einem einzigen Repository.

Widersprechen sich die Scopes, hat Lokal Vorrang vor Projekt und Projekt Vorrang vor Benutzer. Einstellungen, die eine Organisation verwaltet, haben Vorrang vor allen dreien. Kein einzelner Befehl aktualisiert alle Plugins auf einmal, und /reload-plugins übernimmt Änderungen in eine laufende Sitzung. Für Anthropics offiziellen Marktplatz kommen Updates automatisch, bei Marktplätzen von Drittanbietern sind sie standardmäßig ausgeschaltet.

Die Plugin-Befehle im Praxistest

In einem Test von Tech AI Wire unter macOS 26.6.2 mit Claude Code 2.1.317 listete claude plugin --help 15 Unterbefehle auf, von configure bis validate. Drei Befehle zeigen, was ein Plugin tut, bevor es ein Projekt berührt:

claude plugin details cc-plugin-you-should-know@builtin
claude plugin validate ./hello-check
claude plugin validate ./broken-check

Der erste Befehl untersuchte „You should know“, den optionalen Nebenagenten, der mit Claude Code 2.1.287 kam. Er listete null Skills, Agenten, Hooks, MCP-Server und LSP-Server auf. Die prognostizierten Dauerkosten lauteten „~0 tok added to every session“ (etwa 0 Token zusätzlich in jeder Sitzung).

Der zweite Befehl prüfte ein minimales Test-Plugin: ein Manifest mit Name, Version und Beschreibung, dazu ein Skill. Das Plugin bestand die Prüfung mit einer Warnung, weil ein Autor fehlte. Außerdem nannte der Befehl zwei Probleme, die eine Einreichung in Anthropics Plugin-Verzeichnis verhindern würden: keine README.md mit mindestens 40 Wörtern und weder eine Datei LICENSE noch ein Feld license. Ein fehlendes Icon war nur eine Warnung. Das Icon muss ein quadratisches PNG oder JPEG sein, 512 bis 2.048 Pixel pro Seite groß und kleiner als 2 MB.

Der dritte Befehl nutzte dasselbe Plugin, aus dem das Feld name gelöscht war. Die Validierung schlug mit Exit-Code 1 fehl. Die Meldung lautete „name: Invalid input: expected string, received undefined“ (name: ungültige Eingabe, String erwartet, undefined erhalten). Die Prüfungen für das Verzeichnis ändern das Ergebnis nur, wenn Sie --profile directory hinzufügen. Das Tool weist außerdem darauf hin, dass das Verzeichnis „runs a safety scan and a policy review that this command does not“ (eine Sicherheitsprüfung und eine Richtlinienprüfung durchführt, die dieser Befehl nicht vornimmt).

Was sich wann geändert hat

Plugin-Funktionen sind seit September in einer stetigen Folge von Releases hinzugekommen. Die Daten geben an, wann die jeweilige Version bei npm erschien, der Paket-Registry für JavaScript:

Version	Veröffentlicht	Was sich für Plugins geändert hat
2.1.273	15. September 2026	Marktplätze, die auf claude.ai gehostet werden, lassen sich hinzufügen
2.1.275	17. September 2026	Marktplatz hinzufügen und installieren mit einem Befehl in der Sitzung
2.1.287	1. Oktober 2026	Claude Mods und der Nebenagent „You should know“
2.1.292	6. Oktober 2026	Dieselbe Installation in einem Schritt aus dem Terminal
2.1.302	16. Oktober 2026	Korrektur: Marktplätze wurden bei jeder Aktualisierung neu geklont
2.1.317	2. November 2026	Der Skill plugin-authoring bietet Hilfe beim Teilen eines funktionierenden Mods an

Auch Marktplätze sind ein Angriffsziel. Am 29. Oktober lagen manipulierte Builds einer Erweiterung für Claude Code im Marktplatz von Cursor rund 11 Stunden lang bereit und fügten einen SSH-Schlüssel hinzu. Das war eine Editor-Erweiterung, kein Plugin für Claude Code. Die Lehre über das Vertrauen in einen Katalog ist aber dieselbe.

Was das für Entwickler bedeutet

Behandeln Sie ein Plugin wie jeden anderen Code, den Sie herunterladen. Anthropics Seite zur Plugin-Sicherheit sagt, dass ein Plugin „beliebigen Code auf Ihrem Rechner mit Ihren Benutzerrechten ausführen kann“. Sie fügt hinzu, dass die Berechtigungsregeln und die Sandbox „die Tool-Aufrufe abdecken, die Claude macht, nicht den Code, den ein Plugin selbst ausführt“. Lesen Sie die Liste „Will install“ (wird installiert) im Detailbereich. Prüfen Sie dann hooks/hooks.json, .mcp.json und einen etwaigen Ordner bin/, bevor Sie installieren.

Prüfen Sie auch die Kosten. claude plugin details zeigt, wie viele Token ein Plugin jeder Sitzung hinzufügt. So fällt ein schweres Plugin leicht auf, bevor Sie es einschalten.

Für ein Team tragen Sie extraKnownMarketplaces und enabledPlugins in die .claude/settings.json des Repositorys ein und committen die Datei. Diese Einträge gelten nur in Ordnern, denen Claude Code vertraut. Teammitglieder führen den Installationsbefehl für Plugins aus externen Quellen trotzdem einmal aus.

Unternehmen können mit verwalteten Einstellungen weiter gehen. Eine Allowlist strictKnownMarketplaces begrenzt, welche Kataloge geladen werden. Eine leere Liste blockiert jede Quelle, auch die von Anthropic. Wer ein Plugin in den verwalteten enabledPlugins auf false setzt, blockiert es in jedem Scope.

Ein Firmenkatalog muss nicht auf GitHub liegen. Die Dokumentation von LiteLLM zeigt, wie das KI-Gateway von LiteLLM einen solchen Katalog bereitstellt. Dort wählen Admins die Plugins aus, und Entwickler fügen den Katalog mit einem einzigen Befehl claude plugin marketplace add hinzu. Dieselbe Seite warnt davor, den Zugangsschlüssel des Katalogs in die .claude/settings.json eines Projekts zu schreiben, weil diese Datei oft ins Repository committet wird.

Plugin-Autoren sollten vor dem Einreichen claude plugin validate --profile directory ausführen. Im Test von Tech AI Wire waren eine fehlende README und eine fehlende Lizenz die beiden Probleme, die das Verzeichnis zurückweist.