Du hast dir über Wochen ein richtig gutes Claude-Code-Setup gebaut: ein paar handgeschriebene Slash-Commands, einen Subagenten fürs Code-Review, ein, zwei Hooks und vielleicht einen MCP-Server. Alles liegt verstreut in deinem Projekt. Und dann kommt das nächste Projekt – und du fängst von vorne an zu kopieren. Genau hier kommen Claude Code Plugins ins Spiel: Sie bündeln dein komplettes Setup in ein installierbares Paket, das du in jedem Projekt mit einem einzigen Befehl wieder reinholst. In diesem Artikel zeige ich dir, was ein Plugin ist, wie du es über einen Marketplace installierst und wie du dein eigenes baust.
Was ist ein Plugin in Claude Code?
Ein Plugin ist ein Container. Es ist die offizielle Antwort auf die Frage „Wie teile ich meine Claude-Code-Konfiguration?“ Statt einzelner Dateien, die du manuell hin- und herschiebst, packst du alles in eine definierte Ordnerstruktur – und Claude Code lädt es als Einheit.
Konkret kann ein Plugin diese Bausteine bündeln:
- Slash-Commands – deine eigenen Befehle wie
/deployoder/review, die als Markdown-Dateien im Ordnercommands/liegen. - Subagenten – spezialisierte Agenten mit eigenem System-Prompt und eigenem Modell (z. B. ein Haiku-4.5-Agent fürs schnelle Formatieren, ein Opus-4.8-Agent fürs Architektur-Review). Liegen in
agents/. - Hooks – Skripte, die automatisch bei bestimmten Events laufen, etwa ein Linter nach jedem Edit oder eine Benachrichtigung, wenn Claude fertig ist.
- MCP-Server – Anbindungen an externe Tools und Datenquellen über das Model Context Protocol, sauber im Plugin mitgeliefert.
- Skills – Fähigkeitspakete mit Anleitungen und Ressourcen, die Claude bei passenden Aufgaben automatisch zieht.
Der große Vorteil: Ein Kollege oder ein Kunde installiert dein Plugin und hat sofort dasselbe Setup wie du – ohne lange README abzuarbeiten. Du versionierst es über Git, pushst ein Update, und alle ziehen nach. Das ist der Unterschied zwischen „ich hab da mal was gebastelt“ und einem teilbaren Produkt.
Plugins verwalten mit /plugin
Die zentrale Schaltstelle für alles ist der Slash-Command /plugin. Tippst du ihn ohne weitere Argumente in Claude Code ein, öffnet sich ein interaktives Menü: Du siehst installierte Plugins, kannst Marketplaces durchstöbern, einzelne Plugins aktivieren oder deaktivieren und Updates ziehen.
Für den schnellen Weg gibt es Unterbefehle, die du direkt absetzen kannst, ohne durchs Menü zu klicken. Die wichtigsten sind /plugin marketplace add zum Hinzufügen einer Quelle und /plugin install zum Installieren eines konkreten Plugins. Genau die schauen wir uns jetzt an.
Einen Marketplace hinzufügen und ein Plugin installieren
Plugins kommen aus einem Marketplace. Das klingt nach App Store, ist in der Praxis aber meistens einfach ein Git-Repository (ein Online-Speicherort für Code, etwa auf GitHub), in dem ein oder mehrere Plugins liegen plus eine Manifest-Datei, die sie auflistet. Das hat einen schönen Nebeneffekt: Jeder kann einen Marketplace betreiben – du, dein Team, die Open-Source-Community.
Bevor du ein Plugin installieren kannst, musst du Claude Code sagen, woher es kommt. Du fügst also zuerst den Marketplace hinzu. Das geht über eine GitHub-Kurzschreibweise (user/repo) oder eine volle Git-URL:
/plugin marketplace add dein-team/claude-pluginsAlternativ mit vollständiger URL:
/plugin marketplace add https://github.com/dein-team/claude-plugins.gitDanach kennt Claude Code die Quelle und du kannst sehen, welche Plugins darin angeboten werden. Installiert wird dann gezielt nach Name. Üblich ist die Schreibweise plugin-name@marketplace-name, damit eindeutig ist, aus welcher Quelle das Plugin stammt:
/plugin install code-review@dein-teamNach der Installation stehen die enthaltenen Commands, Subagenten und Hooks sofort bereit. Ein /plugin-Aufruf zeigt dir den Status, und über das Menü kannst du das Plugin jederzeit wieder deaktivieren oder per Update auf den neuesten Stand bringen. Wenn du mehrere Maschinen hast, fügst du den Marketplace einmal pro Umgebung hinzu – die Quelle ist ja nur ein Verweis aufs Repo.
Ein eigenes Claude Code Plugin bauen
Jetzt der spannende Teil: dein eigenes Plugin. Das ist weniger Magie, als du denkst. Im Kern brauchst du einen Ordner mit einem Manifest und darunter die Bausteine, die du teilen willst. Das Herzstück ist die Datei .claude-plugin/plugin.json – sie macht aus einem beliebigen Ordner ein erkennbares Plugin.
Eine typische Ordnerstruktur sieht so aus:
mein-plugin/
├── .claude-plugin/
│ └── plugin.json # Manifest – Pflicht
├── commands/
│ └── deploy.md # Slash-Command /deploy
├── agents/
│ └── reviewer.md # Subagent
├── hooks/
│ └── hooks.json # Hook-Definitionen
└── skills/
└── api-docs/
└── SKILL.md # ein SkillDas Manifest selbst ist schlank. Pflicht ist eigentlich nur der Name; alles andere ist Metadaten, die im Marketplace angezeigt werden:
{
"name": "mein-plugin",
"version": "1.0.0",
"description": "Mein persoenliches Setup: Deploy-Command, Review-Agent und Lint-Hook.",
"author": {
"name": "Rafael Luge"
}
}Die Bausteine darunter folgen den ganz normalen Konventionen von Claude Code: Ein Slash-Command ist eine Markdown-Datei in commands/, deren Dateiname zum Befehlsnamen wird. Ein Subagent ist eine Markdown-Datei in agents/ mit einem kurzen Info-Block oben (dem „Frontmatter“), in dem du Name, Beschreibung und optional das Modell festlegst – etwa Sonnet 4.6 für die meisten Aufgaben oder Haiku 4.5, wenn es nur um schnelles, günstiges Abarbeiten geht. Hooks definierst du in JSON, MCP-Server bindest du über die entsprechende Konfiguration ein.
Sobald der Ordner steht, legst du ihn in ein Git-Repo, ergänzt eine Marketplace-Manifest-Datei, die dein Plugin auflistet, und pushst das Ganze zu GitHub. Ab da kann es jeder über /plugin marketplace add einbinden. Mein Tipp: Fang klein an. Pack erst nur deinen wichtigsten Command rein, teste die Installation in einem zweiten Projekt, und wachse von dort.
Bevor du Plugins baust, bring dein Setup auf Linie. Hol dir mein kostenloses Freebie „5 CLAUDE.md-Templates“ – fertige Vorlagen, die Claude Code in deinen Projekten sofort produktiver machen. Und wenn du tiefer einsteigen willst: Im Claude-Code-Kurs auf kopfundstift.de baust du dir Schritt für Schritt ein Setup, das du am Ende als Plugin paketieren kannst.
Sicherheit: Was du vor der Installation wissen solltest
Ein Plugin ist mächtig – und genau deshalb ein potenzielles Einfallstor. Es kann Slash-Commands mitbringen, die Shell-Befehle ausführen, Hooks, die bei jedem Edit Code laufen lassen, und MCP-Server, die mit externen Systemen reden. Du installierst damit fremden Code, der in deiner Umgebung Aktionen auslöst.
Behandle Plugins deshalb wie jede andere Dependency:
- Quelle prüfen. Installiere bevorzugt aus Marketplaces, die du kennst oder deren Repo du einsehen kannst. Bei einem öffentlichen GitHub-Repo lohnt ein Blick in die Hooks und Commands, bevor du auf Install gehst.
- Hooks lesen. Hooks laufen automatisch, oft ohne Rückfrage. Schau dir an, welche Skripte da hinterlegt sind – das ist der sensibelste Teil.
- Version pinnen und Updates bewusst ziehen. Ein automatisches Update kann neuen Code reinbringen. Aktualisiere Plugins genauso überlegt, wie du Pakete updaten würdest.
- Im Team einen kuratierten Marketplace nutzen. So kontrolliert ihr zentral, was ins Setup darf, statt dass jeder wild Drittquellen einbindet.
Kurz: Vertrauen ist die Währung. Ein Plugin spart dir enorm viel Zeit, aber nur, wenn du weißt, was drinsteckt.
FAQ
Was ist der Unterschied zwischen einem Plugin und einem Marketplace?
Ein Plugin ist das eigentliche Paket mit deinen Commands, Subagenten, Hooks und MCP-Servern. Ein Marketplace ist der Ort, an dem ein oder mehrere Plugins liegen – meistens ein Git-Repo. Du fügst zuerst den Marketplace mit /plugin marketplace add hinzu und installierst dann das einzelne Plugin mit /plugin install.
Brauche ich für ein Plugin zwingend einen MCP-Server?
Nein. Ein Plugin kann beliebige der Bausteine enthalten – oder nur einen einzigen. Ein Plugin, das ausschließlich einen praktischen Slash-Command mitbringt, ist völlig legitim. MCP-Server, Hooks und Subagenten sind optional. Pflicht ist nur das Manifest .claude-plugin/plugin.json mit einem Namen.
Kann ich ein Plugin nur für mich lokal nutzen, ohne es zu veröffentlichen?
Ja. Du kannst einen Marketplace auch aus einem lokalen Git-Repo oder einem privaten GitHub-Repo einbinden. Dein Setup muss nicht öffentlich sein – du bekommst trotzdem den Vorteil, es in mehreren Projekten mit einem Befehl wieder reinzuholen.
Fazit
Claude Code Plugins lösen das nervigste Problem fortgeschrittener Nutzer: Setups, die in einem einzelnen Projekt gefangen sind. Sobald du Commands, Subagenten, Hooks und MCP-Server in ein Plugin packst, wird aus deiner Bastelei ein wiederverwendbares, teilbares Paket. Über /plugin verwaltest du alles, über einen Marketplace verteilst du es, und mit einem schlanken plugin.json baust du in wenigen Minuten dein erstes eigenes.
Mein Rat: Geh deine letzten Projekte durch, sammel die zwei, drei Dinge ein, die du immer wieder kopierst, und gieß sie in dein erstes Plugin. Du wirst dich beim nächsten Projektstart bei dir selbst bedanken.
