Plugins erstellen

Erstellen Sie benutzerdefinierte Plugins, um Claude Code mit Skills, Agents, Hooks und MCP-Servern zu erweitern.

Plugins ermöglichen es Ihnen, Claude Code mit benutzerdefinierten Funktionen zu erweitern, die projektübergreifend und teamübergreifend freigegeben werden können. Diese Anleitung behandelt die Erstellung eigener Plugins mit Skills, Agents, Hooks und MCP-Servern.

Möchten Sie vorhandene Plugins installieren? Siehe Plugins entdecken und installieren. Für vollständige technische Spezifikationen siehe Plugins-Referenz.

Wann Plugins vs. eigenständige Konfiguration verwenden

Claude Code unterstützt zwei Möglichkeiten, um benutzerdefinierte Skills, Agents und Hooks hinzuzufügen:

Verwenden Sie eigenständige Konfiguration, wenn:

• Sie Claude Code für ein einzelnes Projekt anpassen
• Die Konfiguration persönlich ist und nicht freigegeben werden muss
• Sie mit Skills oder Hooks experimentieren, bevor Sie diese verpacken
• Sie kurze Skill-Namen wie /hello oder /deploy möchten

Verwenden Sie Plugins, wenn:

• Sie Funktionen mit Ihrem Team oder der Community teilen möchten
• Sie die gleichen Skills/Agents über mehrere Projekte hinweg benötigen
• Sie Versionskontrolle und einfache Updates für Ihre Erweiterungen möchten
• Sie über einen Marketplace verteilen
• Sie mit Namespace-Skills wie /my-plugin:hello einverstanden sind (Namespacing verhindert Konflikte zwischen Plugins)

Schnellstart

Dieser Schnellstart führt Sie durch die Erstellung eines Plugins mit einem benutzerdefinierten Skill. Sie erstellen ein Manifest (die Konfigurationsdatei, die Ihr Plugin definiert), fügen einen Skill hinzu und testen ihn lokal mit dem Flag --plugin-dir.

Voraussetzungen

• Claude Code installiert und authentifiziert

Erstellen Sie Ihr erstes Plugin

mkdir my-first-plugin

mkdir my-first-plugin/.claude-plugin

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

mkdir -p my-first-plugin/skills/hello

---
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

claude --plugin-dir ./my-first-plugin

/my-first-plugin:hello

---
description: Greet the user with a personalized message
---

# Hello Skill

Greet the user named "$ARGUMENTS" warmly and ask how you can help them today. Make the greeting personal and encouraging.

/my-first-plugin:hello Alex

Sie haben erfolgreich ein Plugin mit diesen Schlüsselkomponenten erstellt und getestet:

• Plugin-Manifest (.claude-plugin/plugin.json): beschreibt die Metadaten Ihres Plugins
• Skills-Verzeichnis (skills/): enthält Ihre benutzerdefinierten Skills
• Skill-Argumente ($ARGUMENTS): erfasst Benutzereingaben für dynamisches Verhalten

Übersicht über die Plugin-Struktur

Sie haben ein Plugin mit einem Skill erstellt, aber Plugins können viel mehr enthalten: benutzerdefinierte Agents, Hooks, MCP-Server und LSP-Server.

Entwickeln Sie komplexere Plugins

Sobald Sie sich mit grundlegenden Plugins vertraut gemacht haben, können Sie anspruchsvollere Erweiterungen erstellen.

Fügen Sie Skills zu Ihrem Plugin hinzu

Plugins können Agent-Skills enthalten, um die Fähigkeiten von Claude zu erweitern. Skills werden vom Modell aufgerufen: Claude verwendet sie automatisch basierend auf dem Task-Kontext.

Fügen Sie ein Verzeichnis skills/ auf Ihrer Plugin-Root mit Skill-Ordnern hinzu, die SKILL.md-Dateien enthalten:

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

Jede SKILL.md enthält YAML-Frontmatter und Anweisungen. Fügen Sie eine description ein, damit Claude weiß, wann der Skill verwendet werden soll:

---
description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
---

When reviewing code, check for:
1. Code organization and structure
2. Error handling
3. Security concerns
4. Test coverage

Nach der Installation des Plugins führen Sie /reload-plugins aus, um die Skills zu laden. Für vollständige Anleitung zur Skill-Erstellung, einschließlich progressiver Offenlegung und Tool-Einschränkungen, siehe Agent-Skills.

Fügen Sie LSP-Server zu Ihrem Plugin hinzu

LSP-Plugins (Language Server Protocol) geben Claude Echtzeit-Code-Intelligenz. Wenn Sie eine Sprache unterstützen müssen, die kein offizielles LSP-Plugin hat, können Sie ein eigenes erstellen, indem Sie eine .lsp.json-Datei zu Ihrem Plugin hinzufügen:

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

Benutzer, die Ihr Plugin installieren, müssen die Language-Server-Binärdatei auf ihrem Computer installiert haben.

Für vollständige LSP-Konfigurationsoptionen siehe LSP-Server.

Fügen Sie Hintergrund-Monitore zu Ihrem Plugin hinzu

Hintergrund-Monitore ermöglichen es Ihrem Plugin, Protokolle, Dateien oder externen Status im Hintergrund zu überwachen und Claude zu benachrichtigen, wenn Ereignisse eintreffen. Claude Code startet jeden Monitor automatisch, wenn das Plugin aktiv ist, sodass Sie Claude nicht anweisen müssen, die Überwachung zu starten.

Fügen Sie eine Datei monitors/monitors.json auf der Plugin-Root mit einem Array von Monitor-Einträgen hinzu:

[
  {
    "name": "error-log",
    "command": "tail -F ./logs/error.log",
    "description": "Application error log"
  }
]

Jede stdout-Zeile aus command wird Claude während der Sitzung als Benachrichtigung zugestellt. Für das vollständige Schema, einschließlich des when-Triggers und der Variablenersetzung, siehe Monitore.

Versenden Sie Standard-Einstellungen mit Ihrem Plugin

Plugins können eine Datei settings.json auf der Plugin-Root enthalten, um Standard-Konfiguration anzuwenden, wenn das Plugin aktiviert ist. Derzeit werden nur die Schlüssel agent und subagentStatusLine unterstützt.

Das Setzen von agent aktiviert einen der benutzerdefinierten Agents des Plugins als Haupt-Thread und wendet seinen System-Prompt, Tool-Einschränkungen und Modell an. Dies ermöglicht es einem Plugin, das Standardverhalten von Claude Code zu ändern, wenn es aktiviert ist.

{
  "agent": "security-reviewer"
}

Dieses Beispiel aktiviert den Agent security-reviewer, der im Verzeichnis agents/ des Plugins definiert ist. Einstellungen aus settings.json haben Vorrang vor settings, die in plugin.json deklariert sind. Unbekannte Schlüssel werden stillschweigend ignoriert.

Organisieren Sie komplexe Plugins

Für Plugins mit vielen Komponenten organisieren Sie Ihre Verzeichnisstruktur nach Funktionalität. Für vollständige Verzeichnislayouts und Organisationsmuster siehe Plugin-Verzeichnisstruktur.

Testen Sie Ihre Plugins lokal

Verwenden Sie das Flag --plugin-dir, um Plugins während der Entwicklung zu testen. Dies lädt Ihr Plugin direkt, ohne dass eine Installation erforderlich ist.

claude --plugin-dir ./my-plugin

Wenn ein --plugin-dir-Plugin denselben Namen wie ein installiertes Marketplace-Plugin hat, hat die lokale Kopie in dieser Sitzung Vorrang. Dies ermöglicht es Ihnen, Änderungen an einem Plugin zu testen, das Sie bereits installiert haben, ohne es zuerst zu deinstallieren. Marketplace-Plugins, die durch verwaltete Einstellungen erzwungen aktiviert sind, sind die einzige Ausnahme und können nicht überschrieben werden.

Wenn Sie Änderungen an Ihrem Plugin vornehmen, führen Sie /reload-plugins aus, um die Updates zu übernehmen, ohne neu zu starten. Dies lädt Plugins, Skills, Agents, Hooks, Plugin-MCP-Server und Plugin-LSP-Server neu. Testen Sie Ihre Plugin-Komponenten:

• Versuchen Sie Ihre Skills mit /plugin-name:skill-name
• Überprüfen Sie, dass Agents in /agents angezeigt werden
• Überprüfen Sie, dass Hooks wie erwartet funktionieren

Um ein Plugin zu testen, das bereits als .zip-Archiv verpackt und unter einer URL gehostet wird, z. B. ein CI-Build-Artefakt, verwenden Sie stattdessen --plugin-url. Claude Code ruft das Archiv beim Start ab und lädt es nur für diese Sitzung. Wenn das Abrufen fehlschlägt oder das Archiv ungültig ist, meldet Claude Code einen Plugin-Ladefehler und startet ohne es. Die gleichen Vertrauensüberlegungen gelten wie für jede andere Plugin-Quelle: Verweisen Sie dieses Flag nur auf Archive, die Sie kontrollieren oder denen Sie vertrauen.

Um mehrere Plugins zu laden, wiederholen Sie das Flag für jede URL:

claude --plugin-url https://example.com/my-plugin.zip --plugin-url https://example.com/other.zip

Oder übergeben Sie durch Leerzeichen getrennte URLs als ein Argument in Anführungszeichen:

claude --plugin-url "https://example.com/my-plugin.zip https://example.com/other.zip"

Debuggen Sie Plugin-Probleme

Wenn Ihr Plugin nicht wie erwartet funktioniert:

1. Überprüfen Sie die Struktur: Stellen Sie sicher, dass Ihre Verzeichnisse auf der Plugin-Root sind, nicht in .claude-plugin/
2. Testen Sie Komponenten einzeln: Überprüfen Sie jeden Skill, Agent und Hook separat
3. Verwenden Sie Validierungs- und Debugging-Tools: Siehe Debugging- und Entwicklungstools für CLI-Befehle und Troubleshooting-Techniken

Teilen Sie Ihre Plugins

Wenn Ihr Plugin bereit zum Teilen ist:

1. Fügen Sie Dokumentation hinzu: Fügen Sie eine README.md mit Installations- und Verwendungsanweisungen ein
2. Wählen Sie eine Versionierungsstrategie: Entscheiden Sie, ob Sie eine explizite version setzen oder sich auf den Git-Commit-SHA verlassen. Siehe Versionsverwaltung
3. Erstellen oder verwenden Sie einen Marketplace: Verteilen Sie über Plugin-Marketplaces zur Installation
4. Testen Sie mit anderen: Lassen Sie Teamkollegen das Plugin vor einer breiteren Verteilung testen

Sobald Ihr Plugin in einem Marketplace ist, können andere es mit den Anweisungen in Plugins entdecken und installieren installieren. Um ein Plugin intern für Ihr Team zu halten, hosten Sie den Marketplace in einem privaten Repository.

Reichen Sie Ihr Plugin beim offiziellen Marketplace ein

Um ein Plugin beim offiziellen Anthropic-Marketplace einzureichen, verwenden Sie eines der In-App-Einreichungsformulare:

• Claude.ai: claude.ai/settings/plugins/submit
• Console: platform.claude.com/plugins/submit

Sobald Ihr Plugin aufgelistet ist, können Sie Ihre eigene CLI haben, die Claude Code-Benutzer auffordert, es zu installieren. Siehe Empfehlen Sie Ihr Plugin von Ihrer CLI.

Konvertieren Sie vorhandene Konfigurationen in Plugins

Wenn Sie bereits Skills oder Hooks in Ihrem Verzeichnis .claude/ haben, können Sie diese in ein Plugin konvertieren, um die Freigabe und Verteilung zu vereinfachen.

Migrationschritte

mkdir -p my-plugin/.claude-plugin

{
"name": "my-plugin",
"description": "Migrated from standalone configuration",
"version": "1.0.0"
}

# Copy commands
cp -r .claude/commands my-plugin/

# Copy agents (if any)
cp -r .claude/agents my-plugin/

# Copy skills (if any)
cp -r .claude/skills my-plugin/

mkdir my-plugin/hooks

{
"hooks": {
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]
}
]
}
}

claude --plugin-dir ./my-plugin

Was sich bei der Migration ändert

Nächste Schritte

Jetzt, da Sie das Plugin-System von Claude Code verstehen, finden Sie hier vorgeschlagene Pfade für verschiedene Ziele:

Für Plugin-Benutzer

• Plugins entdecken und installieren: Durchsuchen Sie Marketplaces und installieren Sie Plugins
• Konfigurieren Sie Team-Marketplaces: Richten Sie Repository-Level-Plugins für Ihr Team ein

Für Plugin-Entwickler

• Erstellen und verteilen Sie einen Marketplace: Verpacken und teilen Sie Ihre Plugins
• Plugins-Referenz: Vollständige technische Spezifikationen
• Tauchen Sie tiefer in spezifische Plugin-Komponenten ein:
  • Skills: Details zur Skill-Entwicklung
  • Subagents: Agent-Konfiguration und Fähigkeiten
  • Hooks: Event-Handling und Automatisierung
  • MCP: Integration externer Tools