Plugins-Referenz

​

Plugin-Komponenten-Referenz

​

Skills

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

• Skills und Befehle werden automatisch erkannt, wenn das Plugin installiert wird
• Claude kann sie automatisch basierend auf dem Task-Kontext aufrufen
• Skills können unterstützende Dateien neben SKILL.md enthalten

​

Agents

---
name: agent-name
description: Worauf sich dieser Agent spezialisiert und wann Claude ihn aufrufen sollte
model: sonnet
effort: medium
maxTurns: 20
disallowedTools: Write, Edit
---

Detailliertes System-Prompt für den Agent, das seine Rolle, Expertise und sein Verhalten beschreibt.

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

​

Hooks

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

• command: Shell-Befehle oder Skripte ausführen
• http: Das Event JSON als POST-Anfrage an eine URL senden
• prompt: Ein Prompt mit einem LLM evaluieren (verwendet $ARGUMENTS Platzhalter für Kontext)
• agent: Einen agentic Verifier mit Tools für komplexe Verifikationsaufgaben ausführen

​

MCP-Server

{
  "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}"
    }
  }
}

• 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

​

LSP-Server

• Sofortige Diagnose: Claude sieht Fehler und Warnungen sofort nach jeder Bearbeitung
• Code-Navigation: Gehe zu Definition, finde Referenzen und Hover-Informationen
• Sprachbewusstsein: Typinformationen und Dokumentation für Code-Symbole

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

{
  "name": "my-plugin",
  "lspServers": {
    "go": {
      "command": "gopls",
      "args": ["serve"],
      "extensionToLanguage": {
        ".go": "go"
      }
    }
  }
}

​

Plugin-Installationsbereiche

​

Plugin-Manifest-Schema

​

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/",
  "skills": "./custom/skills/",
  "hooks": "./config/hooks.json",
  "mcpServers": "./mcp-config.json",
  "outputStyles": "./styles/",
  "lspServers": "./.lsp.json"
}

​

Erforderliche Felder

​

Metadaten-Felder

​

Komponentenpfad-Felder

​

Benutzerkonfiguration

{
  "userConfig": {
    "api_endpoint": {
      "description": "Your team's API endpoint",
      "sensitive": false
    },
    "api_token": {
      "description": "API authentication token",
      "sensitive": true
    }
  }
}

​

Kanäle

{
  "channels": [
    {
      "server": "telegram",
      "userConfig": {
        "bot_token": { "description": "Telegram bot token", "sensitive": true },
        "owner_id": { "description": "Your Telegram user ID", "sensitive": false }
      }
    }
  ]
}

​

Pfad-Verhaltensregeln

• Wenn commands/ existiert, 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 Namensgebungsregeln
• Mehrere Pfade können als Arrays für Flexibilität angegeben werden

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

​

Umgebungsvariablen

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

​

Persistentes Datenverzeichnis

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "diff -q \"${CLAUDE_PLUGIN_ROOT}/package.json\" \"${CLAUDE_PLUGIN_DATA}/package.json\" >/dev/null 2>&1 || (cd \"${CLAUDE_PLUGIN_DATA}\" && cp \"${CLAUDE_PLUGIN_ROOT}/package.json\" . && npm install) || rm -f \"${CLAUDE_PLUGIN_DATA}/package.json\""
          }
        ]
      }
    ]
  }
}

{
  "mcpServers": {
    "routines": {
      "command": "node",
      "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"],
      "env": {
        "NODE_PATH": "${CLAUDE_PLUGIN_DATA}/node_modules"
      }
    }
  }
}

​

Plugin-Caching und Dateiauflösung

• Durch claude --plugin-dir, für die Dauer einer Session.
• Durch einen Marktplatz, installiert für zukünftige Sessions.

​

Pfad-Traversal-Einschränkungen

​

Arbeiten mit externen Abhängigkeiten

# Innerhalb Ihres Plugin-Verzeichnisses
ln -s /path/to/shared-utils ./shared-utils

​

Plugin-Verzeichnisstruktur

​

Standard-Plugin-Layout

enterprise-plugin/
├── .claude-plugin/           # Metadaten-Verzeichnis (optional)
│   └── plugin.json             # Plugin-Manifest
├── commands/                 # Standard-Befehlsspeicherort
│   ├── status.md
│   └── logs.md
├── agents/                   # Standard-Agent-Speicherort
│   ├── security-reviewer.md
│   ├── performance-tester.md
│   └── compliance-checker.md
├── skills/                   # Agent Skills
│   ├── code-reviewer/
│   │   └── SKILL.md
│   └── pdf-processor/
│       ├── SKILL.md
│       └── scripts/
├── hooks/                    # Hook-Konfigurationen
│   ├── hooks.json           # Haupt-Hook-Konfiguration
│   └── security-hooks.json  # Zusätzliche Hooks
├── settings.json            # Standardeinstellungen für das Plugin
├── .mcp.json                # MCP-Server-Definitionen
├── .lsp.json                # LSP-Server-Konfigurationen
├── scripts/                 # Hook- und Utility-Skripte
│   ├── security-scan.sh
│   ├── format-code.py
│   └── deploy.js
├── LICENSE                  # Lizenzdatei
└── CHANGELOG.md             # Versionsverlauf

​

Datei-Speicherorte-Referenz

​

CLI-Befehle-Referenz

​

plugin install

claude plugin install <plugin> [options]

• <plugin>: Plugin-Name oder plugin-name@marketplace-name für einen bestimmten Marktplatz

# Installieren Sie im Benutzerbereich (Standard)
claude plugin install formatter@my-marketplace

# Installieren Sie im Projektbereich (geteilt mit Team)
claude plugin install formatter@my-marketplace --scope project

# Installieren Sie im lokalen Bereich (gitignoriert)
claude plugin install formatter@my-marketplace --scope local

​

plugin uninstall

claude plugin uninstall <plugin> [options]

• <plugin>: Plugin-Name oder plugin-name@marketplace-name

​

plugin enable

claude plugin enable <plugin> [options]

• <plugin>: Plugin-Name oder plugin-name@marketplace-name

​

plugin disable

claude plugin disable <plugin> [options]

• <plugin>: Plugin-Name oder plugin-name@marketplace-name

​

plugin update

claude plugin update <plugin> [options]

• <plugin>: Plugin-Name oder plugin-name@marketplace-name

​

Debugging- und Entwicklungstools

​

Debugging-Befehle

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

​

Häufige Probleme

​

Beispiel-Fehlermeldungen

• Invalid JSON syntax: Unexpected token } in JSON at position 142: Überprüfen Sie auf fehlende Kommas, zusätzliche Kommas oder nicht zitierte Strings
• Plugin has an invalid manifest file at .claude-plugin/plugin.json. Validation errors: name: Required: Ein erforderliches Feld fehlt
• Plugin has a corrupt manifest file at .claude-plugin/plugin.json. JSON parse error: ...: JSON-Syntaxfehler

• Warning: No commands found in plugin my-plugin custom directory: ./cmds. Expected .md files or SKILL.md in subdirectories.: Befehlspfad existiert, enthält aber keine gültigen Befehlsdateien
• Plugin directory not found at path: ./plugins/my-plugin. Check that the marketplace entry has the correct path.: Der source Pfad in marketplace.json verweist auf ein nicht existierendes Verzeichnis
• Plugin my-plugin has conflicting manifests: both plugin.json and marketplace entry specify components.: Entfernen Sie doppelte Komponentendefinitionen oder entfernen Sie strict: false im Marktplatz-Eintrag

​

Hook-Fehlerbehebung

1. Überprüfen Sie, dass das Skript ausführbar ist: chmod +x ./scripts/your-script.sh
2. Überprüfen Sie die Shebang-Zeile: Erste Zeile sollte #!/bin/bash oder #!/usr/bin/env bash sein
3. Überprüfen Sie, dass der Pfad ${CLAUDE_PLUGIN_ROOT} verwendet: "command": "${CLAUDE_PLUGIN_ROOT}/scripts/your-script.sh"
4. Testen Sie das Skript manuell: ./scripts/your-script.sh

1. Überprüfen Sie, dass der Event-Name korrekt ist (Groß-/Kleinschreibung beachten): PostToolUse, nicht postToolUse
2. Überprüfen Sie, dass das Matcher-Muster Ihre Tools passt: "matcher": "Write|Edit" für Dateivorgänge
3. Bestätigen Sie, dass der Hook-Typ gültig ist: command, http, prompt oder agent

​

MCP-Server-Fehlerbehebung

1. Überprüfen Sie, dass der Befehl existiert und ausführbar ist
2. Überprüfen Sie, dass alle Pfade die ${CLAUDE_PLUGIN_ROOT} Variable verwenden
3. Überprüfen Sie die MCP-Server-Logs: claude --debug zeigt Initialisierungsfehler
4. Testen Sie den Server manuell außerhalb von Claude Code

1. Stellen Sie sicher, dass der Server ordnungsgemäß in .mcp.json oder plugin.json konfiguriert ist
2. Überprüfen Sie, dass der Server das MCP-Protokoll ordnungsgemäß implementiert
3. Überprüfen Sie auf Verbindungs-Timeouts in der Debug-Ausgabe

​

Verzeichnisstruktur-Fehler

my-plugin/
├── .claude-plugin/
│   └── plugin.json      ← Nur Manifest hier
├── commands/            ← Auf Root-Ebene
├── agents/              ← Auf Root-Ebene
└── hooks/               ← Auf Root-Ebene

1. Führen Sie claude --debug aus und suchen Sie nach „loading plugin” Meldungen
2. Überprüfen Sie, dass jedes Komponentenverzeichnis in der Debug-Ausgabe aufgelistet ist
3. Überprüfen Sie Dateiberechtigungen, die das Lesen der Plugin-Dateien ermöglichen

​

Verteilungs- und Versionierungs-Referenz

​

Versionsverwaltung

{
  "name": "my-plugin",
  "version": "2.1.0"
}

• MAJOR: Breaking Changes (inkompatible API-Änderungen)
• MINOR: Neue Features (abwärtskompatible Ergänzungen)
• PATCH: Bugfixes (abwärtskompatible Fixes)

• Beginnen Sie mit 1.0.0 für Ihr erstes stabiles Release
• Aktualisieren Sie die Version in plugin.json, bevor Sie Änderungen verteilen
• Dokumentieren Sie Änderungen in einer CHANGELOG.md Datei
• Verwenden Sie Pre-Release-Versionen wie 2.0.0-beta.1 zum Testen

​

Siehe auch

• Plugins - Tutorials und praktische Verwendung
• Plugin-Marktplätze - Erstellen und Verwalten von Marktplätzen
• Skills - Skill-Entwicklungsdetails
• Subagents - Agent-Konfiguration und Fähigkeiten
• Hooks - Event-Handling und Automatisierung
• MCP - Integration externer Tools
• Einstellungen - Konfigurationsoptionen für Plugins