Plugins-Referenz - Claude Code Docs

Für praktische Tutorials und praktische Verwendung siehe Plugins. Für Plugin-Verwaltung über Teams und Communities hinweg siehe Plugin-Marktplätze.

Diese Referenz bietet vollständige technische Spezifikationen für das Claude Code Plugin-System, einschließlich Komponentenschemas, CLI-Befehle und Entwicklungstools.

Plugin-Komponentenreferenz

Dieser Abschnitt dokumentiert die fünf Arten von Komponenten, die Plugins bereitstellen können.

Befehle

Plugins fügen benutzerdefinierte Schrägstrich-Befehle hinzu, die sich nahtlos in das Befehlssystem von Claude Code integrieren. Speicherort: commands/-Verzeichnis im Plugin-Root Dateiformat: Markdown-Dateien mit Frontmatter Vollständige Details zur Plugin-Befehlsstruktur, Aufrufsmustern und Funktionen finden Sie unter Plugin-Befehle.

Agenten

Plugins können spezialisierte Subagenten für spezifische Aufgaben bereitstellen, die Claude automatisch aufrufen kann, wenn dies angemessen ist. Speicherort: agents/-Verzeichnis im Plugin-Root Dateiformat: Markdown-Dateien, die Agent-Fähigkeiten beschreiben Agent-Struktur:

---
description: Wofür sich dieser Agent spezialisiert
capabilities: ["task1", "task2", "task3"]
---

# Agent Name

Detaillierte Beschreibung der Rolle, Expertise und des Zeitpunkts, wann Claude ihn aufrufen sollte.

## Fähigkeiten
- Spezifische Aufgabe, bei der der Agent hervorragend ist
- Eine weitere spezialisierte Fähigkeit
- Wann dieser Agent im Vergleich zu anderen verwendet werden sollte

## Kontext und Beispiele
Geben Sie Beispiele an, wann dieser Agent verwendet werden sollte und welche Art von Problemen er löst.

Integrationspunkte:

Agenten erscheinen in der /agents-Schnittstelle
Claude kann Agenten automatisch basierend auf dem Aufgabenkontext aufrufen
Agenten können von Benutzern manuell aufgerufen werden
Plugin-Agenten funktionieren neben integrierten Claude-Agenten

Fähigkeiten

Plugins können Agent-Fähigkeiten bereitstellen, die Claudes Fähigkeiten erweitern. Fähigkeiten werden vom Modell aufgerufen – Claude entscheidet autonom, wann sie basierend auf dem Aufgabenkontext verwendet werden sollen. Speicherort: skills/-Verzeichnis im Plugin-Root Dateiformat: Verzeichnisse mit SKILL.md-Dateien mit Frontmatter Fähigkeitsstruktur:

skills/
├── pdf-processor/
│   ├── SKILL.md
│   ├── reference.md (optional)
│   └── scripts/ (optional)
└── code-reviewer/
    └── SKILL.md

Integrationverhalten:

Plugin-Fähigkeiten werden automatisch erkannt, wenn das Plugin installiert wird
Claude ruft Fähigkeiten autonom basierend auf dem übereinstimmenden Aufgabenkontext auf
Fähigkeiten können unterstützende Dateien neben SKILL.md enthalten

Für das SKILL.md-Format und vollständige Anleitung zur Fähigkeitserstellung siehe:

Hooks

Plugins können Event-Handler bereitstellen, die automatisch auf Claude Code-Events reagieren. Speicherort: hooks/hooks.json im Plugin-Root oder inline in plugin.json Format: JSON-Konfiguration mit Event-Matchern und Aktionen Hook-Konfiguration:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/format-code.sh"
          }
        ]
      }
    ]
  }
}

Verfügbare Events:

PreToolUse: Bevor Claude ein beliebiges Tool verwendet
PostToolUse: Nachdem Claude ein beliebiges Tool verwendet hat
UserPromptSubmit: Wenn der Benutzer einen Prompt einreicht
Notification: Wenn Claude Code Benachrichtigungen sendet
Stop: Wenn Claude versucht zu stoppen
SubagentStop: Wenn ein Subagent versucht zu stoppen
SessionStart: Am Anfang von Sitzungen
SessionEnd: Am Ende von Sitzungen
PreCompact: Bevor die Gesprächshistorie komprimiert wird

Hook-Typen:

command: Shell-Befehle oder Skripte ausführen
validation: Dateiinhalte oder Projektzustand validieren
notification: Warnungen oder Statusaktualisierungen senden

MCP-Server

Plugins können Model Context Protocol (MCP)-Server bündeln, um Claude Code mit externen Tools und Services zu verbinden. Speicherort: .mcp.json im Plugin-Root oder inline in plugin.json Format: Standard-MCP-Serverkonfiguration MCP-Serverkonfiguration:

{
  "mcpServers": {
    "plugin-database": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
      "env": {
        "DB_PATH": "${CLAUDE_PLUGIN_ROOT}/data"
      }
    },
    "plugin-api-client": {
      "command": "npx",
      "args": ["@company/mcp-server", "--plugin-mode"],
      "cwd": "${CLAUDE_PLUGIN_ROOT}"
    }
  }
}

Integrationverhalten:

Plugin-MCP-Server starten automatisch, wenn das Plugin aktiviert wird
Server erscheinen als Standard-MCP-Tools in Claudes Toolkit
Server-Fähigkeiten integrieren sich nahtlos mit Claudes vorhandenen Tools
Plugin-Server können unabhängig von Benutzer-MCP-Servern konfiguriert werden

Plugin-Manifest-Schema

Die plugin.json-Datei definiert die Metadaten und Konfiguration Ihres Plugins. Dieser Abschnitt dokumentiert alle unterstützten Felder und Optionen.

Vollständiges Schema

{
  "name": "plugin-name",
  "version": "1.2.0",
  "description": "Brief plugin description",
  "author": {
    "name": "Author Name",
    "email": "[email protected]",
    "url": "https://github.com/author"
  },
  "homepage": "https://docs.example.com/plugin",
  "repository": "https://github.com/author/plugin",
  "license": "MIT",
  "keywords": ["keyword1", "keyword2"],
  "commands": ["./custom/commands/special.md"],
  "agents": "./custom/agents/",
  "hooks": "./config/hooks.json",
  "mcpServers": "./mcp-config.json"
}

Erforderliche Felder

Feld	Typ	Beschreibung	Beispiel
`name`	string	Eindeutige Kennung (kebab-case, keine Leerzeichen)	`"deployment-tools"`

Metadaten-Felder

Feld	Typ	Beschreibung	Beispiel
`version`	string	Semantische Versionierung	`"2.1.0"`
`description`	string	Kurze Erklärung des Plugin-Zwecks	`"Deployment automation tools"`
`author`	object	Autoreninformationen	`{"name": "Dev Team", "email": "[email protected]"}`
`homepage`	string	Dokumentations-URL	`"https://docs.example.com"`
`repository`	string	Quellcode-URL	`"https://github.com/user/plugin"`
`license`	string	Lizenzkennung	`"MIT"`, `"Apache-2.0"`
`keywords`	array	Erkennungs-Tags	`["deployment", "ci-cd"]`

Komponentenpfad-Felder

Feld	Typ	Beschreibung	Beispiel
`commands`	string\|array	Zusätzliche Befehlsdateien/Verzeichnisse	`"./custom/cmd.md"` oder `["./cmd1.md"]`
`agents`	string\|array	Zusätzliche Agent-Dateien	`"./custom/agents/"`
`hooks`	string\|object	Hook-Konfigurationspfad oder Inline-Konfiguration	`"./hooks.json"`
`mcpServers`	string\|object	MCP-Konfigurationspfad oder Inline-Konfiguration	`"./mcp.json"`

Pfadverhaltenregeln

Wichtig: Benutzerdefinierte Pfade ergänzen Standardverzeichnisse – sie ersetzen sie nicht.

Wenn commands/ vorhanden ist, wird es zusätzlich zu benutzerdefinierten Befehlspfaden geladen
Alle Pfade müssen relativ zum Plugin-Root sein und mit ./ beginnen
Befehle aus benutzerdefinierten Pfaden verwenden die gleichen Benennungs- und Namespace-Regeln
Mehrere Pfade können als Arrays für Flexibilität angegeben werden

Pfadbeispiele:

{
  "commands": [
    "./specialized/deploy.md",
    "./utilities/batch-process.md"
  ],
  "agents": [
    "./custom-agents/reviewer.md",
    "./custom-agents/tester.md"
  ]
}

Umgebungsvariablen

${CLAUDE_PLUGIN_ROOT}: Enthält den absoluten Pfad zu Ihrem Plugin-Verzeichnis. Verwenden Sie dies in Hooks, MCP-Servern und Skripten, um korrekte Pfade unabhängig vom Installationsort sicherzustellen.

{
  "hooks": {
    "PostToolUse": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/process.sh"
          }
        ]
      }
    ]
  }
}

Plugin-Verzeichnisstruktur

Standard-Plugin-Layout

Ein vollständiges Plugin folgt dieser Struktur:

enterprise-plugin/
├── .claude-plugin/           # Metadaten-Verzeichnis
│   └── plugin.json          # Erforderlich: Plugin-Manifest
├── commands/                 # Standard-Befehlsort
│   ├── status.md
│   └──  logs.md
├── agents/                   # Standard-Agent-Ort
│   ├── security-reviewer.md
│   ├── performance-tester.md
│   └── compliance-checker.md
├── skills/                   # Agent-Fähigkeiten
│   ├── code-reviewer/
│   │   └── SKILL.md
│   └── pdf-processor/
│       ├── SKILL.md
│       └── scripts/
├── hooks/                    # Hook-Konfigurationen
│   ├── hooks.json           # Haupthook-Konfiguration
│   └── security-hooks.json  # Zusätzliche Hooks
├── .mcp.json                # MCP-Server-Definitionen
├── scripts/                 # Hook- und Utility-Skripte
│   ├── security-scan.sh
│   ├── format-code.py
│   └── deploy.js
├── LICENSE                  # Lizenzdatei
└── CHANGELOG.md             # Versionshistorie

Das .claude-plugin/-Verzeichnis enthält die plugin.json-Datei. Alle anderen Verzeichnisse (commands/, agents/, skills/, hooks/) müssen sich im Plugin-Root befinden, nicht innerhalb von .claude-plugin/.

Dateistandorte-Referenz

Komponente	Standard-Speicherort	Zweck
Manifest	`.claude-plugin/plugin.json`	Erforderliche Metadaten-Datei
Befehle	`commands/`	Markdown-Dateien für Schrägstrich-Befehle
Agenten	`agents/`	Markdown-Dateien für Subagenten
Fähigkeiten	`skills/`	Agent-Fähigkeiten mit SKILL.md-Dateien
Hooks	`hooks/hooks.json`	Hook-Konfiguration
MCP-Server	`.mcp.json`	MCP-Server-Definitionen

Debugging- und Entwicklungstools

Debugging-Befehle

Verwenden Sie claude --debug, um Plugin-Ladungsdetails anzuzeigen:

claude --debug

Dies zeigt:

Welche Plugins geladen werden
Alle Fehler in Plugin-Manifesten
Befehls-, Agent- und Hook-Registrierung
MCP-Server-Initialisierung

Häufige Probleme

Problem	Ursache	Lösung
Plugin wird nicht geladen	Ungültige `plugin.json`	JSON-Syntax validieren
Befehle werden nicht angezeigt	Falsche Verzeichnisstruktur	Stellen Sie sicher, dass `commands/` im Root ist, nicht in `.claude-plugin/`
Hooks werden nicht ausgelöst	Skript nicht ausführbar	Führen Sie `chmod +x script.sh` aus
MCP-Server schlägt fehl	Fehlende `${CLAUDE_PLUGIN_ROOT}`	Verwenden Sie Variable für alle Plugin-Pfade
Pfadfehler	Absolute Pfade verwendet	Alle Pfade müssen relativ sein und mit `./` beginnen

Verteilungs- und Versionierungsreferenz

Versionsverwaltung

Folgen Sie semantischer Versionierung für Plugin-Releases:

## Siehe auch

- [Plugins](/de/plugins) - Tutorials und praktische Verwendung
- [Plugin-Marktplätze](/de/plugin-marketplaces) - Erstellen und Verwalten von Marktplätzen
- [Schrägstrich-Befehle](/de/slash-commands) - Details zur Befehlsentwicklung
- [Subagenten](/de/sub-agents) - Agent-Konfiguration und Fähigkeiten
- [Agent-Fähigkeiten](/de/skills) - Erweitern Sie Claudes Fähigkeiten
- [Hooks](/de/hooks) - Event-Handling und Automatisierung
- [MCP](/de/mcp) - Integration externer Tools
- [Einstellungen](/de/settings) - Konfigurationsoptionen für Plugins

Referenz

​Plugin-Komponentenreferenz

​Befehle

​Agenten

​Fähigkeiten

​Hooks

​MCP-Server

​Plugin-Manifest-Schema

​Vollständiges Schema

​Erforderliche Felder

​Metadaten-Felder

​Komponentenpfad-Felder

​Pfadverhaltenregeln

​Umgebungsvariablen

​Plugin-Verzeichnisstruktur

​Standard-Plugin-Layout

​Dateistandorte-Referenz

​Debugging- und Entwicklungstools

​Debugging-Befehle

​Häufige Probleme

​Verteilungs- und Versionierungsreferenz

​Versionsverwaltung

Plugin-Komponentenreferenz

Befehle

Agenten

Fähigkeiten

Hooks

MCP-Server

Plugin-Manifest-Schema

Vollständiges Schema

Erforderliche Felder

Metadaten-Felder

Komponentenpfad-Felder

Pfadverhaltenregeln

Umgebungsvariablen

Plugin-Verzeichnisstruktur

Standard-Plugin-Layout

Dateistandorte-Referenz

Debugging- und Entwicklungstools

Debugging-Befehle

Häufige Probleme

Verteilungs- und Versionierungsreferenz

Versionsverwaltung