Wie man Claude-Code-Plugins erstellt: Eine Schritt-für-Schritt-Anleitung

Claude Code erledigt die meisten Entwicklungsaufgaben direkt, aber jedes Team hat seine eigenen Arbeitsabläufe, die die Standardeinstellungen nicht abdecken. Vielleicht brauchst du einen benutzerdefinierten Befehl, der Komponenten in der von deinem Unternehmen bevorzugten Struktur aufbaut, oder eine automatische Linting-Prüfung vor jedem Commit oder schnellen Zugriff auf die Dokumentation für ein Framework, das du ständig verwendest.

Mit den Claude Code-Plugins kannst du diese Funktionen selbst hinzufügen. Du kannst Plugins installieren, die von der Community erstellt wurden, oder deine eigenen Plugins erstellen.

Wenn du noch keine Erfahrung mit dem agentenbasierten Programmierwerkzeug von Anthropic hast, empfehle ich dir, mit dem  Leitfaden für Claude Code oder dem Kurs „Einführung in Claude-Modelle. Dieses Tutorial geht davon aus, dass du Claude Code installiert hast und es schon für einfache Aufgaben benutzt hast.

Am Ende wirst du wissen, wie man:

• Finde und installiere Plugins aus dem Verzeichnis von Anthropic und Community-Quellen.
• Verstehe die drei Arten von Komponenten, die Plugins haben können
• Such dir den richtigen Typ für verschiedene Anwendungsfälle aus.
• Erstell deine eigenen Plugins und teil sie mit anderen

Was sind Claude Code Plugins?

Ein Plugin ist ein Paket, das eine oder mehrere Claude Code-Erweiterungen zusammenfasst, damit man sie einfach teilen und installieren kann. Anstatt Konfigurationsdateien manuell zwischen Rechnern oder Teamkollegen zu kopieren, kannst du alles in ein Plugin packen und als eine Einheit verteilen.

Plugins können drei Arten von Komponenten haben:

• Fähigkeiten: Benutzerdefinierte Befehle, die du mit „ /skill-name “ aufrufst, oder kontextbezogene Eingabeaufforderungen, die Claude automatisch verwendet, wenn sie relevant sind.
• MCP-Server: Verbindungen zu externen Diensten und APIs, die Claude Zugriff auf Daten geben, die er sonst nicht hätte
• Haken: Shell-Skripte, die bei bestimmten Ereignissen automatisch laufen, z. B. bevor eine Datei bearbeitet wird oder nach einem Commit.

Ein Plugin kann nur eins davon haben oder mehrere kombinieren, die zusammenarbeiten. Ein „Deployment“-Plugin könnte eine „ /deploy “-Funktion für manuelle Bereitstellungen, einen MCP-Server, der den Status deiner Staging-Umgebung checkt, und einen Hook enthalten, der Tests durchführt, bevor ein Bereitstellungsbefehl ausgeführt wird.

Die Manifestdatei „ plugin.json “ sagt, was ein Plugin enthält. Es gibt an, welche Fähigkeiten, MCP-Server und Hooks installiert werden sollen, zusammen mit Metadaten wie dem Namen, der Version und dem Autor des Plugins. Wenn du ein Plugin installierst, liest Claude Code dieses Manifest und richtet jede Komponente am richtigen Ort ein.

Dank diesem Verpackungsformat musst du die interne Dateistruktur der Claude Code-Erweiterungen nicht verstehen. Du installierst das Plugin, und alles landet da, wo es hingehört.

Claude Code-Plugins finden und installieren

Die meisten Plugins sind an einem von zwei Orten zu finden. Das offizielle Verzeichnis von Anthropic unter plugins.claude.ai enthält Plugins, die von Anthropic entwickelt wurden, geprüfte Beiträge der Community und beliebte Erweiterungen von Drittanbietern. Jeder Eintrag zeigt, welche Teile das Plugin hat, ob es mit allem kompatibel ist und wie man es installiert.

Die zweite Quelle ist GitHub. Der awesome-claude-code Repository hat eine Liste, die nach Kategorien sortiert ist, und einzelne Entwickler veröffentlichen Plugins in ihren eigenen Repositorys.

Wenn du ein Plugin gefunden hast, das du haben willst, hängt der Befehl zum Installieren davon ab, wo es gespeichert ist:

# From the official directory
claude plugin add @anthropic/deploy-helper
 
# From a GitHub repository
claude plugin add github:username/repo-name
 
# From a local directory (useful during development)
claude plugin add ./my-plugin

Nachdem du ein paar Plugins installiert hast, solltest du den Überblick behalten. Der Befehl „ plugin “ kümmert sich um das Auflisten, Aktualisieren und Entfernen:

# List all installed plugins
claude plugin list
 
# Update a specific plugin to the latest version
claude plugin update @anthropic/deploy-helper
 
# Update all plugins
claude plugin update --all
 
# Remove a plugin
claude plugin remove @anthropic/deploy-helper

Eine Entscheidung, die du während der Installation treffen musst, betrifft den Umfang. Plugins können an zwei Orten gespeichert werden: Plugins im Benutzerbereich werden unter „ ~/.claude/plugins/ “ installiert und funktionieren in allen deinen Projekten, während Plugins im Projektbereich unter „.claude/plugins/ “ innerhalb eines bestimmten Repositorys installiert werden .

Die Standardeinstellung ist der Benutzerbereich. Um ein Plugin nur für das aktuelle Projekt zu installieren, füge das Flag „ --project “ hinzu:

claude plugin add @anthropic/deploy-helper --project

Plugins auf Projektebene sind sinnvoll, wenn die Erweiterung an einen bestimmten Code gebunden ist. 

Ein Plugin, das den Bereitstellungsprozess deines Unternehmens kennt, gehört in dieses Projekt. Ein Plugin, das Code nach deinen persönlichen Vorlieben formatiert, gehört auf die Benutzerebene. Wenn ein Plugin in beiden Bereichen vorhanden ist, hat die Projektversion Vorrang. So können Teams projektspezifische Konfigurationen durchsetzen, während Entwickler ihre persönlichen Plugins an anderer Stelle aktiv lassen können.

Den richtigen Claude Code Plugin-Typ auswählen

Die drei Komponententypen haben unterschiedliche Aufgaben und verbrauchen Ressourcen unterschiedlich. Wenn du diese Vor- und Nachteile verstehst, bleibt dein Kontextfenster übersichtlich und du kannst für jede Aufgabe das richtige Tool auswählen.

Fähigkeiten vs. MCP-Server: Der Token-Kompromiss

MCP-Server laden alle Werkzeugdefinitionen beim Start der Sitzung in dein Kontextfenster. Jedes Tool braucht einen Namen, eine Beschreibung und ein komplettes Parameterschema, was normalerweise 100 bis 300 Token pro Tool bedeutet. Eine Konfiguration mit fünf Servern verbraucht ungefähr 55.000 Token, bevor du auch nur ein einziges Zeichen eingeben kannst:

• GitHub: 35 Werkzeuge
•  Slack: 11 Werkzeuge
• Wächter: 5 Werkzeuge
• Grafana: 5 Werkzeuge
• Splunk: 2 Werkzeuge

Eine Analyse hat gezeigt, dass Setups mit mehr als 7 Servern über 67.000 Token verbrauchen, was einem Drittel deines 200.000-Kontextfensters entspricht, das schon weg ist, bevor das Gespräch überhaupt losgeht.

Fähigkeiten werden durch schrittweise Offenlegung anders angegangen. Zu Beginn der Sitzung sieht Claude nur den Namen jeder Fähigkeit und eine einzeilige Beschreibung aus dem YAML-Frontmatter, etwa 100 Token pro Fähigkeit. 

Die ganzen Anweisungen werden nur geladen, wenn Claude denkt, dass die Fertigkeit für die aktuelle Aufgabe wichtig ist. Referenzdateien werden nur geladen, wenn sie wirklich gebraucht werden. Und Skripte kommen überhaupt nicht ins Kontextfenster; Claude führt sie extern aus, und nur die Ausgabe kommt zurück.

Anthropic hat dieses Problem Ende 2025 mit Tool Search angegangen, einer Funktion, die Lazy Loading auf MCP-Server bringt. 

Statt jede Werkzeugdefinition vorab zu laden, merkt Claude Code jetzt, wenn Werkzeugbeschreibungen mehr als 10 % des verfügbaren Kontexts verbrauchen würden, und wechselt zum Laden nach Bedarf. 

Interne Tests haben gezeigt, dass die Kontextnutzung bei großen Tool-Bibliotheken von etwa 134.000 Tokens auf etwa 5.000 Tokens gesunken ist. Auch die Genauigkeit bei der Werkzeugauswahl wurde besser: Bei den MCP-Bewertungen stieg Opus 4 von 49 % auf 74 % und Opus 4.5 von 79,5 % auf 88,1 %.

Wann solltest du also zu welchem greifen?

Fähigkeiten passen am besten, wenn du willst, dass Claude Zugang zu Wissen oder Arbeitsabläufen hat, die er mit Urteilsvermögen anwenden kann. Eine Funktion, die die Checkliste für die Codeüberprüfung deines Teams beschreibt, wird geladen, wenn Claude den Code überprüft, aber Claude entscheidet trotzdem je nach Situation, wie die einzelnen Punkte angewendet werden. 

Fähigkeiten sind auch für Vorgänge sinnvoll, die Skripte für rechenintensive Aufgaben brauchen, weil der Skriptcode außerhalb des Kontextfensters bleibt.

MCP-Server sind ideal, wenn Claude Echtzeitdaten von externen Diensten wie Slack-Nachrichten, GitHub-PRs oder Datenbankabfragen braucht. Sie sind auch die richtige Wahl, wenn mehrere KI-Agenten die gleichen Tools brauchen oder wenn du Unternehmensfunktionen wie Audit-Protokolle und explizite Berechtigungen brauchst.

Viele Setups machen beides: Skills zeigen mit natürlichen Sprachbefehlen, wie und wann was gemacht werden soll, während MCP-Server die eigentlichen API-Aufrufe erledigen.

Beliebte Claude Code-Fähigkeiten, die du installieren solltest

• Superkräfte: Über 20 in der Praxis getestete Workflows für TDD, Debugging und strukturierte Planung
• frontend-design: Sagt Claude, er soll keine gewöhnliche Ästhetik machen und mutige Designentscheidungen treffen.
• mcp-builder: Anleitung zum Erstellen von MCP-Servern für die Integration externer APIs
•  Webapp-Tests: Lokale Web-Apps mit Playwright testen, um die Benutzeroberfläche zu überprüfen
•  Fähigkeiten-Entwickler: Ein interaktives Tool, das dir hilft, neue Fähigkeiten zu entwickeln

Beliebte MCP-Server, die einen Besuch wert sind

• Context7: Echtzeit-Suche nach versionsspezifischer Dokumentation
• GitHub: Repository-Suche, PR-Management, Problemverfolgung
• Playwright: Browser-Automatisierung mit Hilfe von Barrierefreiheitsbäumen anstelle von Screenshots
• Supabase: Datenbankabfragen mit Row Level Security
• Wächter: Fehlerverfolgung und Leistungsüberwachung direkt in deinem Editor

Du kannst auch unseren Leitfaden zu den besten Remote-MCP-Servern lesen.

Haken: Die deterministische Ebene

Hooks haben mit der ganzen Diskussion um Fähigkeiten versus MCP überhaupt nichts zu tun. Während sowohl Fähigkeiten als auch MCP-Server Claude-orientiert sind (Claude entscheidet, wann sie eingesetzt werden), sind Hooks systemorientiert. Sie lösen bei Ereignissen wie „ PreToolUse ” oder „ PostToolUse ” aus und führen Shell-Skripte aus, bevor oder nachdem Claude bestimmte Aktionen macht. Claude hat keinen Einfluss darauf, ob ein Hook läuft.

Das macht Hooks zur perfekten Wahl, wenn etwas unbedingt passieren muss: Linting vor jedem Commit, das Blockieren von Schreibvorgängen in geschützten Verzeichnissen, das Protokollieren jedes Bash-Befehls oder das Ausführen von Tests vor jeder Bereitstellung.

Dieser Entwickler empfiehlt „block-at-submit”-Hooks anstelle von „block-at-write”-Hooks. Wenn man Claude mitten in der Aufgabe unterbricht, verwirrt das den Agenten und führt zu schlechteren Ergebnissen. Ihr Team nutzt einen „ PreToolUse “-Hook, der „ Bash(git commit) “ einbindet und nach einer temporären Datei sucht, die nur da ist, wenn die Tests erfolgreich waren. Keine Datei, kein Commit. Der Agent macht seine Arbeit fertig, dann kommt die Validierung am Ende.

Hooks verursachen keinen zusätzlichen Aufwand, weil sie als Shell-Skripte außerhalb des Kontextfensters laufen.

Nützliche Claude-Hooks zum Einrichten

• ESLint/Prettier beim Bearbeiten von: Dateien automatisch formatieren, nachdem Claude sie geschrieben hat
• Testgate bei Commit: Verhindere Commits, bis die Tests bestanden sind.
• Geschützte Pfade: Verhindere das Schreiben in Migrations-, Konfigurations- oder Vendor-Verzeichnisse.
• Benachrichtigung nach Fertigstellung: Schick Slack- oder Desktop-Benachrichtigungen, wenn lange Aufgaben fertig sind.
• Transkript-Backup-: Speichere den Gesprächsverlauf, bevor die Komprimierung losgeht.

Wie du deine eigenen Claude Code-Plugins machst

Wenn eine Fertigkeit in deinem persönlichen Verzeichnis „ .claude/ “ gespeichert ist , kannst nur du sie benutzen. Wenn du es als Plugin verpackst, kannst du es mit deinen Teamkollegen teilen oder in verschiedenen Projekten wiederverwenden.

Wir machen ein Plugin namens „ session-logger ”, das den Befehl „ /session-logger:summarize ” hinzufügt . Wenn das aufgerufen wird, schaut sich Claude die Unterhaltung an und fügt eine strukturierte Zusammenfassung zu SESSION_LOG.md hinzu.

Mach die Plugin-Struktur

Plugins können überall auf deinem Dateisystem gespeichert werden. Für dieses Tutorial erstellen wir eine Datei in deinem Home-Verzeichnis:

cd ~
mkdir -p session-logger/.claude-plugin
mkdir -p session-logger/skills/summarize

Das führt zu:

~/session-logger/
├── .claude-plugin/
│   └── plugin.json  	# manifest goes here, nowhere else
└── skills/
	└── summarize/   	# folder name becomes the command name
    	└── SKILL.md 	# must be named exactly this

Schreib das Manifest

Erstell die Datei „ ~/session-logger/.claude-plugin/plugin.json “:

{
  "name": "session-logger",
  "description": "Log session summaries to a markdown file",
  "version": "1.0.0"
}

Das Feld „ name “ wird zum Namespace-Präfix. Alle Befehle in diesem Plugin fangen mit „ /session-logger: “ an.

Schreib die Fähigkeit auf

Erstellen ~/session-logger/skills/summarize/SKILL.md:

---
description: Log a summary of the current session to SESSION_LOG.md
disable-model-invocation: true
---
 
When invoked, review the conversation and create a summary with these sections:
 
- **Date/time**: Current timestamp
- **Tasks completed**: What was accomplished
- **Files modified**: List of files created or changed
- **Decisions made**: Architectural or implementation choices
- **Open questions**: Unresolved items for future sessions
 
Append the summary to SESSION_LOG.md in the project root. Create the file if it doesn't exist.

Die Zeile „ disable-model-invocation: true “ sagt Claude, dass nur du „ “ diese Fähigkeit auslösen kannst. Ohne dieses Flag könnte Claude beschließen, den Befehl selbstständig auszuführen, wenn er denkt, dass es der Unterhaltung hilft. Bei einem Logger oder Deployment-Tool willst du normalerweise manuelle Kontrolle.

Lokal testen

Geh zu einem beliebigen Projekt, in dem du das Plugin verwenden möchtest, und starte dann Claude Code mit der --plugin-dir Flag, das auf dein Plugin zeigt:

cd ~/your-project
claude --plugin-dir ~/session-logger

Gib „ /session-logger:summarize “ ein, um den Befehl zu starten. Beachte, dass Plugin-Befehle erst dann in den Autovervollständigungsvorschlägen erscheinen, wenn du den vollständigen Namen eingegeben hast. Der Text wird blau, sobald Claude Code ihn als gültigen Befehl erkennt.

Nachdem du ein paar Sachen in der Sitzung erledigt hast, mach den Befehl. Claude schaut sich die Unterhaltung an und fügt einen Eintrag zu „ SESSION_LOG.md “ in deinem aktuellen Projektverzeichnis hinzu.

Mit anderen teilen

Schick dein Plugin zu GitHub. Um es über das manuelle Klonen hinaus zu verbreiten, füge es einem Plugin-Marktplatz hinzu. Der Marktplatz-Leitfaden klärt, wie du deinen eigenen Marktplatz aufbaust oder dich bei bestehenden anmeldest.

Fazit

Plugins machen Claude Code von einem Allround-Assistenten zu einem Tool, das genau auf deinen Arbeitsablauf zugeschnitten ist. Der Session-Logger, den wir gebaut haben, hat ungefähr fünf Minuten und drei Dateien gebraucht. Die meisten nützlichen Plugins sind nicht viel komplizierter als das.

Wenn du alles richtig gemacht hast, hast du jetzt ein funktionierendes Plugin auf deinem Rechner. Versuch mal, es anzupassen. Ändere das Format der Zusammenfassung, füge neue Abschnitte hinzu oder tausche sie gegen etwas aus, das dein Team wirklich braucht. Die Struktur bleibt gleich, egal ob du ein schnelles persönliches Tool baust oder was, das du an Hunderte von Entwicklern verteilst.

Schau dir die Community-Repositorys an, wenn du Zeit hast. Wenn du dir anschaust, wie andere ihre Plugins aufbauen, lernst du Muster kennen, die dir die Dokumentation nicht zeigen kann. Und wenn du was Nützliches machst, dann zeig's auch allen. Das Ökosystem wächst mit jedem gemeinsamen Plugin.