Plugins-Referenz

Vollständige technische Referenz für das Claude Code Plugin-System, einschließlich Schemas, CLI-Befehle und Komponentenspezifikationen.

Ein Plugin ist ein eigenständiges Verzeichnis von Komponenten, das Claude Code mit benutzerdefinierten Funktionen erweitert. Plugin-Komponenten umfassen Skills, Agents, Hooks, MCP-Server, LSP-Server und Monitore.

Referenz für Plugin-Komponenten

Skills

Plugins fügen Claude Code Skills hinzu und erstellen /name Shortcuts, die Sie oder Claude aufrufen können.

Speicherort: skills/ oder commands/ Verzeichnis im Plugin-Root oder eine einzelne SKILL.md Datei im Plugin-Root

Dateiformat: Skills sind Verzeichnisse mit SKILL.md; Commands sind einfache Markdown-Dateien

Skill-Struktur:

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

Skills und Commands werden automatisch erkannt, wenn das Plugin installiert wird.

Wenn ein Plugin kein skills/ Verzeichnis und kein skills Manifest-Feld hat, wird eine SKILL.md im Plugin-Root als einzelner Skill geladen. Setzen Sie das Frontmatter-Feld name, um den Aufrufen-Namen des Skills zu steuern. Ohne dieses Feld greift Claude Code auf den Installationsverzeichnisnamen zurück, der bei Marketplace-installierten Plugins ein Versionsstring ist, der sich bei jedem Update ändert. Für Plugins, die mehr als einen Skill bereitstellen, verwenden Sie das oben gezeigte skills/ Verzeichnis-Layout.

In Plugin-Skills und Commands akzeptieren Boolean-Frontmatter-Felder wie disable-model-invocation yes, no, on, off, 1 und 0 in beliebiger Schreibweise zusätzlich zu true und false. Vor v2.1.218 erkannte Claude Code nur true und false.

Vollständige Details finden Sie unter Skills.

Agents

Plugins können spezialisierte Subagents 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:

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

Detaillierte Systemaufforderung für den Agent, die seine Rolle, Expertise und sein Verhalten beschreibt.

Plugin-Agents unterstützen die Frontmatter-Felder name, description, model, effort, maxTurns, tools, disallowedTools, skills, memory, background und isolation. Der einzige gültige isolation Wert ist "worktree". Aus Sicherheitsgründen werden hooks, mcpServers und permissionMode für von Plugins bereitgestellte Agents nicht unterstützt.

Claude Code lädt einen Plugin-Agent auch dann, wenn sein Frontmatter kein name Feld hat oder nicht geparst werden kann:

Kein name: Claude Code benennt den Agent nach der Datei, also wird agents/reviewer.md in einem Plugin namens my-plugin als my-plugin:reviewer geladen
Frontmatter, das nicht geparst werden kann: Claude Code benennt den Agent nach der Datei, verwendet Agent from my-plugin plugin als Beschreibung und ignoriert jedes Feld in der Datei

Im Gegensatz dazu überspringt Claude Code eine Projekt-, Benutzer- oder verwaltete Agent-Datei, deren Frontmatter kein name Feld hat oder nicht geparst werden kann.

Um Dateien im Standard-agents/ Verzeichnis eines Plugins zu finden, deren Frontmatter nicht geparst werden kann, führen Sie claude plugin validate aus. Der Pfad, den Sie übergeben, hängt davon ab, ob das Plugin ein Manifest hat, und beide Beispiele verwenden ./my-plugin als Plugin-Verzeichnis:

Ein Plugin mit Manifest: claude plugin validate ./my-plugin
Ein Plugin ohne Manifest: claude plugin validate ./my-plugin/agents. Erfordert Claude Code v2.1.233 oder später.

Agents erscheinen in der @-Mention Typeahead unter ihrem scoped Namen, wie my-plugin:code-reviewer, sobald das Plugin aktiviert ist.

Vollständige Details finden Sie unter Subagents.

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

Plugin-Hooks reagieren auf die gleichen Lifecycle-Events wie benutzerdefinierte Hooks:

Event	When it fires
`SessionStart`	When a session begins or resumes
`Setup`	When you start Claude Code with `--init-only`, or with `--init` or `--maintenance` in `-p` mode. For one-time preparation in CI or scripts
`UserPromptSubmit`	When you submit a prompt, before Claude processes it
`UserPromptExpansion`	When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion
`PreToolUse`	Before a tool call executes. Can block it
`PermissionRequest`	When a tool call needs a permission decision
`PermissionDenied`	When auto mode denies a tool call, including denials without a classifier verdict. Use JSON `hookSpecificOutput.retry: true` to tell the model it may retry the denied tool call. Claude Code ignores `retry` when the classifier produced no verdict
`PostToolUse`	After a tool call succeeds
`PostToolUseFailure`	After a tool call fails
`PostToolBatch`	After a full batch of parallel tool calls resolves, before the next model call
`Notification`	When Claude Code sends a notification
`MessageDisplay`	While assistant message text is displayed
`SubagentStart`	When a subagent is spawned
`SubagentStop`	When a subagent finishes
`TaskCreated`	When a task is being created via `TaskCreate`
`TaskCompleted`	When a task is being marked as completed
`Stop`	When Claude finishes responding
`StopFailure`	When the turn ends due to an API error
`TeammateIdle`	When an agent team teammate is about to go idle
`InstructionsLoaded`	When a CLAUDE.md or `.claude/rules/*.md` file is loaded into context. Fires at session start and when files are lazily loaded during a session
`ConfigChange`	When a configuration file changes during a session
`CwdChanged`	When the working directory changes, for example when Claude executes a `cd` command. Useful for reactive environment management with tools like direnv
`DirectoryAdded`	When a working directory is added mid-session via `/add-dir` or the SDK `register_repo_root` control request
`FileChanged`	When a watched file changes on disk. The `matcher` field specifies which filenames to watch
`WorktreeCreate`	When a worktree is being created via `--worktree`, `isolation: "worktree"`, or for a background session. Replaces default git behavior
`WorktreeRemove`	When a worktree is being removed at session exit, when a subagent finishes, or when you delete a background session
`PreCompact`	Before context compaction
`PostCompact`	After context compaction completes
`PreModelSwitch`	Before Claude Code applies a model switch that you or a client requested. Can block the switch
`PostModelSwitch`	After the session's model changes, including changes Claude Code makes on its own, such as restoring the model when you resume a session
`Elicitation`	When an MCP server requests user input during a tool call
`ElicitationResult`	After a user responds to an MCP elicitation, before the response is sent back to the server
`SessionEnd`	When a session terminates

Hook-Typen:

command: Shell-Commands oder Scripts ausführen
http: Das Event-JSON als POST-Request an eine URL senden
mcp_tool: Ein Tool auf einem konfigurierten MCP Server aufrufen
prompt: Eine Aufforderung mit einem LLM evaluieren (verwendet $ARGUMENTS Platzhalter für Kontext)
agent: Einen agentic Verifier mit Tools für komplexe Verifikationsaufgaben ausführen

Hooks, die auf den eigenen gebündelten MCP Server des Plugins abzielen, müssen seine scoped Namen verwenden. Tool-Matcher und if Felder verwenden den scoped Tool-Namen mcp__plugin_<plugin-name>_<server-name>__<tool>, und das server Feld eines mcp_tool Hooks verwendet plugin:<plugin-name>:<server-name>. Ein Matcher, der gegen den bloßen Server-Schlüssel geschrieben wird, wird nie ausgelöst. Siehe Match MCP tools und Plugin-bereitgestellte MCP Server.

MCP servers

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 Server-Konfiguration

MCP Server-Konfiguration:

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

Integrations-Verhalten:

Plugin MCP Server starten automatisch, wenn das Plugin aktiviert ist
Server erscheinen als Standard MCP Tools in Claudes Toolkit
Plugin Server können unabhängig von Benutzer MCP Servern konfiguriert werden
Wenn Sie /reload-plugins während einer Session ausführen, behält Claude Code die Live-Verbindungen von Servern bei, deren Konfiguration unverändert ist

LSP servers

Plugins können Language Server Protocol (LSP) Server bereitstellen, um Claude Echtzeit-Code-Intelligenz beim Arbeiten an Ihrer Codebasis zu geben.

Speicherort: .lsp.json im Plugin-Root oder inline in plugin.json

Format: JSON-Konfiguration, die Language Server Namen ihren Konfigurationen zuordnet

.lsp.json Dateiformat:

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

Inline in plugin.json:

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

Erforderliche Felder:

Feld	Beschreibung
`command`	Die auszuführende LSP-Binärdatei (muss in PATH sein)
`extensionToLanguage`	Ordnet Dateierweiterungen Sprachbezeichnern zu

Optionale Felder:

Feld	Beschreibung
`args`	Befehlszeilenargumente für den LSP Server
`transport`	Kommunikations-Transport: `stdio` (Standard) oder `socket`. Claude Code akzeptiert `socket`, führt aber jeden Server über stdio aus, daher gelten die stdout-Protokoll-Regeln für alle Server
`env`	Umgebungsvariablen, die beim Starten des Servers gesetzt werden
`initializationOptions`	Optionen, die während der Initialisierung an den Server übergeben werden
`settings`	Einstellungen, die über `workspace/didChangeConfiguration` übergeben werden
`workspaceFolder`	Workspace-Ordnerpfad für den Server
`startupTimeout`	Maximale Wartezeit für Server-Start (Millisekunden)
`shutdownTimeout`	Maximale Wartezeit für ordnungsgemäßes Herunterfahren (Millisekunden). Wenn das Timeout abläuft, beendet Claude Code den Server-Prozess. Wenn nicht gesetzt, gilt kein Timeout
`restartOnCrash`	Ob der Server nach einem Absturz neu gestartet werden soll. Standard ist `true`. Setzen Sie auf `false`, um einen abgestürzten Server gestoppt zu lassen, anstatt ihn neu zu starten
`maxRestarts`	Maximale Anzahl von Neustartversuchen, bevor aufgegeben wird
`diagnostics`	Ob Diagnostiken nach Änderungen in Claudes Kontext eingefügt werden sollen (Standard `true`). Setzen Sie auf `false`, um Code-Navigation beizubehalten, aber automatische Diagnostik-Einspeisung zu unterdrücken.

restartOnCrash und shutdownTimeout erfordern Claude Code v2.1.205 oder später. Vor v2.1.205 akzeptierte das Config-Schema beide Optionen, aber das Setzen einer dieser Optionen führte dazu, dass Claude Code diesen LSP Server beim Start vollständig übersprang, wobei der Grund nur in der claude --debug Ausgabe sichtbar war.

Mehrere Server für die gleiche Erweiterung: Wenn mehr als ein aktivierter LSP Server die gleiche Dateierweiterung in extensionToLanguage deklariert, ob die Server von einem Plugin oder von verschiedenen Plugins stammen, verarbeitet der zuerst registrierte Server Dateien mit dieser Erweiterung und die anderen starten nie. Die /plugin Schnittstelle zeigt eine Warnung an, die das Plugin benennt, dessen Server aktiv ist.

Server, die nicht initialisiert werden können: Claude Code überspringt einen Server, dessen Konfiguration ungültig ist, z. B. einer, dem command oder extensionToLanguage fehlt, und die anderen konfigurierten Server starten trotzdem. Führen Sie claude --debug aus, um zu sehen, warum ein Server übersprungen wurde.

Ein übersprungener Server beansprucht seine Dateierweiterungen nicht, daher kann ein anderer gültiger Server, der die gleiche Erweiterung deklariert, vom gleichen oder einem anderen Plugin, diese Dateien trotzdem verarbeiten.

Senden Sie Log-Ausgabe an stderr, nicht stdout: Claude Code liest den stdout eines Servers nur als Protokollmeldungen und akzeptiert Nachrichtenheader bis zu 64 KiB und einen Nachrichtentext bis zu 32 MiB. Claude Code trennt einen Server, der eines dieser Limits überschreitet oder nicht-Protokoll-Ausgabe an stdout schreibt, und zählt die Trennung als Absturz für restartOnCrash und maxRestarts. Wenn Sie mit --debug ausführen, schreibt Claude Code einen Fehler, der die Ursache benennt, in das Debug-Log.

Verfügbare LSP Plugins:

Plugin	Language Server	Installationsbefehl
`pyright-lsp`	Pyright (Python)	`pip install pyright` oder `npm install -g pyright`
`typescript-lsp`	TypeScript Language Server	`npm install -g typescript-language-server typescript`
`rust-analyzer-lsp`	rust-analyzer	Siehe rust-analyzer Installation

Installieren Sie zuerst den Language Server und dann das Plugin aus dem Marketplace.

Monitors

Plugins können Background-Monitore deklarieren, die Claude Code automatisch startet, wenn das Plugin aktiv ist. Jeder Monitor führt einen Shell-Befehl für die Lebensdauer der Session aus und liefert jede stdout-Zeile als Benachrichtigung an Claude, damit Claude auf Log-Einträge, Statusänderungen oder abgerufene Events reagieren kann, ohne aufgefordert zu werden, die Überwachung selbst zu starten.

Plugin-Monitore verwenden den gleichen Mechanismus wie das Monitor Tool und teilen seine Verfügbarkeitsbeschränkungen. Sie laufen nur in interaktiven CLI-Sessions, laufen unsandboxed auf der gleichen Vertrauensebene wie Hooks und werden auf Hosts übersprungen, wo das Monitor Tool nicht verfügbar ist.

Speicherort: monitors/monitors.json im Plugin-Root oder inline in plugin.json

Format: JSON-Array von Monitor-Einträgen

Die folgende monitors/monitors.json überwacht einen Deployment-Status-Endpunkt und ein lokales Error-Log:

[
  {
    "name": "deploy-status",
    "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/poll-deploy.sh",
    "description": "Deployment status changes"
  },
  {
    "name": "error-log",
    "command": "tail -F ./logs/error.log",
    "description": "Application error log",
    "when": "on-skill-invoke:debug"
  }
]

Um Monitore inline zu deklarieren, setzen Sie experimental.monitors in plugin.json auf das gleiche Array. Um von einem nicht-Standard-Pfad zu laden, setzen Sie experimental.monitors auf einen relativen Pfad-String wie "./config/monitors.json". Monitore sind eine experimentelle Komponente.

Erforderliche Felder:

Feld	Beschreibung
`name`	Bezeichner, der innerhalb des Plugins eindeutig ist. Verhindert doppelte Prozesse, wenn das Plugin neu geladen wird oder ein Skill erneut aufgerufen wird
`command`	Shell-Befehl, der als persistenter Background-Prozess im Session-Arbeitsverzeichnis ausgeführt wird
`description`	Kurze Zusammenfassung dessen, was überwacht wird. Wird im Task-Panel und in Benachrichtigungszusammenfassungen angezeigt

Optionale Felder:

Feld	Beschreibung
`when`	Steuert, wann der Monitor startet. `"always"` startet ihn beim Session-Start und beim Plugin-Reload und ist der Standard. `"on-skill-invoke:<skill-name>"` startet ihn das erste Mal, wenn der benannte Skill in diesem Plugin versendet wird

Der command Wert unterstützt die Pfad-Substitutionen ${CLAUDE_PLUGIN_ROOT}, ${CLAUDE_PLUGIN_DATA} und ${CLAUDE_PROJECT_DIR}, plus alle ${ENV_VAR} aus der Umgebung. Präfixieren Sie den Befehl mit cd "${CLAUDE_PLUGIN_ROOT}" && , wenn das Script aus dem eigenen Verzeichnis des Plugins ausgeführt werden muss.

Ein Monitor command kann nicht auf ${user_config.*} Werte verweisen. Der Befehl läuft durch eine Shell, daher lehnt Claude Code den Monitor mit einem Fehler ab, anstatt den Wert zu ersetzen. Monitor-Prozesse erhalten keine CLAUDE_PLUGIN_OPTION_<KEY> Umgebungsvariablen, daher sollte das Monitor-Script den Wert aus einer Konfigurationsdatei lesen, die es besitzt.

Wenn Sie ein Plugin während einer Session deaktivieren, stoppt Claude Code nicht die Monitore, die bereits laufen; sie stoppen, wenn die Session endet.

Themes

Plugins können Farbthemes bereitstellen, die in /theme neben den integrierten Voreinstellungen und den lokalen Themes des Benutzers erscheinen. Ein Theme ist eine JSON-Datei in themes/ mit einer base Voreinstellung und einer sparsamen overrides Map von Farb-Tokens. Themes sind eine experimentelle Komponente.

{
  "name": "Dracula",
  "base": "dark",
  "overrides": {
    "claude": "#bd93f9",
    "error": "#ff5555",
    "success": "#50fa7b"
  }
}

Wenn ein Benutzer ein Plugin-Theme auswählt, speichert Claude Code custom:<plugin-name>:<slug> in seiner Konfiguration. Plugin-Themes sind schreibgeschützt: Wenn ein Benutzer Ctrl+E auf einem in /theme drückt, kopiert Claude Code es in ~/.claude/themes/, damit er die Kopie bearbeiten kann.

Installationsbereiche für Plugins

Wenn Sie ein Plugin installieren, wählen Sie einen Bereich aus, der bestimmt, wo das Plugin verfügbar ist und wer es sonst noch verwenden kann:

Bereich	Einstellungsdatei	Anwendungsfall
`user`	`~/.claude/settings.json`	Persönliche Plugins, die in allen Projekten verfügbar sind (Standard)
`project`	`.claude/settings.json`	Team-Plugins, die über Versionskontrolle freigegeben werden
`local`	`.claude/settings.local.json`	Projektspezifische Plugins, gitignored, wenn Claude Code eine Einstellung darin speichert
`managed`	Managed settings	Verwaltete Plugins (schreibgeschützt, nur Update)

Plugins verwenden das gleiche Bereichssystem wie andere Claude Code-Konfigurationen. Installationsanweisungen und Bereichsflags finden Sie unter Plugins installieren. Eine vollständige Erklärung der Bereiche finden Sie unter Konfigurationsbereiche.

Plugins aus dem Skills-Verzeichnis

Jeder Ordner unter einem Skills-Verzeichnis, der ein .claude-plugin/plugin.json-Manifest enthält, wird in der nächsten Sitzung als Plugin mit dem Namen <name>@skills-dir geladen, ohne Marketplace und ohne Installationsschritt. Erstellen Sie eines mit plugin init. Im Gegensatz zu einer kopierten Marketplace-Installation wird das Plugin an Ort und Stelle erkannt, anstatt in den Plugin-Cache kopiert zu werden.

Eine Skills-Verzeichnisstruktur unterstützt drei verschiedene Dinge:

Was Sie haben	Was es ist
`<skills-dir>/foo/SKILL.md` ohne Manifest	Ein einfaches Skill mit dem Namen `foo`
`<skills-dir>/foo/.claude-plugin/plugin.json`	Ein Plugin `foo@skills-dir`, das seine eigenen Skills, Agents, Hooks und mehr bündeln kann
`<plugin>/skills/bar/SKILL.md`	Ein Skill `bar`, das in einem Plugin verpackt ist

Wählen Sie, von wo aus das Plugin geladen wird

Skills-Verzeichnis	Bereich	Lädt
`~/.claude/skills/`	persönlich	In jedem Projekt, da der Speicherort nur Ihnen gehört
`<cwd>/.claude/skills/`	Projekt	Nur nachdem Sie den Workspace-Vertrauensdialog für diesen Ordner akzeptiert haben

Ein Plugin im Projektbereich wird in das Repository eingecheckt und erreicht jeden Mitarbeiter, der es klont. Da dieser Inhalt aus dem Repository und nicht von Ihnen stammt, wird er nur nach demselben Vertrauenstor geladen, das die Projekterlaubnisregeln in .claude/settings.json regelt. Das Vertrauen in einen übergeordneten Ordner oder das Ausführen mit -p ist daher nicht ausreichend, und Komponenten, die Code ausführen, sind weiter eingeschränkt:

MCP-Server, die es deklariert, durchlaufen die gleiche Pro-Server-Genehmigung wie ein Projekt .mcp.json
LSP-Server starten nur, nachdem Sie den Workspace vertrauen
Hintergrund-Monitore werden nicht geladen

Plugins im persönlichen Bereich haben keine dieser Einschränkungen.

Bearbeiten, neu laden und deaktivieren Sie ein Plugin aus dem Skills-Verzeichnis

Änderungen, die Sie an der SKILL.md eines Skills vornehmen, werden sofort in der aktuellen Sitzung wirksam. Änderungen an anderen Komponenten des Plugins, wie hooks/, .mcp.json, agents/ und output-styles/, werden nicht wirksam. Führen Sie /reload-plugins aus oder starten Sie Claude Code neu, um diese zu übernehmen. Siehe Live-Änderungserkennung.

Um das Laden eines Plugins aus dem Skills-Verzeichnis zu beenden, löschen Sie seinen Ordner oder deaktivieren Sie es nach Name. Es gibt keinen uninstall-Schritt, da nichts von einem Marketplace installiert wurde.

claude plugin disable my-tool@skills-dir

Plugins synchronisiert von claude.ai

In Cowork und Cloud-Sitzungen lädt Claude Code die für Ihr claude.ai-Konto aktivierten Plugins in ~/.claude/plugins/synced/ in der eigenen Umgebung der Sitzung herunter und lädt jedes als <name>@synced, ohne Marketplace und ohne Installationsdatensatz. Claude Code lädt sie nicht in Sitzungen, die Sie in Ihrem eigenen Terminal starten. In dieser Cowork- oder Cloud-Umgebung zeigt claude plugin list die heruntergeladenen Kopien unter einer Synced from claude.ai-Überschrift an. Vor v2.1.239 lud Claude Code diese Plugins als <name>@inline, die Identität, die --plugin-dir-Plugins verwenden.

Verwalten Sie ein synchronisiertes Plugin über die <name>@synced-ID, die claude plugin list ausgibt:

Eines ausschalten: Führen Sie in der synchronisierten Sitzung claude plugin disable <name>@synced aus, oder bitten Sie Claude, es auszuführen. Claude Code speichert die Auswahl als "<name>@synced": false in der enabledPlugins dieser Umgebung auf Benutzerebene. Um das Plugin wieder einzuschalten, führen Sie claude plugin enable <name>@synced in derselben Sitzung aus. Um ein Plugin aus jeder synchronisierten Sitzung herauszuhalten, schalten Sie es für Ihr claude.ai-Konto aus. Um es aus den synchronisierten Sitzungen eines Projekts in jeder Umgebung herauszuhalten, setzen Sie "<name>@synced": false unter enabledPlugins in der committed .claude/settings.json dieses Projekts.
Verwalten Sie das Plugin selbst auf claude.ai: claude plugin install, update und uninstall gelten nicht für ein synchronisiertes Plugin. Um eines zu entfernen, schalten Sie das Plugin für Ihr claude.ai-Konto aus; die nächste synchronisierte Sitzung startet ohne es.

Wenn ein aktiviertes Plugin aus einer anderen Quelle, wie eine Marketplace-Installation, ein Skills-Directory-Plugin oder ein --plugin-dir-Plugin, den Namen eines synchronisierten Plugins entspricht, lädt Claude Code dieses Plugin und meldet die synchronisierte Kopie als nicht geladen. Um stattdessen die claude.ai-Kopie zu verwenden, deaktivieren Sie Ihre eigene Kopie. Vor v2.1.239 lud Claude Code die synchronisierte Kopie statt einer gleichnamigen Marketplace-Installation.

Plugin-Manifest-Schema

Die Datei .claude-plugin/plugin.json definiert die Metadaten und Konfiguration Ihres Plugins.

Das Manifest ist optional. Falls weggelassen, erkennt Claude Code Komponenten automatisch in Standardpfaden und leitet den Plugin-Namen aus dem Verzeichnisnamen ab. Verwenden Sie ein Manifest, wenn Sie Metadaten oder benutzerdefinierte Komponentenpfade bereitstellen müssen.

Vollständiges Schema

{
  "name": "plugin-name",
  "displayName": "Plugin Name",
  "version": "1.2.0",
  "description": "Brief plugin description",
  "author": {
    "name": "Author Name",
    "email": "author@example.com",
    "url": "https://github.com/author"
  },
  "homepage": "https://docs.example.com/plugin",
  "repository": "https://github.com/author/plugin",
  "license": "MIT",
  "keywords": ["keyword1", "keyword2"],
  "metadata": { "catalogId": "cat-123", "tier": "pro" },
  "skills": "./custom/skills/",
  "commands": ["./custom/commands/special.md"],
  "agents": ["./custom/agents/reviewer.md"],
  "hooks": "./config/hooks.json",
  "mcpServers": "./mcp-config.json",
  "outputStyles": "./styles/",
  "lspServers": "./.lsp.json",
  "experimental": {
    "themes": "./themes/",
    "monitors": "./monitors.json"
  },
  "dependencies": [
    "helper-lib",
    { "name": "secrets-vault", "version": "~2.1.0" }
  ]
}

Erforderliche Felder

Wenn Sie ein Manifest einbeziehen, ist name das einzige erforderliche Feld.

Feld	Typ	Beschreibung	Beispiel
`name`	string	Eindeutiger Bezeichner in Kebab-Case ohne Leerzeichen, Steuerzeichen oder bidirektionale Formatierungszeichen. Wenn ein Marketplace-Eintrag das Plugin unter einem anderen Namen auflistet, ist der Name des Marketplace-Eintrags das, was `enabledPlugins`-Schlüssel und `/plugin` verwenden	`"deployment-tools"`

Dieser Name wird für die Namensgebung von Komponenten verwendet. Beispielsweise wird der Agent agent-creator für das Plugin mit dem Namen plugin-dev in der Benutzeroberfläche als plugin-dev:agent-creator angezeigt.

Nicht erkannte Felder

Claude Code ignoriert Felder auf oberster Ebene, die nicht erkannt werden. Sie können Metadaten aus einem anderen Ökosystem in plugin.json behalten und das Plugin wird trotzdem geladen. Dies macht es praktisch, ein Manifest zu verwalten, das gleichzeitig als VS Code- oder Cursor-Erweiterungsmanifest, eine npm-package.json oder ein MCPB/DXT-Bundle-Manifest dient.

claude plugin validate meldet nicht erkannte Felder als Warnungen, nicht als Fehler. Wenn ein Feld ein oder zwei Zeichen von einem erkannten Feld entfernt ist, schlägt die Warnung den wahrscheinlich beabsichtigten Namen vor. Ein Plugin mit nur Warnungen zu nicht erkannten Feldern besteht die Validierung und wird zur Laufzeit geladen.

Wie Claude Code ein erkanntes Feld behandelt, dessen Wert den falschen Typ hat, hängt vom Feld ab:

Die meisten Felder: Das Plugin kann nicht geladen werden. Beispielsweise ist ein keywords-Wert, der ein String statt eines Arrays ist, ein Ladefehler, und claude plugin validate meldet ihn als solchen.
experimental und metadata: Claude Code ignoriert einen Nicht-Objekt-Wert, und claude plugin validate meldet eine Warnung.

Übergeben Sie --strict, um Warnungen als Fehler zu behandeln. Verwenden Sie es in CI, um einen falsch geschriebenen Feldnamen oder ein Feld, das von einem anderen Tool-Manifest übrig geblieben ist, vor der Veröffentlichung zu erfassen, obwohl das Plugin zur Laufzeit geladen würde.

claude plugin validate ./my-plugin --strict

Metadatenfelder

Feld	Typ	Beschreibung	Beispiel
`$schema`	string	JSON-Schema-URL für Editor-Autovervollständigung und Validierung. Claude Code ignoriert dieses Feld zur Ladezeit.	`"https://json.schemastore.org/claude-code-plugin-manifest.json"`
`displayName`	string	Benutzerfreundlicher Name, der in der `/plugin`-Auswahl und anderen UI-Oberflächen angezeigt wird. Fällt auf `name` zurück, wenn weggelassen. Im Gegensatz zu `name` kann es Leerzeichen und beliebige Groß-/Kleinschreibung enthalten. Wird nicht für Namensgebung oder Suche verwendet.	`"Deployment Tools"`
`version`	string	Optional. Semantische Version. Das Setzen dieser Version fixiert das Plugin auf diese Versionsnummer, sodass Benutzer nur Updates erhalten, wenn Sie diese erhöhen, außer für eine `command`-Quelle; siehe Versionsverwaltung. Falls auch im Marketplace-Eintrag gesetzt, gewinnt `plugin.json`. Falls weggelassen, kommt die Version aus der nächsten Quelle in Versionsverwaltung.	`"2.1.0"`
`description`	string	Kurze Erklärung des Plugin-Zwecks	`"Deployment automation tools"`
`author`	object	Autoreninformationen	`{"name": "Dev Team", "email": "dev@company.com"}`
`homepage`	string	Dokumentations-URL	`"https://docs.example.com"`
`repository`	string	Quellcode-URL	`"https://github.com/user/plugin"`
`license`	string	Lizenzbezeichner	`"MIT"`, `"Apache-2.0"`
`keywords`	array	Erkennungs-Tags	`["deployment", "ci-cd"]`
`metadata`	object	Freiformobjekt für Ihre eigenen Daten, wie Berechtigungs- oder Katalogfelder. Claude Code liest es nicht, daher beeinflussen die Werte niemals das Plugin-Verhalten. Claude Code ignoriert einen Nicht-Objekt-Wert, und `claude plugin validate` meldet ihn als Warnung. Vor v2.1.222 behandelte Claude Code den Schlüssel als nicht erkanntes Feld.	`{"catalogId": "cat-123"}`
`defaultEnabled`	boolean	Ob das Plugin in einem aktivierten Zustand startet, wenn der Benutzer keinen gesetzt hat. Standardmäßig `true`. Siehe Standardaktivierung.	`false`

Standardaktivierung

Setzen Sie defaultEnabled: false in plugin.json, um ein Plugin zu versenden, das deaktiviert installiert wird. Der Benutzer aktiviert es mit claude plugin enable <plugin> oder der /plugin-Schnittstelle. Verwenden Sie dies für Plugins, die Kosten verursachen oder einen Umfang haben, den ein Benutzer akzeptieren sollte, wie eines, das sich mit einem externen Service verbindet.

defaultEnabled ist der Fallback, wenn nichts anderes den Zustand des Plugins entschieden hat. Zwei Dinge haben Vorrang vor ihm:

Die Einstellung des Benutzers: ein Eintrag für das Plugin in enabledPlugins in jedem Einstellungsbereich. Einmal geschrieben, bleibt es über Plugin-Updates und Neuinstallationen hinweg bestehen, daher ändert das Ändern von defaultEnabled in einer späteren Version nicht den Zustand eines bestehenden Benutzers.
Eine Abhängigkeitsanforderung: Wenn ein Plugin von einem anderen erforderlich ist, das aktiv ist, schreibt Claude Code true dafür bei Installation oder Aktivierung. Das gibt ihm eine explizite Einstellung, daher gilt sein eigener Standard nicht mehr. Siehe Plugin mit Abhängigkeiten aktivieren oder deaktivieren.

Das gleiche Feld kann im Marketplace-Eintrag eines Plugins erscheinen, wo es Vorrang vor dem Wert in plugin.json hat. Siehe Optionale Plugin-Felder.

Komponentenpfad-Felder

Feld	Typ	Beschreibung	Beispiel
`skills`	string\|array	Benutzerdefinierte Skill-Verzeichnisse mit `<name>/SKILL.md`. Ergänzt den Standard-`skills/`-Scan. Siehe Pfadverhaltenregeln für die Marketplace-Root-Ausnahme	`"./custom/skills/"`
`commands`	string\|array	Benutzerdefinierte flache `.md`-Skill-Dateien oder Verzeichnisse (ersetzt Standard-`commands/`)	`"./custom/cmd.md"` oder `["./cmd1.md"]`
`agents`	string\|array	Benutzerdefinierte Agent-Dateien (ersetzt Standard-`agents/`)	`"./custom/agents/reviewer.md"`
`workflows`	string\|array	Benutzerdefinierte Workflow-Skriptdateien oder Verzeichnisse (ersetzt Standard-`workflows/`)	`"./custom/workflows/"`
`hooks`	string\|array\|object	Hook-Konfigurationspfade oder Inline-Konfiguration	`"./my-extra-hooks.json"`
`mcpServers`	string\|array\|object	MCP-Konfigurationspfade oder Inline-Konfiguration	`"./my-extra-mcp-config.json"`
`outputStyles`	string\|array	Benutzerdefinierte Ausgabestil-Dateien/Verzeichnisse (ersetzt Standard-`output-styles/`)	`"./styles/"`
`lspServers`	string\|array\|object	Language Server Protocol-Konfigurationen für Code-Intelligenz (Gehe zu Definition, Finde Referenzen usw.)	`"./.lsp.json"`
`experimental.themes`	string\|array	Farbthema-Dateien/Verzeichnisse (ersetzt Standard-`themes/`). Siehe Themes	`"./themes/"`
`experimental.monitors`	string\|array	Hintergrund-Monitor-Konfigurationen, die automatisch starten, wenn das Plugin aktiv ist. Siehe Monitors	`"./monitors.json"`
`userConfig`	object	Benutzerkonfigurierbare Werte, die bei Aktivierung abgefragt werden. Siehe Benutzerkonfiguration	Siehe unten
`channels`	array	Kanal-Deklarationen für Nachrichteneinspeisung (Telegram, Slack, Discord-Stil). Siehe Kanäle	Siehe unten
`dependencies`	array	Andere Plugins, die dieses Plugin benötigt, optional mit Semver-Versionsbeschränkungen. Siehe Plugin-Abhängigkeitsversionen einschränken	`[{ "name": "secrets-vault", "version": "~2.1.0" }]`

Experimentelle Komponenten

Komponenten unter dem experimental-Schlüssel, themes und monitors, haben ein Manifest-Schema, das sich zwischen Releases ändern kann, während sie stabilisieren. Wo Sie sie deklarieren, ist eine separate Migration: Die oberste Ebene funktioniert immer noch, claude plugin validate warnt, und eine zukünftige Version wird experimental.* erfordern.

Benutzerkonfiguration

Das Feld userConfig deklariert Werte, die Claude Code den Benutzer abfragt, wenn das Plugin aktiviert wird. Verwenden Sie dies, anstatt Benutzer zu zwingen, settings.json manuell zu bearbeiten.

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

Schlüssel müssen gültige Bezeichner sein. Jede Option unterstützt diese Felder:

Feld	Erforderlich	Beschreibung
`type`	Ja	Einer von `string`, `number`, `boolean`, `directory` oder `file`
`title`	Ja	Beschriftung im Konfigurationsdialog
`description`	Ja	Hilfetext unter dem Feld
`sensitive`	Nein	Falls `true`, maskiert die Eingabe und speichert den Wert in sicherer Speicherung statt in `settings.json`
`required`	Nein	Falls `true`, schlägt die Validierung fehl, wenn das Feld leer ist
`default`	Nein	Wert, der verwendet wird, wenn der Benutzer nichts bereitstellt
`multiple`	Nein	Für `string`-Typ, erlauben Sie ein Array von Strings
`min` / `max`	Nein	Grenzen für `number`-Typ

Jeder Wert ist für die Substitution als ${user_config.KEY} in MCP- und LSP-Server-Konfigurationen und Hook-Befehlen verfügbar. Nicht-sensitive Werte können auch in Skill- und Agent-Inhalten ersetzt werden. Alle Werte werden an Hook-Prozesse als CLAUDE_PLUGIN_OPTION_<KEY>-Umgebungsvariablen exportiert, wobei <KEY> der Optionsschlüssel in Großbuchstaben ist.

Felder, die in einer Shell ausgeführt werden, lehnen ${user_config.*} ab: Das Ersetzen eines konfigurierten Werts in einem Shell-Befehl würde der Shell erlauben, alles auszuführen, was dieser Wert enthält, daher schlägt die Komponente mit einem Fehler fehl. Jedes abgelehnte Feld hat eine alternative Möglichkeit, den Wert zu übergeben:

Abgelehntes Feld	Wie man den Wert übergibt
Shell-Form-Hook-Befehle	Verwenden Sie exec-Form mit `args` oder lesen Sie `CLAUDE_PLUGIN_OPTION_<KEY>` aus der Hook-Umgebung
Monitor-Befehle	Lesen Sie den Wert aus einer Konfigurationsdatei im Skript
MCP `headersHelper`	Lesen Sie den Wert aus einer Konfigurationsdatei im Skript

Vor v2.1.207 ersetzten diese Felder ${user_config.KEY}-Werte; aktualisieren Sie Plugins, die sich darauf verlassen haben.

Nicht-sensitive Werte werden unter dem pluginConfigs-Schlüssel in Ihrer Benutzer-settings.json als pluginConfigs[<plugin-id>].options gespeichert.

Auf macOS speichert Claude Code sensitive Werte in der macOS Keychain und fällt auf ~/.claude/.credentials.json zurück, wenn die Keychain den Schreibvorgang ablehnt. Auf Plattformen ohne unterstützte Keychain speichert es sie in ~/.claude/.credentials.json. Keychain-Speicherung wird mit OAuth-Tokens geteilt und hat eine ungefähre Gesamtgrenze von 2 KB, daher halten Sie sensitive Werte klein.

Claude Code liest alle pluginConfigs-Werte nur aus drei Einstellungsquellen:

Benutzereinstellungen: ~/.claude/settings.json, die Datei, in die die Aktivierungsaufforderung schreibt
--settings: das CLI-Flag oder SDK-Inline-Einstellungen
Verwaltete Einstellungen: organisationskontrollierte Richtlinie

Wenn mehr als eine Quelle denselben Schlüssel setzt, haben verwaltete Einstellungen Vorrang, dann --settings, dann Benutzereinstellungen. Die einzige Quelle, die Sie aus dieser Liste entfernen können, sind Benutzereinstellungen: Übergeben Sie --setting-sources ohne user und Claude Code überspringt sie. Verwaltete Einstellungen und --settings bleiben, was Sie übergeben. Die SDK-Option settingSources setzt die gleiche Liste.

Einträge in einer Projekt-.claude/settings.json oder .claude/settings.local.json werden ignoriert. Beide Dateien befinden sich im Workspace, daher könnte ein geklontes Repository Werte dort bereitstellen, und diese Werte würden in Plugin-Hook-Befehle, MCP-Server-Konfigurationen, LSP-Befehle und Monitor-Befehle fließen. Vor v2.1.207 wurden diese Einträge gelesen. Die Einschränkung ist spezifisch für pluginConfigs: enabledPlugins berücksichtigt immer noch Projekt- und lokale Einstellungen.

Kanäle

Das Feld channels ermöglicht es einem Plugin, einen oder mehrere Nachrichtenkanäle zu deklarieren, die Inhalte in die Konversation einspritzen. Jeder Kanal bindet sich an einen MCP-Server, den das Plugin bereitstellt.

{
  "channels": [
    {
      "server": "telegram",
      "userConfig": {
        "bot_token": {
          "type": "string",
          "title": "Bot token",
          "description": "Telegram bot token",
          "sensitive": true
        },
        "owner_id": {
          "type": "string",
          "title": "Owner ID",
          "description": "Your Telegram user ID"
        }
      }
    }
  ]
}

Das Feld server ist erforderlich und muss einem Schlüssel in den mcpServers des Plugins entsprechen. Das optionale Pro-Kanal-userConfig verwendet das gleiche Schema wie das Feld auf oberster Ebene, wodurch das Plugin Bot-Tokens oder Owner-IDs abfragen kann, wenn das Plugin aktiviert wird.

Pfadverhaltenregeln

Ob ein benutzerdefinierter Pfad das Standard-Verzeichnis des Plugins ersetzt oder erweitert, hängt vom Feld ab:

Ersetzt den Standard: commands, agents, workflows, outputStyles, experimental.themes, experimental.monitors. Beispielsweise wird das Standard-commands/-Verzeichnis nicht gescannt, wenn das Manifest commands angibt. Um den Standard zu behalten und mehr hinzuzufügen, listen Sie ihn explizit auf: "commands": ["./commands/", "./extras/"]
Ergänzt den Standard: skills. Das Standard-skills/-Verzeichnis wird immer gescannt, und Verzeichnisse, die in skills aufgelistet sind, werden zusammen mit ihm geladen. Ausnahme: für einen Marketplace-Eintrag, dessen source zum Marketplace-Root aufgelöst wird, ersetzt das Deklarieren spezifischer Unterverzeichnisse den Standard-skills/-Scan
Eigene Merge-Regeln: hooks, MCP-Server und LSP-Server. Siehe jeden Abschnitt, wie mehrere Quellen kombiniert werden

Wenn ein Plugin sowohl einen Standard-Ordner als auch den entsprechenden Manifest-Schlüssel hat, warnt Claude Code vor dem ignorierten Ordner in claude plugin list und der /plugin-Detailansicht. Das Plugin wird immer noch mit den Manifest-Pfaden geladen. Claude Code warnt nicht, wenn der Manifest-Schlüssel in den Standard-Ordner zeigt, beispielsweise "commands": ["./commands/deploy.md"], da dieser Pfad den Ordner explizit benennt.

Für alle Pfadfelder:

Alle Pfade müssen relativ zum Plugin-Root sein und mit ./ beginnen, außer dass das Feld skills auch "." akzeptiert
- Sowohl "." als auch "./" bezeichnen den Plugin-Root selbst
- Vor v2.1.221 schlug "." bei der Manifest-Validierung fehl und das Plugin wurde nicht geladen, daher verwenden Sie "./", um frühere Versionen zu unterstützen
Komponenten aus benutzerdefinierten Pfaden verwenden die gleichen Benennungs- und Namensgebungsregeln
Mehrere Pfade können als Arrays angegeben werden
Ein Skill-Pfad kann auf ein Verzeichnis zeigen, das direkt ein SKILL.md enthält, beispielsweise "skills": ["."] für den Plugin-Root
- Claude Code nimmt den Invokationsnamen des Skills aus dem Frontmatter-Feld name in SKILL.md, daher bleibt der Name stabil, egal wie das Installationsverzeichnis benannt ist
- Falls name nicht im Frontmatter gesetzt ist, fällt Claude Code auf den Verzeichnis-Basename zurück

Ein Plugin, das ein SKILL.md an seinem Root hat, kein skills/-Unterverzeichnis und kein skills-Manifest-Feld, wird automatisch als Single-Skill-Plugin geladen. Sie müssen "skills": ["./"] in plugin.json für dieses Layout nicht setzen.

Pfadbeispiele:

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

Umgebungsvariablen

Claude Code stellt drei Variablen zum Referenzieren von Pfaden bereit:

Variable	Wird aufgelöst zu	Verwenden Sie es für
`${CLAUDE_PLUGIN_ROOT}`	Absoluter Pfad zum Installationsverzeichnis des Plugins	Skripte, Binärdateien und Konfigurationsdateien, die mit dem Plugin gebündelt sind
`${CLAUDE_PLUGIN_DATA}`	Persistentes Verzeichnis, das Plugin-Updates überlebt, beim ersten Zugriff erstellt	Installierte Abhängigkeiten wie `node_modules` oder Python-Virtualumgebungen, generierter Code und Caches
`${CLAUDE_PROJECT_DIR}`	Der Projekt-Root	Projektlokale Skripte und Konfigurationsdateien

Alle drei werden als Umgebungsvariablen an Hook-Prozesse und an MCP- und LSP-Server-Subprozesse exportiert. Welche Felder sie inline ersetzen, hängt von der Plugin-Komponente ab:

Plugin-Komponente	Felder, in denen Platzhalter aufgelöst werden
Skill- und Agent-Inhalte	Überall, wo der Platzhalter erscheint
Hook- und Monitor-Befehle	Überall, wo der Platzhalter erscheint
MCP `stdio`-Server	`command`, `args`, `env`
MCP `http`, `sse`, `ws`-Server	`url`, `headers`, `headersHelper`
LSP-Server	`command`, `args`, `env`, `workspaceFolder`

In Hook-Befehlen verwenden Sie exec-Form mit args, damit jeder Pfad als ein Argument ohne Anführungszeichen übergeben wird. In Shell-Form-Hooks und Monitor-Befehlen wickeln Sie die Variablen in doppelte Anführungszeichen ein, wie in "${CLAUDE_PROJECT_DIR}/scripts/server.sh". Dieser Shell-Form-Hook führt ein mit einem Plugin gebündeltes Skript aus:

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

${CLAUDE_PLUGIN_ROOT} ändert sich, wenn das Plugin aktualisiert wird. Das Verzeichnis der vorherigen Version bleibt für einen Übergangszeitraum nach einem Update auf der Festplatte, aber behandeln Sie es als kurzlebig und schreiben Sie keinen Zustand dorthin. Siehe Plugin-Caching für Cleanup-Semantik.

Wenn ein Plugin während einer Sitzung aktualisiert wird, verwenden Hook-Befehle, Monitore, MCP-Server und LSP-Server weiterhin den Pfad der vorherigen Version. Führen Sie /reload-plugins aus, um Hooks, MCP-Server und LSP-Server zum neuen Pfad zu wechseln; Monitore erfordern einen Sitzungsneustart. Für ein Plugin mit einer command-Quelle kann Claude Code das Plugin selbst neu laden.

MCP-Server können auch die roots/list-Anfrage aufrufen, um die Arbeitsverzeichnisse der Sitzung zur Laufzeit zu lesen. Siehe was roots/list zurückgibt und wann Claude Code den Server über Änderungen benachrichtigt.

Persistentes Datenverzeichnis

Das Verzeichnis ${CLAUDE_PLUGIN_DATA} wird zu ~/.claude/plugins/data/{id}/ aufgelöst, wobei {id} der Plugin-Bezeichner mit Zeichen außerhalb von a-z, A-Z, 0-9, _ und - ist, die durch - ersetzt werden. Für ein Plugin, das als formatter@my-marketplace installiert ist, ist das Verzeichnis ~/.claude/plugins/data/formatter-my-marketplace/.

Eine häufige Verwendung ist die einmalige Installation von Sprachabhängigkeiten und deren Wiederverwendung über Sitzungen und Plugin-Updates hinweg. Verwenden Sie es für Python-Abhängigkeiten, Abhängigkeiten, die mit Yarn oder pnpm gesperrt sind, und Pakete, deren Lifecycle-Skripte ausgeführt werden müssen. Für ein Marketplace-installiertes Plugin benötigen Sie es möglicherweise überhaupt nicht: Claude Code installiert automatisch berechtigte Node.js-Paketabhängigkeiten, wenn es das Plugin zwischenspeichert.

Da das Datenverzeichnis länger lebt als jede einzelne Plugin-Version, kann eine Überprüfung auf Verzeichnisexistenz allein nicht erkennen, wenn ein Update das Abhängigkeitsmanifest des Plugins ändert. Das empfohlene Muster vergleicht das gebündelte Manifest mit einer Kopie im Datenverzeichnis und installiert neu, wenn sie sich unterscheiden.

Dieser SessionStart-Hook installiert node_modules beim ersten Durchlauf und erneut, wenn ein Plugin-Update ein geändertes package.json enthält:

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

Der diff beendet sich mit Nonzero, wenn die gespeicherte Kopie fehlt oder sich vom gebündelten unterscheidet, was sowohl den ersten Durchlauf als auch abhängigkeitsändernde Updates abdeckt. Falls npm install fehlschlägt, entfernt das nachfolgende rm das kopierte Manifest, damit die nächste Sitzung es erneut versucht.

Skripte, die in ${CLAUDE_PLUGIN_ROOT} gebündelt sind, können dann gegen die persistierten node_modules ausgeführt werden:

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

Das Datenverzeichnis wird automatisch gelöscht, wenn Sie das Plugin aus dem letzten Bereich deinstallieren, in dem es installiert ist. Die /plugin-Schnittstelle zeigt die Verzeichnisgröße an und fordert vor dem Löschen auf. Die CLI löscht standardmäßig; übergeben Sie --keep-data, um es zu behalten.

Plugin-Caching und Dateiauflösung

Plugins werden auf eine von zwei Arten angegeben:

Über claude --plugin-dir oder claude --plugin-url für die Dauer einer Sitzung.
Über einen Marketplace, installiert für zukünftige Sitzungen.

Aus Sicherheits- und Verifizierungsgründen kopiert Claude Code Marketplace-Plugins in den lokalen Plugin-Cache des Benutzers (~/.claude/plugins/cache), anstatt sie an Ort und Stelle zu verwenden, mit Ausnahme von command-Quellen im Link-Modus, die Claude Code an Ort und Stelle über Links im Cache-Eintrag verwendet.

Für kopierte Plugins ist jede installierte Version ein separates Verzeichnis im Cache, gruppiert nach Marketplace und Plugin und benannt nach der aufgelösten Version, mit einer eigenen Kopie der Plugin-Dateien und Node.js-Paketabhängigkeiten. Eine Abhängigkeit, die von einem Release-Tag aufgelöst wird, erhält einen Verzeichnisnamen mit einem Commit-SHA-Suffix.

Wenn Sie ein Plugin aktualisieren oder deinstallieren, markiert Claude Code das vorherige Versionsverzeichnis als verwaist und entfernt es in einem Hintergrund-Sweep ungefähr 14 Tage später. Die Kulanzfrist ermöglicht es gleichzeitigen Claude Code-Sitzungen, die bereits die alte Version geladen haben, ohne Fehler weiter zu laufen. Claude Code führt den Sweep nur aus, wenn mindestens ein Plugin installiert ist; nachdem Sie Ihr letztes Plugin deinstalliert haben, bleiben verwaiste Verzeichnisse auf der Festplatte, bis Sie ein Plugin erneut installieren.

Claude Code entfernt einen Plugin- oder Marketplace-Ordner aus dem Cache nur, wenn er kein Verzeichnis oder Symlink mehr enthält. Wenn Sie einen Entwicklungs-Checkout als Versionseinträge eines Plugins in den Cache symlinken, markiert Claude Code den Link niemals als verwaist und entfernt ihn oder die Ordner, die ihn enthalten, niemals. Claude Code schreibt auch niemals seine Versions-Tracking-Dateien in den verlinkten Checkout.

Die Glob- und Grep-Tools von Claude überspringen verwaiste Versionsverzeichnisse während Suchen, sodass Dateiergebnisse keinen veralteten Plugin-Code enthalten.

Node.js-Paketabhängigkeiten

Wenn Claude Code ein Plugin in den Cache kopiert, installiert es auch die Node.js-Paketabhängigkeiten des Plugins dort, damit die Hooks und MCP-Server des Plugins diese laden können. Dieser Abschnitt behandelt die npm- und Bun-Pakete, die ein Plugin in seiner eigenen package.json deklariert. Für Plugins, die von anderen Plugins abhängen, siehe Plugin-Abhängigkeitsversionen.

Claude Code führt die Installation im kopierten Versionsverzeichnis jedes Mal aus, wenn es eines erstellt: wenn Sie ein Plugin installieren, wenn Claude Code ein Plugin auf eine neue Version aktualisiert, und beim Sitzungsstart, wenn ein aktiviertes Plugin noch nicht zwischengespeichert ist, z. B. auf einem neuen Computer. Die Installation wird nur ausgeführt, wenn das Plugin-Stammverzeichnis sowohl eine package.json als auch eine unterstützte Sperrdatei enthält:

Sperrdatei	Befehl
`bun.lock` oder `bun.lockb`	`bun install --frozen-lockfile --ignore-scripts`
`npm-shrinkwrap.json` oder `package-lock.json`	`npm ci --ignore-scripts`

Wenn ein Plugin mehr als eine dieser Sperrdateien enthält, verwendet Claude Code die erste Übereinstimmung und prüft in dieser Reihenfolge: bun.lock, bun.lockb, npm-shrinkwrap.json, package-lock.json. Claude Code überspringt yarn.lock und pnpm-lock.yaml, da Yarn und pnpm Konfigurationshooks zur Auflösungszeit unterstützen, die --ignore-scripts umgehen.

Versenden Sie eine npm-Sperrdatei für die größtmögliche Reichweite. Claude Code führt den Paketmanager der übereinstimmenden Sperrdatei aus dem PATH des Benutzers aus und fällt nicht auf die andere Sperrdatei zurück, wenn sie fehlt. Verwenden Sie für ein Plugin, das über eine npm-Quelle verteilt wird, npm-shrinkwrap.json; npm schließt package-lock.json aus veröffentlichten Paketen aus.

Claude Code beschränkt diese Abhängigkeitsinstallation so, dass während der Installation kein Code aus dem Plugin oder seinen Paketen ausgeführt wird, und begrenzt, wie lange sie ausgeführt werden kann:

Gefrorene Auflösung: Bun und npm installieren genau das, was die Sperrdatei festlegt, und schlagen fehl, anstatt Versionen erneut aufzulösen, wenn package.json und die Sperrdatei nicht übereinstimmen.
Keine Lifecycle-Skripte: --ignore-scripts verhindert, dass preinstall-, install- und postinstall-Skripte ausgeführt werden, sodass Abhängigkeiten, die native Module in diesen Skripten erstellen, heruntergeladen, aber während dieser Installation nicht kompiliert werden.
60-Sekunden-Timeout: Claude Code stoppt eine Installation, die länger läuft, und behandelt sie als fehlgeschlagen.

Das Abrufen eines npm-Quellen-Plugins selbst führt npm install mit aktivierten Lifecycle-Skripten aus, bevor diese Abhängigkeitsinstallation ausgeführt wird.

Eine fehlgeschlagene oder übersprungene Installation blockiert das Plugin niemals. Wenn die Installation fehlschlägt oder Claude Code eine yarn- oder pnpm-Sperrdatei überspringt, wird der Grund als Warnung in der Debug-Ausgabe aufgezeichnet. Ein Plugin mit einer package.json und ohne Sperrdatei wird ohne Logeintrag übersprungen. Eine Timeout-Installation kann einen partiellen node_modules-Baum in der zwischengespeicherten Kopie hinterlassen.

Sie können die automatische Installation nicht ausschalten; keine Einstellung oder Umgebungsvariable deaktiviert sie. In eingeschränkten Netzwerken siehe die Netzwerkzugriffsanforderungen für die Hosts, die Sie zulassen müssen.

Für Abhängigkeiten, die die automatische Installation nicht bereitstellen kann, z. B. Pakete, die ihre Lifecycle-Skripte zum Erstellen benötigen, Python-Abhängigkeiten oder ein Plugin, das mit Yarn oder pnpm gesperrt ist, installieren Sie diese von einem Hook in das persistente Datenverzeichnis.

Einschränkungen bei der Pfadtraversierung

Claude Code erlaubt einem Plugin nicht, auf Dateien außerhalb seines eigenen Verzeichnisses zu verweisen. Es lehnt einen Komponentenpfad ab, der außerhalb des Plugin-Stammverzeichnisses aufgelöst wird, unabhängig davon, ob der Pfad in plugin.json oder in einem Marketplace-Eintrag deklariert ist. Dies umfasst einen Pfad, der außerhalb des Plugins verweist, wie geschrieben, z. B. ../shared-utils, und einen Symlink, der außerhalb des Plugins führt, mit Ausnahme von Links innerhalb eines Marketplace.

Wenn Claude Code einen Pfad ablehnt, meldet es einen path escapes plugin directory-Fehler und lädt das Plugin ohne diese Komponente.

Claude Code kopiert auch keine Dateien außerhalb des Plugin-Verzeichnisses in den Cache, wenn es das Plugin installiert. Wenn also ein Skript in einem kopierten Plugin einen Pfad über dem Plugin-Stammverzeichnis liest, findet es diese Dateien auch nicht.

Wenn Ihr Plugin Dateien mit anderen Teilen desselben Marketplace freigeben muss, können Sie symbolische Links in Ihrem Plugin-Verzeichnis erstellen. Wie ein Symlink behandelt wird, wenn das Plugin in den Cache kopiert wird, hängt davon ab, wo sein Ziel aufgelöst wird:

Innerhalb des eigenen Verzeichnisses des Plugins: Der Symlink wird als relativer Symlink im Cache beibehalten, sodass er zur Laufzeit weiterhin zum kopierten Ziel aufgelöst wird.
Anderswo innerhalb desselben Marketplace: Der Symlink wird dereferenziert. Der Inhalt des Ziels wird an seiner Stelle in den Cache kopiert. Dies ermöglicht es dem skills/-Verzeichnis eines Meta-Plugins, auf Skills zu verlinken, die von anderen Plugins im Marketplace definiert werden.
Außerhalb des Marketplace: Der Symlink wird aus Sicherheitsgründen übersprungen. Dies verhindert, dass Plugins beliebige Host-Dateien wie Systempfade in den Cache ziehen.

Für Plugins, die mit --plugin-dir installiert sind, von einem lokalen Pfad oder von einer command-Quelle im Copy-Modus, werden nur Symlinks beibehalten, die innerhalb des eigenen Verzeichnisses des Plugins aufgelöst werden. Alle anderen werden übersprungen.

Der folgende Befehl erstellt einen Link von innerhalb eines Marketplace-Plugins zu einem gemeinsamen Skill, der von einem Sibling-Plugin definiert wird. Verwenden Sie unter Windows mklink /D von einer erhöhten Eingabeaufforderung oder aktivieren Sie den Entwicklermodus:

ln -s ../../shared-plugin/skills/foo ./skills/foo

Verzeichnisstruktur von Plugins

Standard-Plugin-Layout

Ein vollständiges Plugin folgt dieser Struktur:

enterprise-plugin/
├── .claude-plugin/           # Metadaten-Verzeichnis (optional)
│   └── plugin.json             # Plugin-Manifest
├── skills/                   # Skills
│   ├── code-reviewer/
│   │   └── SKILL.md
│   └── pdf-processor/
│       ├── SKILL.md
│       └── scripts/
├── commands/                 # Skills als flache .md-Dateien
│   ├── status.md
│   └── logs.md
├── agents/                   # Subagent-Definitionen
│   ├── security-reviewer.md
│   ├── performance-tester.md
│   └── compliance-checker.md
├── workflows/                # Workflow-Skripte
│   └── release-audit.js
├── output-styles/            # Ausgabestil-Definitionen
│   └── terse.md
├── themes/                   # Farbschema-Definitionen
│   └── dracula.json
├── monitors/                 # Hintergrund-Monitor-Konfigurationen
│   └── monitors.json
├── hooks/                    # Hook-Konfigurationen
│   ├── hooks.json           # Haupt-Hook-Konfiguration
│   └── security-hooks.json  # Zusätzliche Hooks
├── bin/                      # Plugin-Ausführbare Dateien, die zu PATH hinzugefügt werden
│   └── my-tool               # Aufrufbar als einfacher Befehl im Bash-Tool
├── 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

Eine CLAUDE.md-Datei im Plugin-Stammverzeichnis wird nicht als Projektkontext geladen. Plugins tragen Kontext durch Skills, Agents und Hooks bei, nicht durch CLAUDE.md. Um Anweisungen bereitzustellen, die in Claudes Kontext geladen werden, platzieren Sie diese in einem Skill.

Dateistandorte-Referenz

Komponente	Standardort	Zweck
Manifest	`.claude-plugin/plugin.json`	Plugin-Metadaten und Konfiguration (optional)
Skills	`skills/`	Skills mit `<name>/SKILL.md`-Struktur
Befehle	`commands/`	Skills als flache Markdown-Dateien. Verwenden Sie `skills/` für neue Plugins
Agents	`agents/`	Subagent-Markdown-Dateien
Workflows	`workflows/`	Workflow-Skriptdateien
Ausgabestile	`output-styles/`	Ausgabestil-Definitionen
Designs	`themes/`	Farbschema-Definitionen
Hooks	`hooks/hooks.json`	Hook-Konfiguration
MCP-Server	`.mcp.json`	MCP-Server-Definitionen
LSP-Server	`.lsp.json`	Language-Server-Konfigurationen
Monitore	`monitors/monitors.json`	Hintergrund-Monitor-Konfigurationen
Ausführbare Dateien	`bin/`	Ausführbare Dateien, die zum `PATH` des Bash-Tools hinzugefügt werden und als einfache Befehle aufrufbar sind, während das Plugin aktiviert ist. Sie können dieses Verzeichnis nicht in ein Plugin einbeziehen, das Sie über die Organisationseinstellungen von claude.ai verteilen
Einstellungen	`settings.json`	Standardkonfiguration, die angewendet wird, wenn das Plugin aktiviert ist. Nur die `agent`- und `subagentStatusLine`-Schlüssel werden unterstützt

CLI-Befehle – Referenz

Claude Code bietet CLI-Befehle für nicht-interaktive Plugin-Verwaltung, nützlich für Skripte und Automatisierung.

plugin init

Gerüst für ein neues Plugin unter ~/.claude/skills/<name>/ erstellen. In der nächsten Claude Code-Sitzung wird es automatisch als <name>@skills-dir geladen und erscheint in /plugin und claude plugin list ohne Installationsschritt.

Siehe Skills-directory plugins für Umfang und Vertrauensanforderungen.

claude plugin init <name> [options]

Argumente:

<name>: Plugin-Name. Wird zum Skill-Namespace und zum Verzeichnisnamen unter ~/.claude/skills/, daher darf er keine Leerzeichen oder Pfad-Trennzeichen enthalten.

Optionen:

Option	Beschreibung	Standard
`--description <text>`	Manifest-Beschreibung
`--author <name>`	Autorname	`git config user.name`
`--author-email <email>`	Autor-E-Mail	`git config user.email`
`--with <components...>`	Auch Komponentenordner gerüsten. Gültige Werte: `skills`, `agents`, `hooks`, `mcp`, `lsp`, `output-style`, `channel`
`-f, --force`	Vorhandenes `.claude-plugin/` am Ziel überschreiben
`-h, --help`	Hilfe für Befehl anzeigen

Aliase: new

Jeder --with-Wert fügt eine Starter-Datei für diese Komponente hinzu, bereit zum Bearbeiten:

Komponente	Was es gerüstet
`skills`	Ein zusätzlicher Namespace-Skill `<name>:example` neben dem Standard-Skill
`agents`	Eine `agents/`-Subagent-Definition
`hooks`	Eine `hooks/hooks.json` mit einem Beispiel-Event-Handler
`mcp`	Eine `.mcp.json` mit HTTP- und Stdio-Server-Beispielen
`lsp`	Ein `.lsp.json`-Language-Server-Beispiel
`output-style`	Ein `output-styles/<name>.md`, das automatisch angewendet wird, während das Plugin aktiviert ist
`channel`	Ein MCP-basierter channel: ein Stdio-Server (`server.ts`), seine `.mcp.json` und eine `package.json`

Das gerüstete Plugin verwendet die @skills-dir-Quelle statt eines Marketplace. Administratoren können diese Quelle mit strictKnownMarketplaces blockieren oder indem sie {"source": "skills-dir"} zu blockedMarketplaces in managed settings hinzufügen. Wenn blockiert, schlägt plugin init fehl, bevor etwas geschrieben wird.

Beispiele:

# Minimales Plugin gerüsten
claude plugin init my-helper

# Mit Skill- und Hook-Ordnern gerüsten
claude plugin init my-helper --with skills hooks

# Vorhandenes Gerüst überschreiben
claude plugin init my-helper --force

plugin install

Ein Plugin aus verfügbaren Marketplaces installieren.

claude plugin install <plugin> [options]

Argumente:

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

Optionen:

Option	Beschreibung	Standard
`-s, --scope <scope>`	Installationsumfang: `user`, `project` oder `local`	`user`
`--config <key=value>`	Setzen Sie eine `userConfig`-Option, die im Plugin-Manifest deklariert ist. Wiederholen Sie das Flag, um mehrere Optionen zu setzen
`-y, --yes`	Akzeptieren Sie einen Befehl, den der Marketplace des Plugins deklariert, ohne die Bestätigungsaufforderung: den Befehl, der ein Plugin mit einer `command`-Quelle erzeugt, oder den `headersHelper`, der einen Archiv-Download authentifiziert. Das Akzeptieren eines `headersHelper` erfordert Claude Code v2.1.238 oder später. Claude Code druckt den Befehl trotzdem zuerst. Erforderlich, wenn stdin oder stdout kein TTY ist. Hat keine Auswirkung innerhalb einer Claude Code-Sitzung, daher führen Sie den Befehl von Ihrem eigenen Terminal aus
`-h, --help`	Hilfe für Befehl anzeigen

Der Umfang bestimmt, welche Einstellungsdatei das installierte Plugin hinzugefügt wird. Beispielsweise schreibt --scope project zu enabledPlugins in .claude/settings.json, wodurch das Plugin für alle verfügbar wird, die das Projekt-Repository klonen.

Beispiele:

# Im Benutzerumfang installieren (Standard)
claude plugin install formatter@my-marketplace

# Im Projektumfang installieren (mit Team geteilt)
claude plugin install formatter@my-marketplace --scope project

# Im lokalen Umfang installieren (nicht mit Team geteilt)
claude plugin install formatter@my-marketplace --scope local

plugin uninstall

Ein installiertes Plugin entfernen.

claude plugin uninstall <plugin> [options]

Argumente:

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

Optionen:

Option	Beschreibung	Standard
`-s, --scope <scope>`	Aus Umfang deinstallieren: `user`, `project` oder `local`	`user`
`--keep-data`	Das persistent data directory des Plugins beibehalten
`--prune`	Auch automatisch installierte Abhängigkeiten entfernen, die kein anderes Plugin benötigt. Siehe plugin prune
`-y, --yes`	Bestätigungsaufforderung für `--prune` überspringen. Erforderlich, wenn stdin oder stdout kein TTY ist
`-h, --help`	Hilfe für Befehl anzeigen

Aliase: remove, rm

Standardmäßig werden beim Deinstallieren aus dem letzten verbleibenden Umfang auch das ${CLAUDE_PLUGIN_DATA}-Verzeichnis des Plugins gelöscht. Verwenden Sie --keep-data, um es zu bewahren, beispielsweise beim Neuinstallieren nach dem Testen einer neuen Version.

plugin prune

Automatisch installierte Plugin-Abhängigkeiten entfernen, die nicht mehr von einem installierten Plugin benötigt werden. Abhängigkeiten, die Claude Code eingezogen hat, um das dependencies-Feld eines anderen Plugins zu erfüllen, werden entfernt; Plugins, die Sie direkt installiert haben, werden nie berührt.

claude plugin prune [options]

Optionen:

Option	Beschreibung	Standard
`-s, --scope <scope>`	Im Umfang bereinigen: `user`, `project` oder `local`	`user`
`--dry-run`	Auflisten, was entfernt würde, ohne etwas zu entfernen
`-y, --yes`	Bestätigungsaufforderung überspringen. Erforderlich, wenn stdin oder stdout kein TTY ist
`-h, --help`	Hilfe für Befehl anzeigen

Aliase: autoremove

Der Befehl listet verwaiste Abhängigkeiten auf und fragt vor dem Entfernen um Bestätigung. Um ein Plugin zu entfernen und seine Abhängigkeiten in einem Schritt zu bereinigen, führen Sie claude plugin uninstall <plugin> --prune aus.

plugin enable

Ein deaktiviertes Plugin aktivieren. Wenn das Ziel aus einem Marketplace installiert ist und Abhängigkeiten deklariert, aktiviert Claude Code diese transitiv im gleichen Umfang. Der Befehl schlägt unter den Bedingungen fehl, die Enable or disable a plugin with dependencies auflistet.

claude plugin enable <plugin> [options]

Argumente:

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

Optionen:

Option	Beschreibung	Standard
`-s, --scope <scope>`	Umfang zum Aktivieren: `user`, `project` oder `local`. Wenn weggelassen, erkennt Claude Code den Umfang, in dem das Plugin installiert ist	Automatische Erkennung
`-h, --help`	Hilfe für Befehl anzeigen

plugin disable

Ein Plugin deaktivieren, ohne es zu deinstallieren. Wenn das Ziel aus einem Marketplace installiert ist, schlägt der Befehl fehl, wenn ein anderes aktiviertes Plugin davon abhängt. Die Fehlermeldung enthält einen verketteten Befehl, der zuerst alle abhängigen Plugins deaktiviert.

claude plugin disable [plugin] [options]

Argumente:

[plugin]: Plugin-Name oder plugin-name@marketplace-name. Optional bei Verwendung von --all

Optionen:

Option	Beschreibung	Standard
`-a, --all`	Alle aktivierten Plugins deaktivieren. Kann nicht mit `--scope` kombiniert werden
`-s, --scope <scope>`	Umfang zum Deaktivieren: `user`, `project` oder `local`. Wenn weggelassen, erkennt Claude Code den Umfang, in dem das Plugin installiert ist	Automatische Erkennung
`-h, --help`	Hilfe für Befehl anzeigen

plugin update

Ein Plugin auf die neueste Version aktualisieren.

claude plugin update <plugin> [options]

Argumente:

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

Optionen:

Option	Beschreibung	Standard
`-s, --scope <scope>`	Umfang zum Aktualisieren: `user`, `project`, `local` oder `managed`	`user`
`-y, --yes`	Akzeptieren Sie einen Befehl, den der Marketplace des Plugins deklariert, ohne die Bestätigungsaufforderung: den Befehl, der ein Plugin mit einer `command`-Quelle erzeugt, oder den `headersHelper`, der einen Archiv-Download authentifiziert. Das Akzeptieren eines `headersHelper` erfordert Claude Code v2.1.238 oder später. Claude Code druckt den Befehl trotzdem zuerst. Erforderlich, wenn stdin oder stdout kein TTY ist. Hat keine Auswirkung innerhalb einer Claude Code-Sitzung, daher führen Sie den Befehl von Ihrem eigenen Terminal aus
`-h, --help`	Hilfe für Befehl anzeigen

plugin list

Installierte Plugins mit ihrer Version, Quell-Marketplace und Aktivierungsstatus auflisten.

claude plugin list [options]

Optionen:

Option	Beschreibung	Standard
`--json`	Ausgabe als JSON
`--available`	Verfügbare Plugins aus Marketplaces einschließen. Erfordert `--json`
`-h, --help`	Hilfe für Befehl anzeigen

Innerhalb einer interaktiven Sitzung druckt /plugin list eine ähnliche Auflistung inline, aber sie umfasst nur Marketplace-installierte Plugins:

Plugins, die aus Skills-Verzeichnissen geladen werden, erscheinen in der /plugin-Schnittstelle und in claude plugin list, aber nicht in der Inline-Ausgabe /plugin list.
Auf Claude Code v2.1.239 oder später erscheinen Plugins, die von claude.ai synchronisiert werden, in claude plugin list, wenn Sie es in der Umgebung ausführen, in der eine synchronisierte Sitzung sie heruntergeladen hat. Sie erscheinen nicht in der Inline-Ausgabe /plugin list.
Plugins, die für die Sitzung mit --plugin-dir oder --plugin-url geladen werden, erscheinen in der /plugin-Schnittstelle und in claude plugin list nur, wenn das gleiche Flag dem Unterbefehl vorangeht, wie in claude --plugin-dir <dir> plugin list. Nur das Flag benennt ihren Standort, daher kann ein einfaches claude plugin list sie nicht finden, anders als synchronisierte Plugins und Skills-Directory-Plugins, deren feste Verzeichnisse Claude Code scannt.

Die interaktive Form akzeptiert --enabled oder --disabled, um nur Plugins in diesem Zustand anzuzeigen, und ls als Kurzform für list.

plugin details

Zeigen Sie das Komponenten-Inventar eines Plugins und die geschätzte Token-Kosten an. Die Ausgabe listet alle Komponenten auf, die das Plugin beiträgt, gruppiert als Skills, Agents, Hooks, MCP-Server und LSP-Server, zusammen mit einer Schätzung, wie viele Token es jeder Sitzung hinzufügt. Die Skills-Gruppe umfasst sowohl skills/- als auch commands/-Einträge.

claude plugin details <name>

Argumente:

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

Optionen:

Option	Beschreibung	Standard
`-h, --help`	Hilfe für Befehl anzeigen

Die Ausgabe zeigt zwei Kostenzahlen für jede Komponente:

Always-on: Token, die jeder Sitzung durch den Auflistungstext des Plugins hinzugefügt werden, wie Skill-Beschreibungen, Agent-Beschreibungen und Befehlsnamen, unabhängig davon, ob eine Komponente ausgelöst wird.
On-invoke: Token, die eine Komponente kostet, wenn sie ausgelöst wird. Wird pro Komponente angezeigt, nicht als Plugin-Gesamtsumme, da eine typische Sitzung nur eine Teilmenge von Komponenten aufruft.

Dieses Beispiel zeigt, wie die Ausgabe für ein Plugin mit zwei Skills aussieht:

dependency-guard 1.2.0
  Dependency analysis for Claude Code sessions
  Source: dependency-guard@example-marketplace

Component inventory
  Skills (2)  scan-dependencies, review-changes
  Agents (0)
  Hooks (1)  SessionStart  (harness-only — no model context cost)
  MCP servers (0)
  LSP servers (0)

Projected token cost
  Always-on:   ~180 tok   added to every session

Per-component (rounded)
  component            always-on  on-invoke
  scan-dependencies        ~100      ~2400
  review-changes            ~80      ~1800

  On-invoke cost is paid each time a skill or agent fires.
  Token counts are estimates and may differ from actual usage.

Die Always-on-Gesamtsumme wird über die count_tokens-API für Ihr aktives Modell berechnet. Pro-Komponenten-Zahlen werden proportional von dieser Gesamtsumme skaliert. Wenn die API nicht erreichbar ist, greift der Befehl auf eine zeichenbasierte Schätzung zurück.

plugin validate

Überprüfen Sie ein Plugin oder einen Marketplace auf Syntax- und Schema-Fehler, bevor Sie veröffentlichen.

Der Befehl beendet sich mit 0, wenn die Validierung erfolgreich ist, mit 1, wenn sie fehlschlägt, und mit 2, wenn der Validierungslauf selbst fehlschlägt, z. B. wenn der übergebene Pfad nicht lesbar ist.

claude plugin validate <path> [options]

Argumente:

<path>: Pfad zu einem Plugin-Verzeichnis oder einem Marketplace-Verzeichnis. Siehe Validate a plugin or a directory without a manifest für die Dateien, die ein Plugin-Lauf abdeckt.

Optionen:

Option	Beschreibung	Standard
`--strict`	Warnungen als Fehler behandeln und mit 1 beenden. Verwenden Sie in CI, um Probleme zu erfassen, die die Laufzeit toleriert, wie unrecognized fields
`--json`	Geben Sie den Validierungsbericht als ein JSON-Objekt aus mit den gleichen Exit-Codes. Erfordert Claude Code v2.1.259 oder später
`-h, --help`	Hilfe für Befehl anzeigen

Mit --json schreibt Claude Code den Bericht auf stdout als ein JSON-Objekt mit diesen Top-Level-Feldern:

success: das gleiche Urteil, das der Exit-Code gibt
strict: ob der Lauf Warnungen als Fehler behandelt hat
target: der aufgelöste Pfad, den Claude Code validiert hat
manifest: das eigene Ergebnis des Manifests oder null für einen Lauf ohne Manifest
contents: Pro-Datei-Ergebnisse, jede benannt nach ihrer file und mit errors-, warnings- und notes-Arrays

Bei Exit 2 schreibt der Befehl nichts auf stdout; die Fehlermeldung geht auf stderr.

Innerhalb einer interaktiven Sitzung führt /plugin validate <path> die gleichen Überprüfungen inline aus.

plugin tag

Erstellen Sie ein Release-Git-Tag für ein Plugin. Standardmäßig taggt der Befehl das Plugin im aktuellen Verzeichnis; übergeben Sie einen Pfad, um ein Plugin an anderer Stelle zu taggen. Siehe Tag plugin releases.

claude plugin tag [path] [options]

Argumente:

[path]: Pfad zum Plugin-Verzeichnis. Standardmäßig das aktuelle Verzeichnis.

Optionen:

Option	Beschreibung	Standard
`--push`	Das Tag nach dem Erstellen zum Remote pushen
`--dry-run`	Drucken Sie, was getaggt würde, ohne das Tag zu erstellen
`-f, --force`	Das Tag erstellen, auch wenn der Working Tree schmutzig ist oder das Tag bereits existiert
`-m, --message <msg>`	Tag-Anmerkungsnachricht. Verwenden Sie `%s` als Platzhalter für die Version
`--remote <name>`	Remote zum Pushen mit `--push`	`origin`
`-h, --help`	Hilfe für Befehl anzeigen

Debugging- und Entwicklungstools

Debugging-Befehle

Verwenden Sie claude --debug, um Details zum Laden von Plugins anzuzeigen:

Dies zeigt:

Welche Plugins geladen werden
Alle Fehler in Plugin-Manifesten
Registrierung von Skills, Agents und Hooks
MCP-Server-Initialisierung

Häufige Probleme

Problem	Ursache	Lösung
Plugin wird nicht geladen	Ungültige `plugin.json`	Führen Sie `claude plugin validate ./my-plugin` oder `/plugin validate ./my-plugin` aus, wobei `./my-plugin` Ihr Plugin-Verzeichnis ist, um `plugin.json`, `hooks/hooks.json` und die Frontmatter der Skills, Agents und Commands in den Standard-Verzeichnissen des Plugins auf Syntax- und Schema-Fehler zu überprüfen. Siehe Plugin oder Verzeichnis ohne Manifest validieren, um zu erfahren, was eine Ausführung abdeckt
Skills werden nicht angezeigt	Falsche Verzeichnisstruktur	Stellen Sie sicher, dass `skills/` oder `commands/` sich im Plugin-Root befindet, nicht in `.claude-plugin/`
Hooks werden nicht ausgelöst	Skript ist 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	Machen Sie Pfade relativ, beginnend mit `./`; siehe Pfad-Verhaltensregeln, die die `"."` Ausnahme des `skills`-Feldes abdecken
LSP `Executable not found in $PATH`	Language Server nicht installiert	Installieren Sie die Binärdatei (z. B. `npm install -g typescript-language-server typescript`)

Beispiel-Fehlermeldungen

Manifest-Validierungsfehler:

Invalid JSON syntax: Unexpected token } in JSON at position 142: Überprüfen Sie auf fehlende Kommas, zusätzliche Kommas oder nicht in Anführungszeichen gesetzte Strings
Plugin <name> has an invalid manifest file at .claude-plugin/plugin.json. Validation errors: name: Invalid input: expected string, received undefined: Ein erforderliches Feld fehlt
Plugin <name> has a corrupt manifest file at .claude-plugin/plugin.json. JSON parse error: ...: JSON-Syntaxfehler. Vor v2.1.246 erzeugte Claude Code diesen Fehler auch für eine plugin.json, die als UTF-8 mit einer führenden Byte-Order-Mark (BOM) gespeichert wurde, selbst wenn das JSON ansonsten gültig war.

Plugin-Ladefehler:

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 vorhandenes 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 Marketplace-Eintrag

Hook-Fehlerbehebung

Hook-Skript wird nicht ausgeführt:

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

Hook wird bei erwarteten Ereignissen nicht ausgelöst:

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

MCP-Server-Fehlerbehebung

Server startet nicht:

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

Server-Tools werden nicht angezeigt:

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

Fehler in der Verzeichnisstruktur

Symptome: Plugin wird geladen, aber Komponenten (Skills, Agents, Hooks) fehlen.

Korrekte Struktur: Komponenten müssen sich im Plugin-Root befinden, nicht in .claude-plugin/. Nur plugin.json gehört in .claude-plugin/.

Debug-Checkliste:

Führen Sie claude --debug aus und suchen Sie nach „loading plugin"-Meldungen
Überprüfen Sie, dass jedes Komponenten-Verzeichnis in der Debug-Ausgabe aufgelistet ist
Überprüfen Sie, dass Dateiberechtigungen das Lesen der Plugin-Dateien ermöglichen

Verteilungs- und Versionierungsreferenz

Versionsverwaltung

Claude Code verwendet die Version des Plugins als Cache-Schlüssel, der bestimmt, ob ein Update verfügbar ist. Wenn Sie /plugin update ausführen oder Auto-Update aktiviert ist, berechnet Claude Code die aktuelle Version und überspringt das Update, wenn sie mit der bereits installierten Version übereinstimmt.

Für jeden Quellentyp außer command löst Claude Code die Version aus dem ersten dieser Punkte auf, der gesetzt ist:

Das Feld version in der plugin.json des Plugins
Das Feld version im Marketplace-Eintrag des Plugins in marketplace.json
Der Git-Commit-SHA des Plugin-Quellcodes für github, url, git-subdir und relative-path-Quellen in einem Git-gehosteten Marketplace
Der SHA-256-Digest für archive-Quellen: der sha256-Pin im Marketplace-Eintrag oder der Digest der heruntergeladenen Datei, wenn Sie keinen Pin setzen. Claude Code kürzt ihn auf die ersten 12 Zeichen
unknown für npm-Quellen oder lokale Verzeichnisse, die sich nicht in einem Git-Repository befinden

Für eine command-Quelle leitet Claude Code die Version immer aus dem ab, was der Befehl produziert: einen 12-stelligen Content-Hash allein oder an die plugin.json-Version als <version>-<hash> angehängt, wenn einer gesetzt ist. Claude Code ignoriert das Feld version des Marketplace-Eintrags für Command-Quellen. Ein Befehl, dessen gehashte Ausgabe sich ändert, produziert daher eine neue Version, auch wenn die verfasste Versionsnummer gleich bleibt. Im Link-Modus deckt der Hash den echten Pfad des gedruckten Verzeichnisses und seine Einträge auf oberster Ebene ab, anstatt der Dateiinhalte.

Für diese Quellentypen gibt es drei Möglichkeiten, ein Plugin zu versionieren:

Ansatz	Wie	Update-Verhalten	Am besten für
Explizite Version	Setzen Sie `"version": "2.1.0"` in `plugin.json`	Benutzer erhalten Updates nur, wenn Sie dieses Feld erhöhen. Das Pushen neuer Commits ohne Erhöhung hat keine Auswirkung, und `/plugin update` meldet „bereits auf der neuesten Version".	Veröffentlichte Plugins mit stabilen Release-Zyklen
Commit-SHA-Version	Lassen Sie `version` sowohl in `plugin.json` als auch im Marketplace-Eintrag weg	Benutzer erhalten Updates, wenn sich der aufgelöste Commit der Quelle ändert	Interne oder Team-Plugins unter aktiver Entwicklung
Digest-Version	Verwenden Sie eine `archive`-Quelle und lassen Sie `version` sowohl in `plugin.json` als auch im Marketplace-Eintrag weg	Mit einem `sha256`-Pin erhalten Benutzer Updates, wenn Sie den Pin ändern. Ohne einen erhalten Benutzer Updates, wenn sich die Bytes der gehosteten ZIP-Datei ändern	Plugins, die als ZIP-Dateien auf einem statischen Server oder in einem Artefakt-Repository veröffentlicht werden

Wenn Sie explizite Versionen verwenden, folgen Sie semantischer Versionierung (MAJOR.MINOR.PATCH): erhöhen Sie MAJOR für Breaking Changes, MINOR für neue Funktionen, PATCH für Bugfixes. Dokumentieren Sie Änderungen in einer CHANGELOG.md.

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

plugins-reference.md +431 −310

10 Möchten Sie Plugins installieren? Siehe [Plugins entdecken und installieren](/docs/de/discover-plugins). Zum Erstellen von Plugins siehe [Plugins](/docs/de/plugins). Zum Verteilen von Plugins siehe [Plugin-Marktplätze](/docs/de/plugin-marketplaces).10 Möchten Sie Plugins installieren? Siehe [Plugins entdecken und installieren](/docs/de/discover-plugins). Zum Erstellen von Plugins siehe [Plugins](/docs/de/plugins). Zum Verteilen von Plugins siehe [Plugin-Marktplätze](/docs/de/plugin-marketplaces).

11</Tip>11</Tip>

12 12

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

15Ein **Plugin** ist ein eigenständiges Verzeichnis von Komponenten, das Claude Code mit benutzerdefinierten Funktionen erweitert. Plugin-Komponenten umfassen Skills, Agents, Hooks, MCP-Server, LSP-Server und Monitore.13Ein **Plugin** ist ein eigenständiges Verzeichnis von Komponenten, das Claude Code mit benutzerdefinierten Funktionen erweitert. Plugin-Komponenten umfassen Skills, Agents, Hooks, MCP-Server, LSP-Server und Monitore.

16 14

17<h2 id="plugin-components-reference">15<h2 id="plugin-components-reference">

~~18 Plugin-Komponenten-Referenz~~16 Referenz für Plugin-Komponenten

19</h2>17</h2>

20 18

21<h3 id="skills">19<h3 id="skills">

22 Skills20 Skills

23</h3>21</h3>

24 22

~~25Plugins fügen Skills zu Claude Code hinzu und erstellen `/name` Verknüpfungen, die Sie oder Claude aufrufen können.~~23Plugins fügen Claude Code Skills hinzu und erstellen `/name` Shortcuts, die Sie oder Claude aufrufen können.

26 24

~~27**Speicherort**: `skills/` oder `commands/` Verzeichnis im Plugin-Root, oder eine einzelne `SKILL.md` Datei im Plugin-Root~~25**Speicherort**: `skills/` oder `commands/` Verzeichnis im Plugin-Root oder eine einzelne `SKILL.md` Datei im Plugin-Root

28 26

~~29**Dateiformat**: Skills sind Verzeichnisse mit `SKILL.md`; Befehle sind einfache Markdown-Dateien~~27**Dateiformat**: Skills sind Verzeichnisse mit `SKILL.md`; Commands sind einfache Markdown-Dateien

30 28

31**Skill-Struktur**:29**Skill-Struktur**:

32 30

40 └── SKILL.md38 └── SKILL.md

41```39```

42 40

~~43**Integrationverhalten**:~~41Skills und Commands werden automatisch erkannt, wenn das Plugin installiert wird.

44 42

~~45* Skills und Befehle werden automatisch erkannt, wenn das Plugin installiert wird~~43Wenn ein Plugin kein `skills/` Verzeichnis und kein `skills` Manifest-Feld hat, wird eine `SKILL.md` im Plugin-Root als einzelner Skill geladen. Setzen Sie das Frontmatter-Feld `name`, um den Aufrufen-Namen des Skills zu steuern. Ohne dieses Feld greift Claude Code auf den Installationsverzeichnisnamen zurück, der bei Marketplace-installierten Plugins ein Versionsstring ist, der sich bei jedem Update ändert. Für Plugins, die mehr als einen Skill bereitstellen, verwenden Sie das oben gezeigte `skills/` Verzeichnis-Layout.

~~46* Claude kann sie automatisch basierend auf dem Task-Kontext aufrufen~~

~~47* Skills können unterstützende Dateien neben SKILL.md enthalten~~

48 44

49Wenn ein Plugin kein `skills/` Verzeichnis und kein `skills` Manifest-Feld hat, wird eine `SKILL.md` im Plugin-Root als einzelner Skill geladen. Setzen Sie das Frontmatter-Feld `name`, um den Aufrufen-Namen des Skills zu steuern. Ohne dieses Feld greift Claude Code auf den Installationsverzeichnisnamen zurück, der bei vom Marktplatz installierten Plugins ein Versionsstring ist, der sich bei jedem Update ändert. Für Plugins, die mehr als einen Skill versenden, verwenden Sie das oben gezeigte `skills/` Verzeichnis-Layout.45In Plugin-Skills und Commands akzeptieren Boolean-Frontmatter-Felder wie `disable-model-invocation` `yes`, `no`, `on`, `off`, `1` und `0` in beliebiger Schreibweise zusätzlich zu `true` und `false`. Vor v2.1.218 erkannte Claude Code nur `true` und `false`.

50 46

51Vollständige Details finden Sie unter [Skills](/docs/de/skills).47Vollständige Details finden Sie unter [Skills](/docs/de/skills).

52 48

72disallowedTools: Write, Edit68disallowedTools: Write, Edit

73---69---

74 70

~~75Detailliertes System-Prompt für den Agent, das seine Rolle, Expertise und sein Verhalten beschreibt.~~71Detaillierte Systemaufforderung für den Agent, die seine Rolle, Expertise und sein Verhalten beschreibt.

76```72```

77 73

78Plugin-Agents unterstützen `name`, `description`, `model`, `effort`, `maxTurns`, `tools`, `disallowedTools`, `skills`, `memory`, `background` und `isolation` Frontmatter-Felder. Der einzige gültige `isolation` Wert ist `"worktree"`. Aus Sicherheitsgründen werden `hooks`, `mcpServers` und `permissionMode` für von Plugins bereitgestellte Agents nicht unterstützt.74Plugin-Agents unterstützen die Frontmatter-Felder `name`, `description`, `model`, `effort`, `maxTurns`, `tools`, `disallowedTools`, `skills`, `memory`, `background` und `isolation`. Der einzige gültige `isolation` Wert ist `"worktree"`. Aus Sicherheitsgründen werden `hooks`, `mcpServers` und `permissionMode` für von Plugins bereitgestellte Agents nicht unterstützt.

76Claude Code lädt einen Plugin-Agent auch dann, wenn sein Frontmatter kein `name` Feld hat oder nicht geparst werden kann:

78* Kein `name`: Claude Code benennt den Agent nach der Datei, also wird `agents/reviewer.md` in einem Plugin namens `my-plugin` als `my-plugin:reviewer` geladen

79* Frontmatter, das nicht geparst werden kann: Claude Code benennt den Agent nach der Datei, verwendet `Agent from my-plugin plugin` als Beschreibung und ignoriert jedes Feld in der Datei

79 80

~~80**Integrationspunkte**:~~81Im Gegensatz dazu überspringt Claude Code eine Projekt-, Benutzer- oder verwaltete Agent-Datei, deren Frontmatter kein `name` Feld hat oder nicht geparst werden kann.

81 82

~~82* Agents erscheinen in der [@-mention Typeahead](/docs/de/sub-agents#invoke-subagents-explicitly) unter ihrem scoped Namen, wie `my-plugin:code-reviewer`, sobald das Plugin aktiviert ist~~83Um Dateien im Standard-`agents/` Verzeichnis eines Plugins zu finden, deren Frontmatter nicht geparst werden kann, führen Sie `claude plugin validate` aus. Der Pfad, den Sie übergeben, hängt davon ab, ob das Plugin ein Manifest hat, und beide Beispiele verwenden `./my-plugin` als Plugin-Verzeichnis:

~~83* Claude kann Agents automatisch basierend auf dem Task-Kontext aufrufen~~84

~~84* Agents können manuell von Benutzern aufgerufen werden~~85* Ein Plugin mit Manifest: `claude plugin validate ./my-plugin`

~~85* Plugin-Agents funktionieren neben integrierten Claude-Agents~~86* Ein Plugin ohne Manifest: `claude plugin validate ./my-plugin/agents`. Erfordert Claude Code v2.1.233 oder später.

88Agents erscheinen in der [@-Mention Typeahead](/docs/de/sub-agents#invoke-subagents-explicitly) unter ihrem scoped Namen, wie `my-plugin:code-reviewer`, sobald das Plugin aktiviert ist.

86 89

87Vollständige Details finden Sie unter [Subagents](/docs/de/sub-agents).90Vollständige Details finden Sie unter [Subagents](/docs/de/sub-agents).

88 91

156 159

157**Hook-Typen**:160**Hook-Typen**:

158 161

159* `command`: Shell-Befehle oder Skripte ausführen162* `command`: Shell-Commands oder Scripts ausführen

160* `http`: Das Event JSON als POST-Anfrage an eine URL senden163* `http`: Das Event-JSON als POST-Request an eine URL senden

161* `mcp_tool`: Ein Tool auf einem konfigurierten [MCP-Server](/docs/de/mcp) aufrufen164* `mcp_tool`: Ein Tool auf einem konfigurierten [MCP Server](/docs/de/mcp) aufrufen

162* `prompt`: Ein Prompt mit einem LLM evaluieren (verwendet `$ARGUMENTS` Platzhalter für Kontext)165* `prompt`: Eine Aufforderung mit einem LLM evaluieren (verwendet `$ARGUMENTS` Platzhalter für Kontext)

163* `agent`: Einen agentic Verifier mit Tools für komplexe Verifikationsaufgaben ausführen166* `agent`: Einen agentic Verifier mit Tools für komplexe Verifikationsaufgaben ausführen

164 167

165Hooks, die auf den eigenen [gebündelten MCP-Server](#mcp-servers) des Plugins abzielen, müssen seine scoped Namen verwenden. Tool-Matcher und `if` Felder verwenden den scoped Tool-Namen `mcp__plugin_<plugin-name>_<server-name>__<tool>`, und das `mcp_tool` Hook-Feld `server` verwendet `plugin:<plugin-name>:<server-name>`. Ein Matcher, der gegen den bloßen Server-Schlüssel geschrieben wird, wird nie ausgelöst. Siehe [Match MCP tools](/docs/de/hooks#match-mcp-tools) und [Plugin-bereitgestellte MCP-Server](/docs/de/mcp#plugin-provided-mcp-servers).168Hooks, die auf den eigenen [gebündelten MCP Server](#mcp-servers) des Plugins abzielen, müssen seine scoped Namen verwenden. Tool-Matcher und `if` Felder verwenden den scoped Tool-Namen `mcp__plugin_<plugin-name>_<server-name>__<tool>`, und das `server` Feld eines `mcp_tool` Hooks verwendet `plugin:<plugin-name>:<server-name>`. Ein Matcher, der gegen den bloßen Server-Schlüssel geschrieben wird, wird nie ausgelöst. Siehe [Match MCP tools](/docs/de/hooks#match-mcp-tools) und [Plugin-bereitgestellte MCP Server](/docs/de/mcp#plugin-provided-mcp-servers).

166 169

167<h3 id="mcp-servers">170<h3 id="mcp-servers">

168 MCP-Server171 MCP servers

169</h3>172</h3>

170 173

171Plugins können Model Context Protocol (MCP) Server bündeln, um Claude Code mit externen Tools und Services zu verbinden.174Plugins können Model Context Protocol (MCP) Server bündeln, um Claude Code mit externen Tools und Services zu verbinden.

172 175

173**Speicherort**: `.mcp.json` im Plugin-Root oder inline in plugin.json176**Speicherort**: `.mcp.json` im Plugin-Root oder inline in plugin.json

174 177

175**Format**: Standard MCP-Server-Konfiguration178**Format**: Standard MCP Server-Konfiguration

176 179

177**MCP-Server-Konfiguration**:180**MCP Server-Konfiguration**:

178 181

179```json theme={null}182```json theme={null}

180{183{

194}197}

195```198```

196 199

197**Integrationverhalten**:200**Integrations-Verhalten**:

198 201

199* Plugin MCP-Server starten automatisch, wenn das Plugin aktiviert wird202* Plugin MCP Server starten automatisch, wenn das Plugin aktiviert ist

200* Server erscheinen als Standard MCP-Tools in Claudes Toolkit203* Server erscheinen als Standard MCP Tools in Claudes Toolkit

201* Server-Fähigkeiten integrieren sich nahtlos mit Claudes vorhandenen Tools204* Plugin Server können unabhängig von Benutzer MCP Servern konfiguriert werden

202* Plugin-Server können unabhängig von Benutzer MCP-Servern konfiguriert werden205* Wenn Sie [`/reload-plugins`](/docs/de/discover-plugins#apply-plugin-changes-without-restarting) während einer Session ausführen, behält Claude Code die Live-Verbindungen von Servern bei, deren Konfiguration unverändert ist

203 206

204<h3 id="lsp-servers">207<h3 id="lsp-servers">

205 LSP-Server208 LSP servers

206</h3>209</h3>

207 210

208<Tip>211<Tip>

209 Möchten Sie LSP-Plugins verwenden? Installieren Sie sie vom offiziellen Marktplatz: Suchen Sie nach „lsp" im `/plugin` Discover-Tab. Dieser Abschnitt dokumentiert, wie Sie LSP-Plugins für Sprachen erstellen, die nicht vom offiziellen Marktplatz abgedeckt werden.212 Möchten Sie LSP Plugins verwenden? Installieren Sie diese aus dem offiziellen Marketplace: Suchen Sie nach "lsp" im `/plugin` Discover Tab. Dieser Abschnitt dokumentiert, wie Sie LSP Plugins für Sprachen erstellen, die nicht vom offiziellen Marketplace abgedeckt werden.

210</Tip>213</Tip>

211 214

212Plugins können [Language Server Protocol](https://microsoft.github.io/language-server-protocol/) (LSP) Server bereitstellen, um Claude Echtzeit-Code-Intelligenz beim Arbeiten an Ihrer Codebasis zu geben.215Plugins können [Language Server Protocol](https://microsoft.github.io/language-server-protocol/) (LSP) Server bereitstellen, um Claude [Echtzeit-Code-Intelligenz](/docs/de/discover-plugins#code-intelligence) beim Arbeiten an Ihrer Codebasis zu geben.

~~213~~

214LSP-Integration bietet:

~~215~~

216* **Sofortige Diagnose**: Claude sieht Fehler und Warnungen sofort nach jeder Bearbeitung

217* **Code-Navigation**: Gehe zu Definition, finde Referenzen und Hover-Informationen

218* **Sprachbewusstsein**: Typinformationen und Dokumentation für Code-Symbole

219 216

220**Speicherort**: `.lsp.json` im Plugin-Root oder inline in `plugin.json`217**Speicherort**: `.lsp.json` im Plugin-Root oder inline in `plugin.json`

221 218

262**Optionale Felder:**259**Optionale Felder:**

263 260

264| Feld | Beschreibung |261| Feld | Beschreibung |

265| :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |262| :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

267| `transport` | Kommunikationstransport: `stdio` (Standard) oder `socket` |264| `transport` | Kommunikations-Transport: `stdio` (Standard) oder `socket`. Claude Code akzeptiert `socket`, führt aber jeden Server über stdio aus, daher gelten die stdout-Protokoll-Regeln für alle Server |

268| `env` | Umgebungsvariablen, die beim Starten des Servers gesetzt werden |265| `env` | Umgebungsvariablen, die beim Starten des Servers gesetzt werden |

273| `shutdownTimeout` | Maximale Zeit zum Warten auf ordnungsgemäßes Herunterfahren (Millisekunden). Wenn das Timeout abläuft, beendet Claude Code den Server-Prozess. Wenn nicht gesetzt, gilt kein Timeout |270| `shutdownTimeout` | Maximale Wartezeit für ordnungsgemäßes Herunterfahren (Millisekunden). Wenn das Timeout abläuft, beendet Claude Code den Server-Prozess. Wenn nicht gesetzt, gilt kein Timeout |

274| `restartOnCrash` | Ob der Server nach einem Absturz neu gestartet werden soll. Standard ist `true`. Setzen Sie auf `false`, um einen abgestürzten Server gestoppt zu lassen, anstatt ihn neu zu starten |271| `restartOnCrash` | Ob der Server nach einem Absturz neu gestartet werden soll. Standard ist `true`. Setzen Sie auf `false`, um einen abgestürzten Server gestoppt zu lassen, anstatt ihn neu zu starten |

276| `diagnostics` | Ob Diagnosen nach Bearbeitungen in Claudes Kontext eingefügt werden sollen (Standard `true`). Setzen Sie auf `false`, um Code-Navigation beizubehalten, aber automatische Diagnose-Injektion zu unterdrücken. |273| `diagnostics` | Ob Diagnostiken nach Änderungen in Claudes Kontext eingefügt werden sollen (Standard `true`). Setzen Sie auf `false`, um Code-Navigation beizubehalten, aber automatische Diagnostik-Einspeisung zu unterdrücken. |

274

275`restartOnCrash` und `shutdownTimeout` erfordern Claude Code v2.1.205 oder später. Vor v2.1.205 akzeptierte das Config-Schema beide Optionen, aber das Setzen einer dieser Optionen führte dazu, dass Claude Code diesen LSP Server beim Start vollständig übersprang, wobei der Grund nur in der `claude --debug` Ausgabe sichtbar war.

277 276

278`restartOnCrash` und `shutdownTimeout` erfordern Claude Code v2.1.205 oder später. Vor v2.1.205 akzeptierte das Konfigurationsschema beide Optionen, aber das Setzen einer dieser Optionen führte dazu, dass Claude Code diesen LSP-Server beim Startup vollständig übersprungen hat, wobei der Grund nur in der `claude --debug` Ausgabe sichtbar war.277**Mehrere Server für die gleiche Erweiterung**: Wenn mehr als ein aktivierter LSP Server die gleiche Dateierweiterung in `extensionToLanguage` deklariert, ob die Server von einem Plugin oder von verschiedenen Plugins stammen, verarbeitet der zuerst registrierte Server Dateien mit dieser Erweiterung und die anderen starten nie. Die `/plugin` Schnittstelle zeigt eine Warnung an, die das Plugin benennt, dessen Server aktiv ist.

279 278

280**Mehrere Server für die gleiche Erweiterung**: Wenn mehr als ein aktivierter LSP-Server die gleiche Dateierweiterung in `extensionToLanguage` deklariert, ob die Server von einem Plugin oder von verschiedenen Plugins stammen, verarbeitet der zuerst registrierte Server Dateien mit dieser Erweiterung und die anderen starten nie. Die `/plugin` Schnittstelle zeigt eine Warnung an, die das Plugin benennt, dessen Server aktiv ist.279**Server, die nicht initialisiert werden können**: Claude Code überspringt einen Server, dessen Konfiguration ungültig ist, z. B. einer, dem `command` oder `extensionToLanguage` fehlt, und die anderen konfigurierten Server starten trotzdem. Führen Sie `claude --debug` aus, um zu sehen, warum ein Server übersprungen wurde.

281 280

282**Server, die nicht initialisiert werden können**: Claude Code überspringt einen Server, dessen Konfiguration ungültig ist, zum Beispiel einer, dem `command` oder `extensionToLanguage` fehlt, und die anderen konfigurierten Server starten trotzdem. Führen Sie `claude --debug` aus, um zu sehen, warum ein Server übersprungen wurde.281Ein übersprungener Server beansprucht seine Dateierweiterungen nicht, daher kann ein anderer gültiger Server, der die gleiche Erweiterung deklariert, vom gleichen oder einem anderen Plugin, diese Dateien trotzdem verarbeiten.

283 282

284Ein übersprungener Server beansprucht seine Dateierweiterungen nicht, daher kann ein anderer gültiger Server, der die gleiche Erweiterung deklariert, von demselben oder einem anderen Plugin, diese Dateien trotzdem verarbeiten. Vor v2.1.205 beanspruchte ein Server, der nicht initialisiert werden konnte, immer noch seine Erweiterungen und blockierte einen anderen gültigen Server für die gleiche Erweiterung.283**Senden Sie Log-Ausgabe an stderr, nicht stdout**: Claude Code liest den stdout eines Servers nur als Protokollmeldungen und akzeptiert Nachrichtenheader bis zu 64 KiB und einen Nachrichtentext bis zu 32 MiB. Claude Code trennt einen Server, der eines dieser Limits überschreitet oder nicht-Protokoll-Ausgabe an stdout schreibt, und zählt die Trennung als Absturz für `restartOnCrash` und `maxRestarts`. Wenn Sie mit `--debug` ausführen, schreibt Claude Code einen Fehler, der die Ursache benennt, in das Debug-Log.

285 284

286<Warning>285<Warning>

287 **Sie müssen die Language Server Binärdatei separat installieren.** LSP-Plugins konfigurieren, wie Claude Code sich mit einem Language Server verbindet, aber sie enthalten den Server selbst nicht. Wenn Sie `Executable not found in $PATH` im `/plugin` Errors-Tab sehen, installieren Sie die erforderliche Binärdatei für Ihre Sprache.286 **Sie müssen die Language Server Binärdatei separat installieren.** LSP Plugins konfigurieren, wie Claude Code sich mit einem Language Server verbindet, aber sie enthalten den Server selbst nicht. Wenn Sie `Executable not found in $PATH` im `/plugin` Errors Tab sehen, installieren Sie die erforderliche Binärdatei für Ihre Sprache.

288</Warning>287</Warning>

289 288

290**Verfügbare LSP-Plugins:**289**Verfügbare LSP Plugins:**

291 290

293| :------------------ | :------------------------- | :------------------------------------------------------------------------------------------- |292| :------------------ | :------------------------- | :------------------------------------------------------------------------------------------- |

297 296

298Installieren Sie zuerst den Language Server, dann installieren Sie das Plugin vom Marktplatz.297Installieren Sie zuerst den Language Server und dann das Plugin aus dem Marketplace.

299 298

300<h3 id="monitors">299<h3 id="monitors">

301 Monitore300 Monitors

302</h3>301</h3>

303 302

304Plugins können Hintergrund-Monitore deklarieren, die Claude Code automatisch startet, wenn das Plugin aktiv ist. Jeder Monitor führt einen Shell-Befehl für die Lebensdauer der Session aus und liefert jede stdout-Zeile an Claude als Benachrichtigung, damit Claude auf Log-Einträge, Statusänderungen oder abgerufene Events reagieren kann, ohne aufgefordert zu werden, die Überwachung selbst zu starten.303Plugins können Background-Monitore deklarieren, die Claude Code automatisch startet, wenn das Plugin aktiv ist. Jeder Monitor führt einen Shell-Befehl für die Lebensdauer der Session aus und liefert jede stdout-Zeile als Benachrichtigung an Claude, damit Claude auf Log-Einträge, Statusänderungen oder abgerufene Events reagieren kann, ohne aufgefordert zu werden, die Überwachung selbst zu starten.

305 304

306Plugin-Monitore verwenden den gleichen Mechanismus wie das [Monitor-Tool](/docs/de/tools-reference#monitor-tool) und teilen seine Verfügbarkeitsbeschränkungen. Sie laufen nur in interaktiven CLI-Sessions, laufen unsandboxed auf der gleichen Vertrauensebene wie [Hooks](#hooks) und werden auf Hosts übersprungen, wo das Monitor-Tool nicht verfügbar ist.305Plugin-Monitore verwenden den gleichen Mechanismus wie das [Monitor Tool](/docs/de/tools-reference#monitor-tool) und teilen seine Verfügbarkeitsbeschränkungen. Sie laufen nur in interaktiven CLI-Sessions, laufen unsandboxed auf der gleichen Vertrauensebene wie [Hooks](#hooks) und werden auf Hosts übersprungen, wo das Monitor Tool nicht verfügbar ist.

307 306

308**Speicherort**: `monitors/monitors.json` im Plugin-Root oder inline in `plugin.json`307**Speicherort**: `monitors/monitors.json` im Plugin-Root oder inline in `plugin.json`

309 308

332**Erforderliche Felder:**331**Erforderliche Felder:**

333 332

334| Feld | Beschreibung |333| Feld | Beschreibung |

335| :------------ | :----------------------------------------------------------------------------------------------------------------------------------------------- |334| :------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------- |

336| `name` | Bezeichner eindeutig innerhalb des Plugins. Verhindert doppelte Prozesse, wenn das Plugin neu geladen wird oder ein Skill erneut aufgerufen wird |335| `name` | Bezeichner, der innerhalb des Plugins eindeutig ist. Verhindert doppelte Prozesse, wenn das Plugin neu geladen wird oder ein Skill erneut aufgerufen wird |

338| `description` | Kurze Zusammenfassung dessen, was überwacht wird. Wird im Task-Panel und in Benachrichtigungszusammenfassungen angezeigt |337| `description` | Kurze Zusammenfassung dessen, was überwacht wird. Wird im Task-Panel und in Benachrichtigungszusammenfassungen angezeigt |

339 338

340**Optionale Felder:**339**Optionale Felder:**

341 340

342| Feld | Beschreibung |341| Feld | Beschreibung |

343| :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |342| :----- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

344| `when` | Steuert, wann der Monitor startet. `"always"` startet ihn beim Session-Start und beim Plugin-Reload und ist der Standard. `"on-skill-invoke:<skill-name>"` startet ihn beim ersten Mal, wenn der benannte Skill in diesem Plugin versendet wird |343| `when` | Steuert, wann der Monitor startet. `"always"` startet ihn beim Session-Start und beim Plugin-Reload und ist der Standard. `"on-skill-invoke:<skill-name>"` startet ihn das erste Mal, wenn der benannte Skill in diesem Plugin versendet wird |

345 344

346Der `command` Wert unterstützt die [Pfad-Substitutionen](#environment-variables) `${CLAUDE_PLUGIN_ROOT}`, `${CLAUDE_PLUGIN_DATA}` und `${CLAUDE_PROJECT_DIR}`, plus alle `${ENV_VAR}` aus der Umgebung. Stellen Sie dem Befehl `cd "${CLAUDE_PLUGIN_ROOT}" && ` voran, wenn das Skript aus dem Plugin-eigenen Verzeichnis ausgeführt werden muss.345Der `command` Wert unterstützt die [Pfad-Substitutionen](#environment-variables) `${CLAUDE_PLUGIN_ROOT}`, `${CLAUDE_PLUGIN_DATA}` und `${CLAUDE_PROJECT_DIR}`, plus alle `${ENV_VAR}` aus der Umgebung. Präfixieren Sie den Befehl mit `cd "${CLAUDE_PLUGIN_ROOT}" && `, wenn das Script aus dem eigenen Verzeichnis des Plugins ausgeführt werden muss.

347 346

348Ein Monitor `command` kann nicht auf [`${user_config.*}`](#user-configuration) Werte verweisen. Der Befehl läuft durch eine Shell, daher lehnt Claude Code den Monitor mit einem [Fehler](/docs/de/errors#plugin-command-references-user-config) ab, anstatt den Wert zu ersetzen. Monitor-Prozesse erhalten keine `CLAUDE_PLUGIN_OPTION_<KEY>` Umgebungsvariablen, daher sollte das Monitor-Skript den Wert aus einer Konfigurationsdatei lesen, die es besitzt. Vor v2.1.207 ersetzten Monitor-Befehle `${user_config.*}` Werte.347Ein Monitor `command` kann nicht auf [`${user_config.*}`](#user-configuration) Werte verweisen. Der Befehl läuft durch eine Shell, daher lehnt Claude Code den Monitor mit einem [Fehler](/docs/de/errors#plugin-command-references-user-config) ab, anstatt den Wert zu ersetzen. Monitor-Prozesse erhalten keine `CLAUDE_PLUGIN_OPTION_<KEY>` Umgebungsvariablen, daher sollte das Monitor-Script den Wert aus einer Konfigurationsdatei lesen, die es besitzt.

349 348

350Das Deaktivieren eines Plugins während einer Session stoppt nicht die Monitore, die bereits laufen. Sie stoppen, wenn die Session endet.349Wenn Sie ein Plugin während einer Session deaktivieren, stoppt Claude Code nicht die Monitore, die bereits laufen; sie stoppen, wenn die Session endet.

351 350

352<h3 id="themes">351<h3 id="themes">

353 Themes352 Themes

354</h3>353</h3>

355 354

356Plugins können Farbthemes versenden, die in `/theme` neben den integrierten Voreinstellungen und den lokalen Themes des Benutzers angezeigt werden. Ein Theme ist eine JSON-Datei in `themes/` mit einer `base` Voreinstellung und einer sparsamen `overrides` Map von Farb-Tokens. Themes sind eine [experimentelle Komponente](#experimental-components).355Plugins können Farbthemes bereitstellen, die in `/theme` neben den integrierten Voreinstellungen und den lokalen Themes des Benutzers erscheinen. Ein Theme ist eine JSON-Datei in `themes/` mit einer `base` Voreinstellung und einer sparsamen `overrides` Map von Farb-Tokens. Themes sind eine [experimentelle Komponente](#experimental-components).

357 356

358```json theme={null}357```json theme={null}

359{358{

367}366}

368```367```

369 368

370Das Auswählen eines Plugin-Themes speichert `custom:<plugin-name>:<slug>` in der Konfiguration des Benutzers. Plugin-Themes sind schreibgeschützt; das Drücken von `Ctrl+E` auf einem in `/theme` kopiert es in `~/.claude/themes/`, damit der Benutzer die Kopie bearbeiten kann.369Wenn ein Benutzer ein Plugin-Theme auswählt, speichert Claude Code `custom:<plugin-name>:<slug>` in seiner Konfiguration. Plugin-Themes sind schreibgeschützt: Wenn ein Benutzer `Ctrl+E` auf einem in `/theme` drückt, kopiert Claude Code es in `~/.claude/themes/`, damit er die Kopie bearbeiten kann.

371 370

372***371***

373 372

374<h2 id="plugin-installation-scopes">373<h2 id="plugin-installation-scopes">

375 Plugin-Installationsbereiche374 Installationsbereiche für Plugins

376</h2>375</h2>

377 376

378Wenn Sie ein Plugin installieren, wählen Sie einen **Bereich**, der bestimmt, wo das Plugin verfügbar ist und wer es sonst noch verwenden kann:377Wenn Sie ein Plugin installieren, wählen Sie einen **Bereich** aus, der bestimmt, wo das Plugin verfügbar ist und wer es sonst noch verwenden kann:

379 378

381| :-------- | :------------------------------------------------------ | :-------------------------------------------------------------------- |380| :-------- | :--------------------------------------- | :---------------------------------------------------------------------------------------- |

386 385

387Plugins verwenden das gleiche Bereichssystem wie andere Claude Code Konfigurationen. Installationsanweisungen und Bereichs-Flags finden Sie unter [Plugins installieren](/docs/de/discover-plugins#install-plugins). Eine vollständige Erklärung der Bereiche finden Sie unter [Konfigurationsbereiche](/docs/de/settings#configuration-scopes).386Plugins verwenden das gleiche Bereichssystem wie andere Claude Code-Konfigurationen. Installationsanweisungen und Bereichsflags finden Sie unter [Plugins installieren](/docs/de/discover-plugins#install-plugins). Eine vollständige Erklärung der Bereiche finden Sie unter [Konfigurationsbereiche](/docs/de/settings#where-settings-live).

388 387

389***388***

390 389

391<h2 id="skills-directory-plugins">390<h2 id="skills-directory-plugins">

392 Skills-Verzeichnis-Plugins391 Plugins aus dem Skills-Verzeichnis

393</h2>392</h2>

394 393

395Jeder Ordner unter einem Skills-Verzeichnis, das ein `.claude-plugin/plugin.json` Manifest enthält, wird beim nächsten Session als Plugin mit dem Namen `<name>@skills-dir` geladen, ohne Marktplatz und ohne Installationsschritt. Erstellen Sie einen mit [`plugin init`](#plugin-init). Im Gegensatz zu einer Marktplatz-Installation wird das Plugin an Ort und Stelle erkannt, anstatt in den Plugin-Cache kopiert zu werden.394Jeder Ordner unter einem Skills-Verzeichnis, der ein `.claude-plugin/plugin.json`-Manifest enthält, wird in der nächsten Sitzung als Plugin mit dem Namen `<name>@skills-dir` geladen, ohne Marketplace und ohne Installationsschritt. Erstellen Sie eines mit [`plugin init`](#plugin-init). Im Gegensatz zu einer kopierten Marketplace-Installation wird das Plugin an Ort und Stelle erkannt, anstatt in den Plugin-Cache kopiert zu werden.

396 395

397Ein Skills-Verzeichnis-Baum unterstützt drei unterschiedliche Dinge:396Eine Skills-Verzeichnisstruktur unterstützt drei verschiedene Dinge:

398 397

399| Was Sie haben | Was es ist |398| Was Sie haben | Was es ist |

400| :-------------------------------------------- | :----------------------------------------------------------------------------------------- |399| :-------------------------------------------- | :----------------------------------------------------------------------------------------- |

402| `<skills-dir>/foo/.claude-plugin/plugin.json` | Ein Plugin `foo@skills-dir`, das seine eigenen Skills, Agents, Hooks und mehr bündeln kann |401| `<skills-dir>/foo/.claude-plugin/plugin.json` | Ein Plugin `foo@skills-dir`, das seine eigenen Skills, Agents, Hooks und mehr bündeln kann |

404 403

405<h3 id="choose-where-the-plugin-loads-from">404<h3 id="choose-where-the-plugin-loads-from">

406 Wählen Sie, von wo das Plugin geladen wird405 Wählen Sie, von wo aus das Plugin geladen wird

407</h3>406</h3>

408 407

410| :---------------------- | :--------- | :--------------------------------------------------------------------------------------- |409| :---------------------- | :--------- | :--------------------------------------------------------------------------------------------------------------------------------------- |

413 412

414Ein Projekt-Bereich-Plugin wird in das Repository eingecheckt und erreicht jeden Mitarbeiter, der es klont. Da dieser Inhalt aus dem Repository und nicht von Ihnen stammt, wird er nur nach dem gleichen Trust-Gate geladen, das `.claude/settings.json` regelt, und Komponenten, die Code ausführen, sind weiter eingeschränkt:413Ein Plugin im Projektbereich wird in das Repository eingecheckt und erreicht jeden Mitarbeiter, der es klont. Da dieser Inhalt aus dem Repository und nicht von Ihnen stammt, wird er nur nach demselben Vertrauenstor geladen, das die Projekterlaubnisregeln in `.claude/settings.json` regelt. Das Vertrauen in einen übergeordneten Ordner oder das Ausführen mit `-p` ist daher nicht ausreichend, und Komponenten, die Code ausführen, sind weiter eingeschränkt:

415 414

416* MCP-Server, die es deklariert, durchlaufen die [gleiche Pro-Server-Genehmigung](/docs/de/mcp) wie ein Projekt `.mcp.json`415* MCP-Server, die es deklariert, durchlaufen die [gleiche Pro-Server-Genehmigung](/docs/de/mcp) wie ein Projekt `.mcp.json`

417* LSP-Server starten nur, nachdem Sie dem Workspace vertrauen416* LSP-Server starten nur, nachdem Sie den Workspace vertrauen

418* [Hintergrund-Monitore](#monitors) werden nicht geladen417* [Hintergrund-Monitore](#monitors) werden nicht geladen

419 418

420Persönliche Bereich-Plugins haben keine dieser Einschränkungen.419Plugins im persönlichen Bereich haben keine dieser Einschränkungen.

421 420

422<Warning>421<Warning>

423 Projekt-Bereich `@skills-dir` Plugins werden nur aus dem `.claude/skills/` des Verzeichnisses geladen, in dem Sie Claude Code starten. Sie [gehen nicht bis zur Repository-Root](/docs/de/skills#automatic-discovery-from-parent-and-nested-directories) wie einfache Skills und Befehle, daher verpasst das Starten aus einem Unterverzeichnis ein Plugin, das im Repo-Root lebt. Starten Sie vom Repository-Root, oder führen Sie `/reload-plugins` aus, nachdem Sie Verzeichnisse wechseln.422 Plugins im Projektbereich `@skills-dir` werden nur aus dem `.claude/skills/` des [primären Arbeitsverzeichnisses](/docs/de/permissions#working-directories) der Sitzung geladen. Sie [gehen nicht bis zur Repository-Root](/docs/de/skills#discovery-from-parent-and-nested-directories) wie einfache Skills und Befehle, daher wird ein Plugin, das sich im Repository-Root befindet, übersehen, wenn Sie von einem Unterverzeichnis aus starten. Starten Sie vom Repository-Root, oder [verschieben Sie die Sitzung mit `/cd`](/docs/de/permissions#move-the-session-to-another-directory) auf v2.1.246 oder später dorthin.

424</Warning>423</Warning>

425 424

426<h3 id="edit-reload-and-disable-a-skills-directory-plugin">425<h3 id="edit-reload-and-disable-a-skills-directory-plugin">

427 Bearbeiten, neu laden und deaktivieren Sie ein Skills-Verzeichnis-Plugin426 Bearbeiten, neu laden und deaktivieren Sie ein Plugin aus dem Skills-Verzeichnis

428</h3>427</h3>

429 428

430Änderungen, die Sie an der `SKILL.md` eines Skills vornehmen, treten sofort in der aktuellen Session in Kraft. Änderungen an den anderen Komponenten des Plugins, wie `hooks/`, `.mcp.json`, `agents/` und `output-styles/`, tun dies nicht. Führen Sie `/reload-plugins` aus oder starten Sie Claude Code neu, um diese zu übernehmen. Siehe [Live-Änderungserkennung](/docs/de/skills#live-change-detection).429Änderungen, die Sie an der `SKILL.md` eines Skills vornehmen, werden sofort in der aktuellen Sitzung wirksam. Änderungen an anderen Komponenten des Plugins, wie `hooks/`, `.mcp.json`, `agents/` und `output-styles/`, werden nicht wirksam. Führen Sie `/reload-plugins` aus oder starten Sie Claude Code neu, um diese zu übernehmen. Siehe [Live-Änderungserkennung](/docs/de/skills#live-change-detection).

431 430

432Um das Laden eines Skills-Verzeichnis-Plugins zu stoppen, löschen Sie seinen Ordner oder deaktivieren Sie ihn nach Name. Es gibt keinen `uninstall` Schritt, da nichts von einem Marktplatz installiert wurde.431Um das Laden eines Plugins aus dem Skills-Verzeichnis zu beenden, löschen Sie seinen Ordner oder deaktivieren Sie es nach Name. Es gibt keinen `uninstall`-Schritt, da nichts von einem Marketplace installiert wurde.

433 432

434```bash theme={null}433```bash theme={null}

435claude plugin disable my-tool@skills-dir434claude plugin disable my-tool@skills-dir

437 436

438***437***

439 438

439<h2 id="synced-plugins">

440 Plugins synchronisiert von claude.ai

441</h2>

442

443In [Cowork](https://claude.com/product/cowork) und [Cloud-Sitzungen](/docs/de/cloud-environments#what-carries-over-from-your-setup) lädt Claude Code die für Ihr claude.ai-Konto aktivierten Plugins in `~/.claude/plugins/synced/` in der eigenen Umgebung der Sitzung herunter und lädt jedes als `<name>@synced`, ohne Marketplace und ohne Installationsdatensatz. Claude Code lädt sie nicht in Sitzungen, die Sie in Ihrem eigenen Terminal starten. In dieser Cowork- oder Cloud-Umgebung zeigt `claude plugin list` die heruntergeladenen Kopien unter einer `Synced from claude.ai`-Überschrift an. Vor v2.1.239 lud Claude Code diese Plugins als `<name>@inline`, die Identität, die `--plugin-dir`-Plugins verwenden.

444

445Verwalten Sie ein synchronisiertes Plugin über die `<name>@synced`-ID, die `claude plugin list` ausgibt:

446

447* **Eines ausschalten**: Führen Sie in der synchronisierten Sitzung `claude plugin disable <name>@synced` aus, oder bitten Sie Claude, es auszuführen. Claude Code speichert die Auswahl als `"<name>@synced": false` in der [`enabledPlugins`](/docs/de/settings-reference#enabledplugins) dieser Umgebung auf Benutzerebene. Um das Plugin wieder einzuschalten, führen Sie `claude plugin enable <name>@synced` in derselben Sitzung aus. Um ein Plugin aus jeder synchronisierten Sitzung herauszuhalten, [schalten Sie es für Ihr claude.ai-Konto aus](/docs/de/desktop#extend-claude-code). Um es aus den synchronisierten Sitzungen eines Projekts in jeder Umgebung herauszuhalten, setzen Sie `"<name>@synced": false` unter `enabledPlugins` in der committed `.claude/settings.json` dieses Projekts.

448* **Verwalten Sie das Plugin selbst auf claude.ai**: `claude plugin install`, `update` und `uninstall` gelten nicht für ein synchronisiertes Plugin. Um eines zu entfernen, schalten Sie das Plugin für Ihr claude.ai-Konto aus; die nächste synchronisierte Sitzung startet ohne es.

449

450Wenn ein aktiviertes Plugin aus einer anderen Quelle, wie eine Marketplace-Installation, ein [Skills-Directory-Plugin](#skills-directory-plugins) oder ein `--plugin-dir`-Plugin, den Namen eines synchronisierten Plugins entspricht, lädt Claude Code dieses Plugin und meldet die synchronisierte Kopie als nicht geladen. Um stattdessen die claude.ai-Kopie zu verwenden, deaktivieren Sie Ihre eigene Kopie. Vor v2.1.239 lud Claude Code die synchronisierte Kopie statt einer gleichnamigen Marketplace-Installation.

451

452***

453

440<h2 id="plugin-manifest-schema">454<h2 id="plugin-manifest-schema">

441 Plugin-Manifest-Schema455 Plugin-Manifest-Schema

442</h2>456</h2>

443 457

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

445 459

446Das Manifest ist optional. Wenn es weggelassen wird, erkennt Claude Code Komponenten automatisch in [Standardspeicherorten](#file-locations-reference) und leitet den Plugin-Namen aus dem Verzeichnisnamen ab. Verwenden Sie ein Manifest, wenn Sie Metadaten oder benutzerdefinierte Komponentenpfade bereitstellen müssen.460Das Manifest ist optional. Falls weggelassen, erkennt Claude Code Komponenten automatisch in [Standardpfaden](#file-locations-reference) und leitet den Plugin-Namen aus dem Verzeichnisnamen ab. Verwenden Sie ein Manifest, wenn Sie Metadaten oder benutzerdefinierte Komponentenpfade bereitstellen müssen.

447 461

448<h3 id="complete-schema">462<h3 id="complete-schema">

449 Vollständiges Schema463 Vollständiges Schema

464 "repository": "https://github.com/author/plugin",478 "repository": "https://github.com/author/plugin",

465 "license": "MIT",479 "license": "MIT",

466 "keywords": ["keyword1", "keyword2"],480 "keywords": ["keyword1", "keyword2"],

481 "metadata": { "catalogId": "cat-123", "tier": "pro" },

467 "skills": "./custom/skills/",482 "skills": "./custom/skills/",

468 "commands": ["./custom/commands/special.md"],483 "commands": ["./custom/commands/special.md"],

469 "agents": ["./custom/agents/reviewer.md"],484 "agents": ["./custom/agents/reviewer.md"],

486 Erforderliche Felder501 Erforderliche Felder

487</h3>502</h3>

488 503

489Wenn Sie ein Manifest einschließen, ist `name` das einzige erforderliche Feld.504Wenn Sie ein Manifest einbeziehen, ist `name` das einzige erforderliche Feld.

490 505

491| Feld | Typ | Beschreibung | Beispiel |506| Feld | Typ | Beschreibung | Beispiel |

492| :----- | :----- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |507| :----- | :----- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |

493| `name` | string | Eindeutiger Bezeichner (kebab-case, keine Leerzeichen). Wenn ein [Marktplatz-Eintrag](/docs/de/plugin-marketplaces#plugin-entries) das Plugin unter einem anderen Namen auflistet, ist der Name des Marktplatz-Eintrags das, was `enabledPlugins` Schlüssel und `/plugin` verwenden | `"deployment-tools"` |508| `name` | string | Eindeutiger Bezeichner in Kebab-Case ohne Leerzeichen, Steuerzeichen oder bidirektionale Formatierungszeichen. Wenn ein [Marketplace-Eintrag](/docs/de/plugin-marketplaces#plugin-entries) das Plugin unter einem anderen Namen auflistet, ist der Name des Marketplace-Eintrags das, was `enabledPlugins`-Schlüssel und `/plugin` verwenden | `"deployment-tools"` |

494 509

495Dieser Name wird für die Namensgebung von Komponenten verwendet. Beispielsweise wird der Agent `agent-creator` für das Plugin mit dem Namen `plugin-dev` in der Benutzeroberfläche als `plugin-dev:agent-creator` angezeigt.510Dieser Name wird für die Namensgebung von Komponenten verwendet. Beispielsweise wird der Agent `agent-creator` für das Plugin mit dem Namen `plugin-dev` in der Benutzeroberfläche als `plugin-dev:agent-creator` angezeigt.

496 511

498 Nicht erkannte Felder513 Nicht erkannte Felder

499</h3>514</h3>

500 515

501Claude Code ignoriert Top-Level-Felder, die es nicht erkennt. Sie können Metadaten aus einem anderen Ökosystem in `plugin.json` behalten und das Plugin wird trotzdem geladen. Dies macht es praktisch, ein Manifest zu verwalten, das gleichzeitig als VS Code- oder Cursor-Erweiterungsmanifest, eine npm `package.json` oder ein MCPB/DXT-Bundle-Manifest dient.516Claude Code ignoriert Felder auf oberster Ebene, die nicht erkannt werden. Sie können Metadaten aus einem anderen Ökosystem in `plugin.json` behalten und das Plugin wird trotzdem geladen. Dies macht es praktisch, ein Manifest zu verwalten, das gleichzeitig als VS Code- oder Cursor-Erweiterungsmanifest, eine npm-`package.json` oder ein MCPB/DXT-Bundle-Manifest dient.

502 517

503`claude plugin validate` meldet nicht erkannte Felder als Warnungen, nicht als Fehler. Wenn ein Feld ein oder zwei Zeichen von einem erkannten entfernt ist, schlägt die Warnung den wahrscheinlich beabsichtigten Namen vor. Ein Plugin mit nur Warnungen zu nicht erkannten Feldern besteht die Validierung und wird zur Laufzeit geladen.518`claude plugin validate` meldet nicht erkannte Felder als Warnungen, nicht als Fehler. Wenn ein Feld ein oder zwei Zeichen von einem erkannten Feld entfernt ist, schlägt die Warnung den wahrscheinlich beabsichtigten Namen vor. Ein Plugin mit nur Warnungen zu nicht erkannten Feldern besteht die Validierung und wird zur Laufzeit geladen.

504 519

505Felder mit dem falschen Typ schlagen immer noch fehl. Beispielsweise ist ein `keywords` Wert, der ein String statt eines Arrays ist, ein Ladefehler, und `claude plugin validate` meldet ihn als solchen.520Wie Claude Code ein erkanntes Feld behandelt, dessen Wert den falschen Typ hat, hängt vom Feld ab:

521

522* **Die meisten Felder**: Das Plugin kann nicht geladen werden. Beispielsweise ist ein `keywords`-Wert, der ein String statt eines Arrays ist, ein Ladefehler, und `claude plugin validate` meldet ihn als solchen.

523* **`experimental` und `metadata`**: Claude Code ignoriert einen Nicht-Objekt-Wert, und `claude plugin validate` meldet eine Warnung.

506 524

507Übergeben Sie `--strict`, um Warnungen als Fehler zu behandeln. Verwenden Sie es in CI, um einen falsch geschriebenen Feldnamen oder ein Feld, das von einem anderen Tool-Manifest übrig geblieben ist, vor der Veröffentlichung zu erfassen, obwohl das Plugin zur Laufzeit geladen würde.525Übergeben Sie `--strict`, um Warnungen als Fehler zu behandeln. Verwenden Sie es in CI, um einen falsch geschriebenen Feldnamen oder ein Feld, das von einem anderen Tool-Manifest übrig geblieben ist, vor der Veröffentlichung zu erfassen, obwohl das Plugin zur Laufzeit geladen würde.

508 526

511```529```

512 530

513<h3 id="metadata-fields">531<h3 id="metadata-fields">

514 Metadaten-Felder532 Metadatenfelder

515</h3>533</h3>

516 534

518| :--------------- | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |536| :--------------- | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |

520| `displayName` | string | Benutzerfreundlicher Name, der in der `/plugin` Auswahl und anderen UI-Oberflächen angezeigt wird. Fällt auf `name` zurück, wenn weggelassen. Im Gegensatz zu `name` kann es Leerzeichen und beliebige Groß-/Kleinschreibung enthalten. Wird nicht für Namensgebung oder Suche verwendet. Erfordert Claude Code v2.1.143 oder später. | `"Deployment Tools"` |538| `displayName` | string | Benutzerfreundlicher Name, der in der `/plugin`-Auswahl und anderen UI-Oberflächen angezeigt wird. Fällt auf `name` zurück, wenn weggelassen. Im Gegensatz zu `name` kann es Leerzeichen und beliebige Groß-/Kleinschreibung enthalten. Wird nicht für Namensgebung oder Suche verwendet. | `"Deployment Tools"` |

521| `version` | string | Optional. Semantische Version. Das Setzen dieser Version fixiert das Plugin auf diese Versionsnummer, sodass Benutzer nur Updates erhalten, wenn Sie diese erhöhen. Wenn weggelassen, greift Claude Code auf den Git-Commit-SHA zurück, sodass jeder Commit als neue Version behandelt wird. Wenn auch im Marktplatz-Eintrag gesetzt, hat `plugin.json` Vorrang. Siehe [Versionsverwaltung](#version-management). | `"2.1.0"` |539| `version` | string | Optional. Semantische Version. Das Setzen dieser Version fixiert das Plugin auf diese Versionsnummer, sodass Benutzer nur Updates erhalten, wenn Sie diese erhöhen, außer für eine [`command`-Quelle](/docs/de/plugin-marketplaces#command-sources); siehe [Versionsverwaltung](#version-management). Falls auch im Marketplace-Eintrag gesetzt, gewinnt `plugin.json`. Falls weggelassen, kommt die Version aus der nächsten Quelle in [Versionsverwaltung](#version-management). | `"2.1.0"` |

523| `author` | object | Autoreninformationen | `{"name": "Dev Team", "email": "dev@company.com"}` |541| `author` | object | Autoreninformationen | `{"name": "Dev Team", "email": "dev@company.com"}` |

528| `defaultEnabled` | boolean | Ob das Plugin in einem aktivierten Zustand startet, wenn der Benutzer keinen gesetzt hat. Standardmäßig `true`. Siehe [Standardaktivierung](#default-enablement). Erfordert Claude Code v2.1.154 oder später. | `false` |546| `metadata` | object | Freiformobjekt für Ihre eigenen Daten, wie Berechtigungs- oder Katalogfelder. Claude Code liest es nicht, daher beeinflussen die Werte niemals das Plugin-Verhalten. Claude Code ignoriert einen Nicht-Objekt-Wert, und `claude plugin validate` meldet ihn als Warnung. Vor v2.1.222 behandelte Claude Code den Schlüssel als [nicht erkanntes Feld](#unrecognized-fields). | `{"catalogId": "cat-123"}` |

529 548

530<h3 id="default-enablement">549<h3 id="default-enablement">

531 Standardaktivierung550 Standardaktivierung

532</h3>551</h3>

533 552

534Setzen Sie `defaultEnabled: false` in `plugin.json`, um ein Plugin zu versenden, das deaktiviert installiert wird. Der Benutzer schaltet es mit `claude plugin enable <plugin>` oder der `/plugin` Schnittstelle ein. Verwenden Sie dies für Plugins, die Kosten hinzufügen oder einen Bereich, in den sich ein Benutzer einwählen sollte, wie eines, das sich mit einem externen Service verbindet. Dies erfordert Claude Code v2.1.154 oder später. Frühere Versionen ignorieren das Feld und aktivieren das Plugin bei der Installation.553Setzen Sie `defaultEnabled: false` in `plugin.json`, um ein Plugin zu versenden, das deaktiviert installiert wird. Der Benutzer aktiviert es mit `claude plugin enable <plugin>` oder der `/plugin`-Schnittstelle. Verwenden Sie dies für Plugins, die Kosten verursachen oder einen Umfang haben, den ein Benutzer akzeptieren sollte, wie eines, das sich mit einem externen Service verbindet.

535 554

536`defaultEnabled` ist der Fallback, wenn nichts anderes den Zustand des Plugins entschieden hat. Zwei Dinge haben Vorrang vor ihm:555`defaultEnabled` ist der Fallback, wenn nichts anderes den Zustand des Plugins entschieden hat. Zwei Dinge haben Vorrang vor ihm:

537 556

538* **Die Einstellung des Benutzers**: Ein Eintrag für das Plugin in `enabledPlugins` in jedem Einstellungsbereich. Einmal geschrieben, bleibt es über Plugin-Updates und Neuinstallationen bestehen, daher ändert das Ändern von `defaultEnabled` in einer späteren Version nicht einen bestehenden Benutzer.557* **Die Einstellung des Benutzers**: ein Eintrag für das Plugin in `enabledPlugins` in jedem Einstellungsbereich. Einmal geschrieben, bleibt es über Plugin-Updates und Neuinstallationen hinweg bestehen, daher ändert das Ändern von `defaultEnabled` in einer späteren Version nicht den Zustand eines bestehenden Benutzers.

539* **Eine Abhängigkeitsanforderung**: Wenn ein Plugin von einem anderen erforderlich ist, das aktiv ist, schreibt Claude Code `true` dafür bei Installation oder Aktivierung. Das gibt ihm eine explizite Einstellung, daher gilt sein eigener Standard nicht mehr. Siehe [Aktivieren oder Deaktivieren eines Plugins mit Abhängigkeiten](/docs/de/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies).558* **Eine Abhängigkeitsanforderung**: Wenn ein Plugin von einem anderen erforderlich ist, das aktiv ist, schreibt Claude Code `true` dafür bei Installation oder Aktivierung. Das gibt ihm eine explizite Einstellung, daher gilt sein eigener Standard nicht mehr. Siehe [Plugin mit Abhängigkeiten aktivieren oder deaktivieren](/docs/de/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies).

540 559

541Das gleiche Feld kann im Marktplatz-Eintrag eines Plugins erscheinen, wo es Vorrang vor dem Wert in `plugin.json` hat. Siehe [Optionale Plugin-Felder](/docs/de/plugin-marketplaces#optional-plugin-fields).560Das gleiche Feld kann im Marketplace-Eintrag eines Plugins erscheinen, wo es Vorrang vor dem Wert in `plugin.json` hat. Siehe [Optionale Plugin-Felder](/docs/de/plugin-marketplaces#optional-plugin-fields).

542 561

543<h3 id="component-path-fields">562<h3 id="component-path-fields">

544 Komponentenpfad-Felder563 Komponentenpfad-Felder

545</h3>564</h3>

546 565

547| Feld | Typ | Beschreibung | Beispiel |566| Feld | Typ | Beschreibung | Beispiel |

548| :---------------------- | :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------- |567| :---------------------- | :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

560| `dependencies` | array | Andere Plugins, die dieses Plugin benötigt, optional mit semver Versionsbeschränkungen. Siehe [Plugin-Abhängigkeitsversionen einschränken](/docs/de/plugin-dependencies) | `[{ "name": "secrets-vault", "version": "~2.1.0" }]` |580| `dependencies` | array | Andere Plugins, die dieses Plugin benötigt, optional mit Semver-Versionsbeschränkungen. Siehe [Plugin-Abhängigkeitsversionen einschränken](/docs/de/plugin-dependencies) | `[{ "name": "secrets-vault", "version": "~2.1.0" }]` |

561 581

562<h3 id="experimental-components">582<h3 id="experimental-components">

563 Experimentelle Komponenten583 Experimentelle Komponenten

564</h3>584</h3>

565 585

566Komponenten unter dem `experimental` Schlüssel, `themes` und `monitors`, haben ein Manifest-Schema, das sich zwischen Releases ändern kann, während sie stabilisieren. Wo Sie sie deklarieren, ist eine separate Migration: das Top-Level funktioniert immer noch, `claude plugin validate` warnt, und eine zukünftige Version wird `experimental.*` erfordern.586Komponenten unter dem `experimental`-Schlüssel, `themes` und `monitors`, haben ein Manifest-Schema, das sich zwischen Releases ändern kann, während sie stabilisieren. Wo Sie sie deklarieren, ist eine separate Migration: Die oberste Ebene funktioniert immer noch, `claude plugin validate` warnt, und eine zukünftige Version wird `experimental.*` erfordern.

567 587

568<h3 id="user-configuration">588<h3 id="user-configuration">

569 Benutzerkonfiguration589 Benutzerkonfiguration

570</h3>590</h3>

571 591

572Das `userConfig` Feld deklariert Werte, die Claude Code den Benutzer abfragt, wenn das Plugin aktiviert wird. Verwenden Sie dies, anstatt Benutzer zu zwingen, `settings.json` manuell zu bearbeiten.592Das Feld `userConfig` deklariert Werte, die Claude Code den Benutzer abfragt, wenn das Plugin aktiviert wird. Verwenden Sie dies, anstatt Benutzer zu zwingen, `settings.json` manuell zu bearbeiten.

573 593

574```json theme={null}594```json theme={null}

575{595{

596| `type` | Ja | Einer von `string`, `number`, `boolean`, `directory` oder `file` |616| `type` | Ja | Einer von `string`, `number`, `boolean`, `directory` oder `file` |

597| `title` | Ja | Beschriftung im Konfigurationsdialog |617| `title` | Ja | Beschriftung im Konfigurationsdialog |

598| `description` | Ja | Hilfetext unter dem Feld |618| `description` | Ja | Hilfetext unter dem Feld |

604 624

605Jeder Wert ist für die Substitution als `${user_config.KEY}` in MCP- und LSP-Server-Konfigurationen und Hook-Befehlen verfügbar. Nicht-sensitive Werte können auch in Skill- und Agent-Inhalten ersetzt werden. Alle Werte werden an Hook-Prozesse als `CLAUDE_PLUGIN_OPTION_<KEY>` Umgebungsvariablen exportiert, wobei `<KEY>` der Optionsschlüssel in Großbuchstaben ist.625Jeder Wert ist für die Substitution als `${user_config.KEY}` in MCP- und LSP-Server-Konfigurationen und Hook-Befehlen verfügbar. Nicht-sensitive Werte können auch in Skill- und Agent-Inhalten ersetzt werden. Alle Werte werden an Hook-Prozesse als `CLAUDE_PLUGIN_OPTION_<KEY>`-Umgebungsvariablen exportiert, wobei `<KEY>` der Optionsschlüssel in Großbuchstaben ist.

606 626

607Felder, die in einer Shell ausgeführt werden, lehnen `${user_config.*}` ab: Das Ersetzen eines konfigurierten Werts in einem Shell-Befehl würde der Shell ermöglichen, alles auszuführen, was dieser Wert enthält, daher schlägt die Komponente mit einem [Fehler](/docs/de/errors#plugin-command-references-user-config) fehl. Jedes abgelehnte Feld hat eine alternative Möglichkeit, den Wert zu übergeben:627Felder, die in einer Shell ausgeführt werden, lehnen `${user_config.*}` ab: Das Ersetzen eines konfigurierten Werts in einem Shell-Befehl würde der Shell erlauben, alles auszuführen, was dieser Wert enthält, daher schlägt die Komponente mit einem [Fehler](/docs/de/errors#plugin-command-references-user-config) fehl. Jedes abgelehnte Feld hat eine alternative Möglichkeit, den Wert zu übergeben:

608 628

609| Abgelehntes Feld | Wie man den Wert übergibt |629| Abgelehntes Feld | Wie man den Wert übergibt |

610| :--------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |630| :--------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |

611| Shell-Form-Hook-Befehle | Verwenden Sie [Exec-Form](/docs/de/hooks#exec-form-and-shell-form) mit `args`, oder lesen Sie `CLAUDE_PLUGIN_OPTION_<KEY>` aus der Umgebung des Hooks |631| Shell-Form-Hook-Befehle | Verwenden Sie [exec-Form](/docs/de/hooks#exec-form-and-shell-form) mit `args` oder lesen Sie `CLAUDE_PLUGIN_OPTION_<KEY>` aus der Hook-Umgebung |

612| [Monitor](#monitors) Befehle | Lesen Sie den Wert aus einer Konfigurationsdatei im Skript |632| [Monitor](#monitors)-Befehle | Lesen Sie den Wert aus einer Konfigurationsdatei im Skript |

613| MCP [`headersHelper`](/docs/de/mcp#use-dynamic-headers-for-custom-authentication) | Lesen Sie den Wert aus einer Konfigurationsdatei im Skript |633| MCP [`headersHelper`](/docs/de/mcp#use-dynamic-headers-for-custom-authentication) | Lesen Sie den Wert aus einer Konfigurationsdatei im Skript |

614 634

615Vor v2.1.207 ersetzten diese Felder `${user_config.KEY}` Werte; aktualisieren Sie Plugins, die sich darauf verlassen haben.635Vor v2.1.207 ersetzten diese Felder `${user_config.KEY}`-Werte; aktualisieren Sie Plugins, die sich darauf verlassen haben.

636

637Nicht-sensitive Werte werden unter dem [`pluginConfigs`](/docs/de/settings-reference#pluginconfigs)-Schlüssel in Ihrer Benutzer-`settings.json` als `pluginConfigs[<plugin-id>].options` gespeichert.

638

639Auf macOS speichert Claude Code sensitive Werte in der macOS Keychain und fällt auf `~/.claude/.credentials.json` zurück, wenn die Keychain den Schreibvorgang ablehnt. Auf Plattformen ohne unterstützte Keychain speichert es sie in `~/.claude/.credentials.json`. Keychain-Speicherung wird mit OAuth-Tokens geteilt und hat eine ungefähre Gesamtgrenze von 2 KB, daher halten Sie sensitive Werte klein.

640

641Claude Code liest alle `pluginConfigs`-Werte nur aus drei Einstellungsquellen:

642

643* **Benutzereinstellungen**: `~/.claude/settings.json`, die Datei, in die die Aktivierungsaufforderung schreibt

644* **`--settings`**: das CLI-Flag oder SDK-Inline-Einstellungen

645* **Verwaltete Einstellungen**: [organisationskontrollierte Richtlinie](/docs/de/permissions#managed-settings)

616 646

617Nicht-sensitive Werte werden unter dem [`pluginConfigs`](/docs/de/settings#pluginconfigs) Schlüssel in `settings.json` als `pluginConfigs[<plugin-id>].options` gespeichert. Claude Code schreibt den Schlüssel in Benutzereinstellungen und liest ihn aus Benutzereinstellungen, dem `--settings` Flag und verwalteten Einstellungen zurück; Einträge in einer Projekt-`.claude/settings.json` oder `.claude/settings.local.json` werden ignoriert. Vor v2.1.207 las Claude Code auch Projekt- und lokale Einstellungen.647Wenn mehr als eine Quelle denselben Schlüssel setzt, haben verwaltete Einstellungen Vorrang, dann `--settings`, dann Benutzereinstellungen. Die einzige Quelle, die Sie aus dieser Liste entfernen können, sind Benutzereinstellungen: Übergeben Sie [`--setting-sources`](/docs/de/cli-reference#cli-flags) ohne `user` und Claude Code überspringt sie. Verwaltete Einstellungen und `--settings` bleiben, was Sie übergeben. Die SDK-Option [`settingSources`](/docs/de/agent-sdk/claude-code-features#what-settingsources-does-not-control) setzt die gleiche Liste.

618 648

619Sensitive Werte gehen zum macOS Keychain oder zu `~/.claude/.credentials.json` auf Plattformen, wo kein unterstützter Keychain verfügbar ist. Keychain-Speicher wird mit OAuth-Tokens geteilt und hat ein ungefähres Gesamtlimit von 2 KB, daher halten Sie sensitive Werte klein.649Einträge in einer Projekt-`.claude/settings.json` oder `.claude/settings.local.json` werden ignoriert. Beide Dateien befinden sich im Workspace, daher könnte ein geklontes Repository Werte dort bereitstellen, und diese Werte würden in Plugin-Hook-Befehle, MCP-Server-Konfigurationen, LSP-Befehle und Monitor-Befehle fließen. Vor v2.1.207 wurden diese Einträge gelesen. Die Einschränkung ist spezifisch für `pluginConfigs`: [`enabledPlugins`](/docs/de/settings-reference#enabledplugins) berücksichtigt immer noch Projekt- und lokale Einstellungen.

620 650

621<h3 id="channels">651<h3 id="channels">

622 Kanäle652 Kanäle

623</h3>653</h3>

624 654

625Das `channels` Feld ermöglicht es einem Plugin, einen oder mehrere Nachrichtenkanäle zu deklarieren, die Inhalte in die Konversation injizieren. Jeder Kanal bindet sich an einen MCP-Server, den das Plugin bereitstellt.655Das Feld `channels` ermöglicht es einem Plugin, einen oder mehrere Nachrichtenkanäle zu deklarieren, die Inhalte in die Konversation einspritzen. Jeder Kanal bindet sich an einen MCP-Server, den das Plugin bereitstellt.

626 656

627```json theme={null}657```json theme={null}

628{658{

647}677}

648```678```

649 679

650Das `server` Feld ist erforderlich und muss einem Schlüssel in den `mcpServers` des Plugins entsprechen. Das optionale Pro-Kanal `userConfig` verwendet das gleiche Schema wie das Top-Level-Feld, wodurch das Plugin Bot-Tokens oder Owner-IDs abfragen kann, wenn das Plugin aktiviert wird.680Das Feld `server` ist erforderlich und muss einem Schlüssel in den `mcpServers` des Plugins entsprechen. Das optionale Pro-Kanal-`userConfig` verwendet das gleiche Schema wie das Feld auf oberster Ebene, wodurch das Plugin Bot-Tokens oder Owner-IDs abfragen kann, wenn das Plugin aktiviert wird.

651 681

652<h3 id="path-behavior-rules">682<h3 id="path-behavior-rules">

653 Pfad-Verhaltensregeln683 Pfadverhaltenregeln

654</h3>684</h3>

655 685

656Ob ein benutzerdefinierter Pfad das Standard-Verzeichnis des Plugins ersetzt oder erweitert, hängt vom Feld ab:686Ob ein benutzerdefinierter Pfad das Standard-Verzeichnis des Plugins ersetzt oder erweitert, hängt vom Feld ab:

657 687

658* **Ersetzt den Standard**: `commands`, `agents`, `outputStyles`, `experimental.themes`, `experimental.monitors`. Beispielsweise wird das Standard-Verzeichnis `commands/` nicht gescannt, wenn das Manifest `commands` angibt. Um den Standard zu behalten und mehr hinzuzufügen, listen Sie ihn explizit auf: `"commands": ["./commands/", "./extras/"]`688* **Ersetzt den Standard**: `commands`, `agents`, `workflows`, `outputStyles`, `experimental.themes`, `experimental.monitors`. Beispielsweise wird das Standard-`commands/`-Verzeichnis nicht gescannt, wenn das Manifest `commands` angibt. Um den Standard zu behalten und mehr hinzuzufügen, listen Sie ihn explizit auf: `"commands": ["./commands/", "./extras/"]`

659* **Fügt zum Standard hinzu**: `skills`. Das Standard-Verzeichnis `skills/` wird immer gescannt, und Verzeichnisse, die in `skills` aufgelistet sind, werden zusammen mit ihm geladen. Ausnahme: für einen [Marktplatz-Eintrag, dessen `source` zum Marktplatz-Root aufgelöst wird](/docs/de/plugin-marketplaces#advanced-plugin-entries), ersetzt das Deklarieren spezifischer Unterverzeichnisse den Scan689* **Ergänzt den Standard**: `skills`. Das Standard-`skills/`-Verzeichnis wird immer gescannt, und Verzeichnisse, die in `skills` aufgelistet sind, werden zusammen mit ihm geladen. Ausnahme: für einen [Marketplace-Eintrag, dessen `source` zum Marketplace-Root aufgelöst wird](/docs/de/plugin-marketplaces#advanced-plugin-entries), ersetzt das Deklarieren spezifischer Unterverzeichnisse den Standard-`skills/`-Scan

660* **Eigene Merge-Regeln**: [hooks](#hooks), [MCP-Server](#mcp-servers) und [LSP-Server](#lsp-servers). Siehe jeden Abschnitt für die Kombinationsweise mehrerer Quellen690* **Eigene Merge-Regeln**: [hooks](#hooks), [MCP-Server](#mcp-servers) und [LSP-Server](#lsp-servers). Siehe jeden Abschnitt, wie mehrere Quellen kombiniert werden

661 691

662Wenn ein Plugin sowohl einen Standard-Ordner als auch den entsprechenden Manifest-Schlüssel hat, kennzeichnet Claude Code v2.1.140 und später den ignorierten Ordner in `claude plugin list` und der `/plugin` Detailansicht. Das Plugin wird weiterhin mit den Manifest-Pfaden geladen. Es wird keine Warnung angezeigt, wenn der Manifest-Schlüssel auf den Standard-Ordner verweist, beispielsweise `"commands": ["./commands/deploy.md"]`, da der Ordner in diesem Fall explizit adressiert wird.692Wenn ein Plugin sowohl einen Standard-Ordner als auch den entsprechenden Manifest-Schlüssel hat, warnt Claude Code vor dem ignorierten Ordner in `claude plugin list` und der `/plugin`-Detailansicht. Das Plugin wird immer noch mit den Manifest-Pfaden geladen. Claude Code warnt nicht, wenn der Manifest-Schlüssel in den Standard-Ordner zeigt, beispielsweise `"commands": ["./commands/deploy.md"]`, da dieser Pfad den Ordner explizit benennt.

663 693

664Für alle Pfadfelder:694Für alle Pfadfelder:

665 695

666* Alle Pfade müssen relativ zum Plugin-Root sein und mit `./` beginnen696* Alle Pfade müssen relativ zum Plugin-Root sein und mit `./` beginnen, außer dass das Feld `skills` auch `"."` akzeptiert

697 * Sowohl `"."` als auch `"./"` bezeichnen den Plugin-Root selbst

698 * Vor v2.1.221 schlug `"."` bei der Manifest-Validierung fehl und das Plugin wurde nicht geladen, daher verwenden Sie `"./"`, um frühere Versionen zu unterstützen

667* Komponenten aus benutzerdefinierten Pfaden verwenden die gleichen Benennungs- und Namensgebungsregeln699* Komponenten aus benutzerdefinierten Pfaden verwenden die gleichen Benennungs- und Namensgebungsregeln

668* Mehrere Pfade können als Arrays angegeben werden700* Mehrere Pfade können als Arrays angegeben werden

669* Wenn ein Skill-Pfad auf ein Verzeichnis verweist, das direkt ein `SKILL.md` enthält, beispielsweise `"skills": ["./"]` verweist auf den Plugin-Root, bestimmt das Frontmatter-Feld `name` in `SKILL.md` den Aufrufen-Namen des Skills. Dies gibt einen stabilen Namen unabhängig vom Installationsverzeichnis. Wenn `name` nicht im Frontmatter gesetzt ist, wird der Verzeichnis-Basename als Fallback verwendet.701* Ein Skill-Pfad kann auf ein Verzeichnis zeigen, das direkt ein `SKILL.md` enthält, beispielsweise `"skills": ["."]` für den Plugin-Root

702 * Claude Code nimmt den Invokationsnamen des Skills aus dem Frontmatter-Feld `name` in `SKILL.md`, daher bleibt der Name stabil, egal wie das Installationsverzeichnis benannt ist

703 * Falls `name` nicht im Frontmatter gesetzt ist, fällt Claude Code auf den Verzeichnis-Basename zurück

670 704

671Ein Plugin, das ein `SKILL.md` in seinem Root hat, kein `skills/` Unterverzeichnis und kein `skills` Manifest-Feld hat, wird automatisch als Single-Skill-Plugin in Claude Code v2.1.142 und später geladen. Sie müssen `"skills": ["./"]` in `plugin.json` für dieses Layout nicht setzen. Der Aufrufen-Name des Skills folgt der gleichen Regel wie oben: das Frontmatter-Feld `name` oder der Verzeichnis-Basename als Fallback.705Ein Plugin, das ein `SKILL.md` an seinem Root hat, kein `skills/`-Unterverzeichnis und kein `skills`-Manifest-Feld, wird automatisch als Single-Skill-Plugin geladen. Sie müssen `"skills": ["./"]` in `plugin.json` für dieses Layout nicht setzen.

672 706

673**Pfad-Beispiele**:707**Pfadbeispiele**:

674 708

675```json theme={null}709```json theme={null}

676{710{

689 Umgebungsvariablen723 Umgebungsvariablen

690</h3>724</h3>

691 725

692Claude Code bietet drei Variablen zum Referenzieren von Pfaden:726Claude Code stellt drei Variablen zum Referenzieren von Pfaden bereit:

693 727

695| :---------------------- | :--------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |729| :---------------------- | :---------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- |

696| `${CLAUDE_PLUGIN_ROOT}` | Absoluter Pfad zum Installationsverzeichnis des Plugins | Skripte, Binärdateien und Konfigurationsdateien, die mit dem Plugin gebündelt sind |730| `${CLAUDE_PLUGIN_ROOT}` | Absoluter Pfad zum Installationsverzeichnis des Plugins | Skripte, Binärdateien und Konfigurationsdateien, die mit dem Plugin gebündelt sind |

697| `${CLAUDE_PLUGIN_DATA}` | [Persistentes Verzeichnis](#persistent-data-directory), das Plugin-Updates überlebt, wird beim ersten Verweis erstellt | Installierte Abhängigkeiten wie `node_modules` oder Python-Umgebungen, generierter Code und Caches |731| `${CLAUDE_PLUGIN_DATA}` | [Persistentes Verzeichnis](#persistent-data-directory), das Plugin-Updates überlebt, beim ersten Zugriff erstellt | Installierte Abhängigkeiten wie `node_modules` oder Python-Virtualumgebungen, generierter Code und Caches |

698| `${CLAUDE_PROJECT_DIR}` | Das Projekt-Root | Projektlokale Skripte und Konfigurationsdateien |732| `${CLAUDE_PROJECT_DIR}` | Der Projekt-Root | Projektlokale Skripte und Konfigurationsdateien |

699 733

700Alle drei werden als Umgebungsvariablen an Hook-Prozesse und an MCP- und LSP-Server-Subprozesse exportiert. Welche Felder sie inline ersetzen, hängt von der Plugin-Komponente ab:734Alle drei werden als Umgebungsvariablen an Hook-Prozesse und an MCP- und LSP-Server-Subprozesse exportiert. Welche Felder sie inline ersetzen, hängt von der Plugin-Komponente ab:

701 735

702| Plugin-Komponente | Felder, in denen Platzhalter aufgelöst werden |736| Plugin-Komponente | Felder, in denen Platzhalter aufgelöst werden |

703| :----------------------------- | :-------------------------------------------- |737| :----------------------------- | :-------------------------------------------- |

704| Skill- und Agent-Inhalte | Überall dort, wo der Platzhalter erscheint |738| Skill- und Agent-Inhalte | Überall, wo der Platzhalter erscheint |

705| Hook- und Monitor-Befehle | Überall dort, wo der Platzhalter erscheint |739| Hook- und Monitor-Befehle | Überall, wo der Platzhalter erscheint |

709 743

710In Hook-Befehlen verwenden Sie [Exec-Form](/docs/de/hooks#exec-form-and-shell-form) mit `args`, damit jeder Pfad als ein Argument ohne Anführungszeichen übergeben wird. In Shell-Form-Hooks und Monitor-Befehlen wickeln Sie die Variablen in doppelte Anführungszeichen ein, wie in `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`. Dieser Shell-Form-Hook führt ein mit einem Plugin gebündeltes Skript aus:744In Hook-Befehlen verwenden Sie [exec-Form](/docs/de/hooks#exec-form-and-shell-form) mit `args`, damit jeder Pfad als ein Argument ohne Anführungszeichen übergeben wird. In Shell-Form-Hooks und Monitor-Befehlen wickeln Sie die Variablen in doppelte Anführungszeichen ein, wie in `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`. Dieser Shell-Form-Hook führt ein mit einem Plugin gebündeltes Skript aus:

711 745

712```json theme={null}746```json theme={null}

713{747{

726}760}

727```761```

728 762

729`${CLAUDE_PLUGIN_ROOT}` ändert sich, wenn das Plugin aktualisiert wird. Das Verzeichnis der vorherigen Version bleibt etwa sieben Tage nach einem Update auf der Festplatte, bevor es bereinigt wird, aber behandeln Sie es als kurzlebig und schreiben Sie keinen Status dort.763`${CLAUDE_PLUGIN_ROOT}` ändert sich, wenn das Plugin aktualisiert wird. Das Verzeichnis der vorherigen Version bleibt für einen Übergangszeitraum nach einem Update auf der Festplatte, aber behandeln Sie es als kurzlebig und schreiben Sie keinen Zustand dorthin. Siehe [Plugin-Caching](#plugin-caching-and-file-resolution) für Cleanup-Semantik.

730 764

731Wenn ein Plugin während einer Sitzung aktualisiert wird, verwenden Hook-Befehle, Monitore, MCP-Server und LSP-Server weiterhin den Pfad der vorherigen Version. Führen Sie `/reload-plugins` aus, um Hooks, MCP-Server und LSP-Server auf den neuen Pfad umzuschalten; Monitore erfordern einen Neustart der Sitzung.765Wenn ein Plugin während einer Sitzung aktualisiert wird, verwenden Hook-Befehle, Monitore, MCP-Server und LSP-Server weiterhin den Pfad der vorherigen Version. Führen Sie `/reload-plugins` aus, um Hooks, MCP-Server und LSP-Server zum neuen Pfad zu wechseln; Monitore erfordern einen Sitzungsneustart. Für ein Plugin mit einer `command`-Quelle kann Claude Code [das Plugin selbst neu laden](/docs/de/plugin-marketplaces#when-claude-code-re-runs-the-command).

732 766

733MCP-Server können auch die `roots/list` Anfrage aufrufen, um die Arbeitsverzeichnisse der Sitzung zur Laufzeit zu lesen. Siehe [was `roots/list` zurückgibt und wann Claude Code den Server über Änderungen benachrichtigt](/docs/de/mcp#option-3-add-a-local-stdio-server).767MCP-Server können auch die `roots/list`-Anfrage aufrufen, um die Arbeitsverzeichnisse der Sitzung zur Laufzeit zu lesen. Siehe [was `roots/list` zurückgibt und wann Claude Code den Server über Änderungen benachrichtigt](/docs/de/mcp#option-3-add-a-local-stdio-server).

734 768

735<h4 id="persistent-data-directory">769<h4 id="persistent-data-directory">

736 Persistentes Datenverzeichnis770 Persistentes Datenverzeichnis

737</h4>771</h4>

738 772

739Das `${CLAUDE_PLUGIN_DATA}` Verzeichnis wird zu `~/.claude/plugins/data/{id}/` aufgelöst, wobei `{id}` der Plugin-Bezeichner mit Zeichen außerhalb von `a-z`, `A-Z`, `0-9`, `_` und `-` ist, die durch `-` ersetzt werden. Für ein Plugin, das als `formatter@my-marketplace` installiert ist, ist das Verzeichnis `~/.claude/plugins/data/formatter-my-marketplace/`.773Das Verzeichnis `${CLAUDE_PLUGIN_DATA}` wird zu `~/.claude/plugins/data/{id}/` aufgelöst, wobei `{id}` der Plugin-Bezeichner mit Zeichen außerhalb von `a-z`, `A-Z`, `0-9`, `_` und `-` ist, die durch `-` ersetzt werden. Für ein Plugin, das als `formatter@my-marketplace` installiert ist, ist das Verzeichnis `~/.claude/plugins/data/formatter-my-marketplace/`.

740 774

741Eine häufige Verwendung ist die einmalige Installation von Sprachabhängigkeiten und deren Wiederverwendung über Sessions und Plugin-Updates hinweg. Da das Datenverzeichnis länger lebt als jede einzelne Plugin-Version, kann eine Überprüfung auf Verzeichnisexistenz allein nicht erkennen, wenn ein Update das Abhängigkeitsmanifest des Plugins ändert. Das empfohlene Muster vergleicht das gebündelte Manifest mit einer Kopie im Datenverzeichnis und installiert neu, wenn sie sich unterscheiden.775Eine häufige Verwendung ist die einmalige Installation von Sprachabhängigkeiten und deren Wiederverwendung über Sitzungen und Plugin-Updates hinweg. Verwenden Sie es für Python-Abhängigkeiten, Abhängigkeiten, die mit Yarn oder pnpm gesperrt sind, und Pakete, deren Lifecycle-Skripte ausgeführt werden müssen. Für ein Marketplace-installiertes Plugin benötigen Sie es möglicherweise überhaupt nicht: Claude Code installiert automatisch berechtigte [Node.js-Paketabhängigkeiten](#node-js-package-dependencies), wenn es das Plugin zwischenspeichert.

742 776

743Dieser `SessionStart` Hook installiert `node_modules` beim ersten Durchlauf und erneut, wenn ein Plugin-Update ein geändertes `package.json` enthält:777Da das Datenverzeichnis länger lebt als jede einzelne Plugin-Version, kann eine Überprüfung auf Verzeichnisexistenz allein nicht erkennen, wenn ein Update das Abhängigkeitsmanifest des Plugins ändert. Das empfohlene Muster vergleicht das gebündelte Manifest mit einer Kopie im Datenverzeichnis und installiert neu, wenn sie sich unterscheiden.

778

779Dieser `SessionStart`-Hook installiert `node_modules` beim ersten Durchlauf und erneut, wenn ein Plugin-Update ein geändertes `package.json` enthält:

744 780

745```json theme={null}781```json theme={null}

746{782{

759}795}

760```796```

761 797

762Der `diff` beendet sich mit Nonzero, wenn die gespeicherte Kopie fehlt oder sich vom gebündelten unterscheidet, was sowohl den ersten Durchlauf als auch abhängigkeitsändernde Updates abdeckt. Wenn `npm install` fehlschlägt, entfernt das nachfolgende `rm` das kopierte Manifest, damit die nächste Session erneut versucht.798Der `diff` beendet sich mit Nonzero, wenn die gespeicherte Kopie fehlt oder sich vom gebündelten unterscheidet, was sowohl den ersten Durchlauf als auch abhängigkeitsändernde Updates abdeckt. Falls `npm install` fehlschlägt, entfernt das nachfolgende `rm` das kopierte Manifest, damit die nächste Sitzung es erneut versucht.

763 799

764Skripte, die in `${CLAUDE_PLUGIN_ROOT}` gebündelt sind, können dann gegen die persistierten `node_modules` ausgeführt werden:800Skripte, die in `${CLAUDE_PLUGIN_ROOT}` gebündelt sind, können dann gegen die persistierten `node_modules` ausgeführt werden:

765 801

777}813}

778```814```

779 815

780Das Datenverzeichnis wird automatisch gelöscht, wenn Sie das Plugin aus dem letzten Bereich deinstallieren, in dem es installiert ist. Die `/plugin` Schnittstelle zeigt die Verzeichnisgröße an und fragt vor dem Löschen. Die CLI löscht standardmäßig; übergeben Sie [`--keep-data`](#plugin-uninstall), um es zu bewahren.816Das Datenverzeichnis wird automatisch gelöscht, wenn Sie das Plugin aus dem letzten Bereich deinstallieren, in dem es installiert ist. Die `/plugin`-Schnittstelle zeigt die Verzeichnisgröße an und fordert vor dem Löschen auf. Die CLI löscht standardmäßig; übergeben Sie [`--keep-data`](#plugin-uninstall), um es zu behalten.

781 817

782***818***

783 819

787 823

788Plugins werden auf eine von zwei Arten angegeben:824Plugins werden auf eine von zwei Arten angegeben:

789 825

790* Durch `claude --plugin-dir` oder `claude --plugin-url`, für die Dauer einer Session.826* Über `claude --plugin-dir` oder `claude --plugin-url` für die Dauer einer Sitzung.

791* Durch einen Marktplatz, installiert für zukünftige Sessions.827* Über einen Marketplace, installiert für zukünftige Sitzungen.

828

829Aus Sicherheits- und Verifizierungsgründen kopiert Claude Code *Marketplace*-Plugins in den lokalen **Plugin-Cache** des Benutzers (`~/.claude/plugins/cache`), anstatt sie an Ort und Stelle zu verwenden, mit Ausnahme von [`command`-Quellen im Link-Modus](/docs/de/plugin-marketplaces#copy-mode-and-link-mode), die Claude Code an Ort und Stelle über Links im Cache-Eintrag verwendet.

830

831Für kopierte Plugins ist jede installierte Version ein separates Verzeichnis im Cache, gruppiert nach Marketplace und Plugin und benannt nach der aufgelösten Version, mit einer eigenen Kopie der Plugin-Dateien und [Node.js-Paketabhängigkeiten](#node-js-package-dependencies). Eine Abhängigkeit, die von einem [Release-Tag](/docs/de/plugin-dependencies#tag-plugin-releases-for-version-resolution) aufgelöst wird, erhält einen Verzeichnisnamen mit einem Commit-SHA-Suffix.

832

833Wenn Sie ein Plugin aktualisieren oder deinstallieren, markiert Claude Code das vorherige Versionsverzeichnis als verwaist und entfernt es in einem Hintergrund-Sweep ungefähr 14 Tage später. Die Kulanzfrist ermöglicht es gleichzeitigen Claude Code-Sitzungen, die bereits die alte Version geladen haben, ohne Fehler weiter zu laufen. Claude Code führt den Sweep nur aus, wenn mindestens ein Plugin installiert ist; nachdem Sie Ihr letztes Plugin deinstalliert haben, bleiben verwaiste Verzeichnisse auf der Festplatte, bis Sie ein Plugin erneut installieren.

834

835Claude Code entfernt einen Plugin- oder Marketplace-Ordner aus dem Cache nur, wenn er kein Verzeichnis oder Symlink mehr enthält. Wenn Sie einen Entwicklungs-Checkout als Versionseinträge eines Plugins in den Cache symlinken, markiert Claude Code den Link niemals als verwaist und entfernt ihn oder die Ordner, die ihn enthalten, niemals. Claude Code schreibt auch niemals seine Versions-Tracking-Dateien in den verlinkten Checkout.

836

837Die Glob- und Grep-Tools von Claude überspringen verwaiste Versionsverzeichnisse während Suchen, sodass Dateiergebnisse keinen veralteten Plugin-Code enthalten.

838

839<h3 id="node-js-package-dependencies">

840 Node.js-Paketabhängigkeiten

841</h3>

842

843Wenn Claude Code ein Plugin in den Cache kopiert, installiert es auch die Node.js-Paketabhängigkeiten des Plugins dort, damit die Hooks und MCP-Server des Plugins diese laden können. Dieser Abschnitt behandelt die npm- und Bun-Pakete, die ein Plugin in seiner eigenen `package.json` deklariert. Für Plugins, die von anderen Plugins abhängen, siehe [Plugin-Abhängigkeitsversionen](/docs/de/plugin-dependencies).

844

845Claude Code führt die Installation im kopierten Versionsverzeichnis jedes Mal aus, wenn es eines erstellt: wenn Sie ein Plugin installieren, wenn Claude Code ein Plugin auf eine neue Version aktualisiert, und beim Sitzungsstart, wenn ein aktiviertes Plugin noch nicht zwischengespeichert ist, z. B. auf einem neuen Computer. Die Installation wird nur ausgeführt, wenn das Plugin-Stammverzeichnis sowohl eine `package.json` als auch eine unterstützte Sperrdatei enthält:

792 846

793Aus Sicherheits- und Verifizierungsgründen kopiert Claude Code *Marktplatz*-Plugins in den lokalen **Plugin-Cache** des Benutzers (`~/.claude/plugins/cache`), anstatt sie an Ort und Stelle zu verwenden. Das Verständnis dieses Verhaltens ist wichtig, wenn Sie Plugins entwickeln, die auf externe Dateien verweisen.847| Sperrdatei | Befehl |

848| :--------------------------------------------- | :----------------------------------------------- |

849| `bun.lock` oder `bun.lockb` | `bun install --frozen-lockfile --ignore-scripts` |

850| `npm-shrinkwrap.json` oder `package-lock.json` | `npm ci --ignore-scripts` |

794 851

795Jede installierte Version ist ein separates Verzeichnis im Cache. Wenn Sie ein Plugin aktualisieren oder deinstallieren, wird das vorherige Versionsverzeichnis als verwaist markiert und automatisch 7 Tage später entfernt. Die Gnadenfrist ermöglicht es gleichzeitigen Claude Code Sessions, die bereits die alte Version geladen haben, ohne Fehler weiter zu laufen.852Wenn ein Plugin mehr als eine dieser Sperrdateien enthält, verwendet Claude Code die erste Übereinstimmung und prüft in dieser Reihenfolge: `bun.lock`, `bun.lockb`, `npm-shrinkwrap.json`, `package-lock.json`. Claude Code überspringt `yarn.lock` und `pnpm-lock.yaml`, da Yarn und pnpm Konfigurationshooks zur Auflösungszeit unterstützen, die `--ignore-scripts` umgehen.

796 853

797Claudes Glob- und Grep-Tools überspringen verwaiste Versionsverzeichnisse während Suchen, daher enthalten Dateiergebnisse keinen veralteten Plugin-Code.854Versenden Sie eine npm-Sperrdatei für die größtmögliche Reichweite. Claude Code führt den Paketmanager der übereinstimmenden Sperrdatei aus dem PATH des Benutzers aus und fällt nicht auf die andere Sperrdatei zurück, wenn sie fehlt. Verwenden Sie für ein Plugin, das über eine npm-Quelle verteilt wird, `npm-shrinkwrap.json`; npm schließt `package-lock.json` aus veröffentlichten Paketen aus.

855

856Claude Code beschränkt diese Abhängigkeitsinstallation so, dass während der Installation kein Code aus dem Plugin oder seinen Paketen ausgeführt wird, und begrenzt, wie lange sie ausgeführt werden kann:

857

858* **Gefrorene Auflösung:** Bun und npm installieren genau das, was die Sperrdatei festlegt, und schlagen fehl, anstatt Versionen erneut aufzulösen, wenn `package.json` und die Sperrdatei nicht übereinstimmen.

859* **Keine Lifecycle-Skripte:** `--ignore-scripts` verhindert, dass `preinstall`-, `install`- und `postinstall`-Skripte ausgeführt werden, sodass Abhängigkeiten, die native Module in diesen Skripten erstellen, heruntergeladen, aber während dieser Installation nicht kompiliert werden.

860* **60-Sekunden-Timeout:** Claude Code stoppt eine Installation, die länger läuft, und behandelt sie als fehlgeschlagen.

861

862Das Abrufen eines npm-Quellen-Plugins selbst führt `npm install` mit aktivierten Lifecycle-Skripten aus, bevor diese Abhängigkeitsinstallation ausgeführt wird.

863

864Eine fehlgeschlagene oder übersprungene Installation blockiert das Plugin niemals. Wenn die Installation fehlschlägt oder Claude Code eine yarn- oder pnpm-Sperrdatei überspringt, wird der Grund als Warnung in der [Debug-Ausgabe](#debugging-commands) aufgezeichnet. Ein Plugin mit einer `package.json` und ohne Sperrdatei wird ohne Logeintrag übersprungen. Eine Timeout-Installation kann einen partiellen `node_modules`-Baum in der zwischengespeicherten Kopie hinterlassen.

865

866Sie können die automatische Installation nicht ausschalten; keine Einstellung oder Umgebungsvariable deaktiviert sie. In eingeschränkten Netzwerken siehe die [Netzwerkzugriffsanforderungen](/docs/de/network-config#network-access-requirements) für die Hosts, die Sie zulassen müssen.

867

868Für Abhängigkeiten, die die automatische Installation nicht bereitstellen kann, z. B. Pakete, die ihre Lifecycle-Skripte zum Erstellen benötigen, Python-Abhängigkeiten oder ein Plugin, das mit Yarn oder pnpm gesperrt ist, installieren Sie diese von einem Hook in das [persistente Datenverzeichnis](#persistent-data-directory).

798 869

799<h3 id="path-traversal-limitations">870<h3 id="path-traversal-limitations">

800 Pfad-Traversal-Einschränkungen871 Einschränkungen bei der Pfadtraversierung

801</h3>872</h3>

802 873

803Installierte Plugins können nicht auf Dateien außerhalb ihres Verzeichnisses verweisen. Pfade, die außerhalb des Plugin-Root traversieren (wie `../shared-utils`), funktionieren nach der Installation nicht, da diese externen Dateien nicht in den Cache kopiert werden.874Claude Code erlaubt einem Plugin nicht, auf Dateien außerhalb seines eigenen Verzeichnisses zu verweisen. Es lehnt einen Komponentenpfad ab, der außerhalb des Plugin-Stammverzeichnisses aufgelöst wird, unabhängig davon, ob der Pfad in `plugin.json` oder in einem [Marketplace-Eintrag](/docs/de/plugin-marketplaces#plugin-entries) deklariert ist. Dies umfasst einen Pfad, der außerhalb des Plugins verweist, wie geschrieben, z. B. `../shared-utils`, und einen Symlink, der außerhalb des Plugins führt, mit Ausnahme von [Links innerhalb eines Marketplace](#share-files-within-a-marketplace-with-symlinks).

875

876Wenn Claude Code einen Pfad ablehnt, meldet es einen [`path escapes plugin directory`](/docs/de/errors#path-escapes-plugin-directory)-Fehler und lädt das Plugin ohne diese Komponente.

877

878Claude Code kopiert auch keine Dateien außerhalb des Plugin-Verzeichnisses in den Cache, wenn es das Plugin installiert. Wenn also ein Skript in einem kopierten Plugin einen Pfad über dem Plugin-Stammverzeichnis liest, findet es diese Dateien auch nicht.

804 879

805<h3 id="share-files-within-a-marketplace-with-symlinks">880<h3 id="share-files-within-a-marketplace-with-symlinks">

806 Dateien innerhalb eines Marktplatzes mit Symlinks freigeben881 Dateien innerhalb eines Marketplace mit Symlinks freigeben

807</h3>882</h3>

808 883

809Wenn Ihr Plugin Dateien mit anderen Teilen desselben Marktplatzes freigeben muss, können Sie symbolische Links in Ihrem Plugin-Verzeichnis erstellen. Wie ein Symlink behandelt wird, wenn das Plugin in den Cache kopiert wird, hängt davon ab, wo sein Ziel aufgelöst wird:884Wenn Ihr Plugin Dateien mit anderen Teilen desselben Marketplace freigeben muss, können Sie symbolische Links in Ihrem Plugin-Verzeichnis erstellen. Wie ein Symlink behandelt wird, wenn das Plugin in den Cache kopiert wird, hängt davon ab, wo sein Ziel aufgelöst wird:

810 885

811* **Innerhalb des eigenen Verzeichnisses des Plugins:** Der Symlink wird als relativer Symlink im Cache beibehalten, sodass er zur Laufzeit weiterhin zum kopierten Ziel aufgelöst wird.886* **Innerhalb des eigenen Verzeichnisses des Plugins:** Der Symlink wird als relativer Symlink im Cache beibehalten, sodass er zur Laufzeit weiterhin zum kopierten Ziel aufgelöst wird.

812* **Anderswo innerhalb desselben Marktplatzes:** Der Symlink wird dereferenziert. Der Inhalt des Ziels wird stattdessen in den Cache kopiert. Dies ermöglicht es einem Meta-Plugin, sein `skills/`-Verzeichnis mit Skills zu verknüpfen, die von anderen Plugins im Marktplatz definiert werden.887* **Anderswo innerhalb desselben Marketplace:** Der Symlink wird dereferenziert. Der Inhalt des Ziels wird an seiner Stelle in den Cache kopiert. Dies ermöglicht es dem `skills/`-Verzeichnis eines Meta-Plugins, auf Skills zu verlinken, die von anderen Plugins im Marketplace definiert werden.

813* **Außerhalb des Marktplatzes:** Der Symlink wird aus Sicherheitsgründen übersprungen. Dies verhindert, dass Plugins beliebige Host-Dateien wie Systempfade in den Cache ziehen.888* **Außerhalb des Marketplace:** Der Symlink wird aus Sicherheitsgründen übersprungen. Dies verhindert, dass Plugins beliebige Host-Dateien wie Systempfade in den Cache ziehen.

814 889

815Für Plugins, die mit `--plugin-dir` installiert oder aus einem lokalen Pfad installiert werden, werden nur Symlinks beibehalten, die sich innerhalb des eigenen Verzeichnisses des Plugins auflösen. Alle anderen werden übersprungen.890Für Plugins, die mit `--plugin-dir` installiert sind, von einem lokalen Pfad oder von einer [`command`-Quelle](/docs/de/plugin-marketplaces#copy-mode-and-link-mode) im Copy-Modus, werden nur Symlinks beibehalten, die innerhalb des eigenen Verzeichnisses des Plugins aufgelöst werden. Alle anderen werden übersprungen.

816 891

817Der folgende Befehl erstellt einen Link von innerhalb eines Marktplatz-Plugins zu einem gemeinsamen Skill, der von einem Geschwister-Plugin definiert wird. Verwenden Sie unter Windows `mklink /D` von einer erhöhten Eingabeaufforderung oder aktivieren Sie den Entwicklermodus:892Der folgende Befehl erstellt einen Link von innerhalb eines Marketplace-Plugins zu einem gemeinsamen Skill, der von einem Sibling-Plugin definiert wird. Verwenden Sie unter Windows `mklink /D` von einer erhöhten Eingabeaufforderung oder aktivieren Sie den Entwicklermodus:

818 893

819```bash theme={null}894```bash theme={null}

820ln -s ../../shared-plugin/skills/foo ./skills/foo895ln -s ../../shared-plugin/skills/foo ./skills/foo

821```896```

822 897

823Dies bietet Flexibilität bei Beibehaltung der Sicherheitsvorteile des Caching-Systems.

~~824~~

825***898***

826 899

827<h2 id="plugin-directory-structure">900<h2 id="plugin-directory-structure">

828 Plugin-Verzeichnisstruktur901 Verzeichnisstruktur von Plugins

829</h2>902</h2>

830 903

831<h3 id="standard-plugin-layout">904<h3 id="standard-plugin-layout">

844│ └── pdf-processor/917│ └── pdf-processor/

845│ ├── SKILL.md918│ ├── SKILL.md

846│ └── scripts/919│ └── scripts/

847├── commands/ # Skills als flache .md Dateien920├── commands/ # Skills als flache .md-Dateien

848│ ├── status.md921│ ├── status.md

849│ └── logs.md922│ └── logs.md

850├── agents/ # Subagent-Definitionen923├── agents/ # Subagent-Definitionen

851│ ├── security-reviewer.md924│ ├── security-reviewer.md

852│ ├── performance-tester.md925│ ├── performance-tester.md

853│ └── compliance-checker.md926│ └── compliance-checker.md

854├── output-styles/ # Output-Style-Definitionen927├── workflows/ # Workflow-Skripte

928│ └── release-audit.js

929├── output-styles/ # Ausgabestil-Definitionen

855│ └── terse.md930│ └── terse.md

856├── themes/ # Farbschema-Definitionen931├── themes/ # Farbschema-Definitionen

857│ └── dracula.json932│ └── dracula.json

861│ ├── hooks.json # Haupt-Hook-Konfiguration936│ ├── hooks.json # Haupt-Hook-Konfiguration

862│ └── security-hooks.json # Zusätzliche Hooks937│ └── security-hooks.json # Zusätzliche Hooks

863├── bin/ # Plugin-Ausführbare Dateien, die zu PATH hinzugefügt werden938├── bin/ # Plugin-Ausführbare Dateien, die zu PATH hinzugefügt werden

864│ └── my-tool # Aufrufbar als bloßer Befehl im Bash-Tool939│ └── my-tool # Aufrufbar als einfacher Befehl im Bash-Tool

865├── settings.json # Standardeinstellungen für das Plugin940├── settings.json # Standardeinstellungen für das Plugin

866├── .mcp.json # MCP-Server-Definitionen941├── .mcp.json # MCP-Server-Definitionen

867├── .lsp.json # LSP-Server-Konfigurationen942├── .lsp.json # LSP-Server-Konfigurationen

874```949```

875 950

876<Warning>951<Warning>

877 Das `.claude-plugin/` Verzeichnis enthält die `plugin.json` Datei. Alle anderen Verzeichnisse (commands/, agents/, skills/, output-styles/, themes/, monitors/, hooks/) müssen sich im Plugin-Root befinden, nicht innerhalb von `.claude-plugin/`.952 Das `.claude-plugin/`-Verzeichnis enthält die `plugin.json`-Datei. Alle anderen Verzeichnisse (commands/, agents/, skills/, workflows/, output-styles/, themes/, monitors/, hooks/) müssen sich im Plugin-Stammverzeichnis befinden, nicht innerhalb von `.claude-plugin/`.

878</Warning>953</Warning>

879 954

880Eine `CLAUDE.md` Datei im Plugin-Root wird nicht als Projektkontext geladen. Plugins tragen Kontext durch Skills, Agents und Hooks bei, anstatt durch CLAUDE.md. Um Anweisungen bereitzustellen, die in Claudes Kontext geladen werden, fügen Sie diese in einen [Skill](#skills) ein.955Eine `CLAUDE.md`-Datei im Plugin-Stammverzeichnis wird nicht als Projektkontext geladen. Plugins tragen Kontext durch Skills, Agents und Hooks bei, nicht durch CLAUDE.md. Um Anweisungen bereitzustellen, die in Claudes Kontext geladen werden, platzieren Sie diese in einem [Skill](#skills).

881 956

882<h3 id="file-locations-reference">957<h3 id="file-locations-reference">

883 Datei-Speicherorte-Referenz958 Dateistandorte-Referenz

884</h3>959</h3>

885 960

887| :---------------------- | :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |962| :---------------------- | :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

969| **Designs** | `themes/` | Farbschema-Definitionen |

898| **Ausführbare Dateien** | `bin/` | Ausführbare Dateien, die zum Bash-Tool `PATH` hinzugefügt werden. Dateien hier sind als bloße Befehle in jedem Bash-Tool-Aufruf aufrufbar, während das Plugin aktiviert ist |974| **Ausführbare Dateien** | `bin/` | Ausführbare Dateien, die zum `PATH` des Bash-Tools hinzugefügt werden und als einfache Befehle aufrufbar sind, während das Plugin aktiviert ist. Sie können dieses Verzeichnis nicht in ein Plugin einbeziehen, das Sie [über die Organisationseinstellungen von claude.ai verteilen](/docs/de/plugin-marketplaces#keep-executables-out-of-the-top-level-bin-directory) |

899| **Einstellungen** | `settings.json` | Standardkonfiguration, die angewendet wird, wenn das Plugin aktiviert wird. Derzeit werden nur die [`agent`](/docs/de/sub-agents) und [`subagentStatusLine`](/docs/de/statusline#subagent-status-lines) Schlüssel unterstützt |975| **Einstellungen** | `settings.json` | Standardkonfiguration, die angewendet wird, wenn das Plugin aktiviert ist. Nur die [`agent`](/docs/de/sub-agents)- und [`subagentStatusLine`](/docs/de/statusline#subagent-status-lines)-Schlüssel werden unterstützt |

900 976

901***977***

902 978

903<h2 id="cli-commands-reference">979<h2 id="cli-commands-reference">

904 CLI-Befehle-Referenz980 CLI-Befehle – Referenz

905</h2>981</h2>

906 982

907Claude Code bietet CLI-Befehle für nicht-interaktive Plugin-Verwaltung, nützlich für Scripting und Automatisierung.983Claude Code bietet CLI-Befehle für nicht-interaktive Plugin-Verwaltung, nützlich für Skripte und Automatisierung.

908 984

909<h3 id="plugin-init">985<h3 id="plugin-init">

910 plugin init986 plugin init

911</h3>987</h3>

912 988

913Erstellen Sie ein neues Plugin unter `~/.claude/skills/<name>/`. In der nächsten Claude Code Session wird es automatisch als `<name>@skills-dir` geladen und erscheint in `/plugin` und `claude plugin list` ohne Installationsschritt.989Gerüst für ein neues Plugin unter `~/.claude/skills/<name>/` erstellen. In der nächsten Claude Code-Sitzung wird es automatisch als `<name>@skills-dir` geladen und erscheint in `/plugin` und `claude plugin list` ohne Installationsschritt.

914 990

915Siehe [Skills-Verzeichnis-Plugins](#skills-directory-plugins) für Bereichs- und Vertrauensanforderungen.991Siehe [Skills-directory plugins](#skills-directory-plugins) für Umfang und Vertrauensanforderungen.

916 992

917```bash theme={null}993```bash theme={null}

918claude plugin init <name> [options]994claude plugin init <name> [options]

920 996

921**Argumente:**997**Argumente:**

922 998

923* `<name>`: Plugin-Name. Wird zum Skill-Namespace und zum Verzeichnisnamen unter `~/.claude/skills/`, daher kann er keine Leerzeichen oder Pfad-Trennzeichen enthalten.999* `<name>`: Plugin-Name. Wird zum Skill-Namespace und zum Verzeichnisnamen unter `~/.claude/skills/`, daher darf er keine Leerzeichen oder Pfad-Trennzeichen enthalten.

924 1000

925**Optionen:**1001**Optionen:**

926 1002

928| :----------------------- | :-------------------------------------------------------------------------------------------------------------------- | :---------------------- |1004| :----------------------- | :------------------------------------------------------------------------------------------------------------------- | :---------------------- |

932| `--with <components...>` | Auch Komponentenordner erstellen. Gültige Werte: `skills`, `agents`, `hooks`, `mcp`, `lsp`, `output-style`, `channel` | |1008| `--with <components...>` | Auch Komponentenordner gerüsten. Gültige Werte: `skills`, `agents`, `hooks`, `mcp`, `lsp`, `output-style`, `channel` | |

935 1011

936**Aliase:** `new`1012**Aliase:** `new`

937 1013

938Jeder `--with` Wert fügt eine Starter-Datei für diese Komponente hinzu, bereit zum Bearbeiten:1014Jeder `--with`-Wert fügt eine Starter-Datei für diese Komponente hinzu, bereit zum Bearbeiten:

939 1015

940| Komponente | Was es erstellt |1016| Komponente | Was es gerüstet |

941| :------------- | :--------------------------------------------------------------------------------------------------------------- |1017| :------------- | :------------------------------------------------------------------------------------------------------------------- |

945| `mcp` | Eine `.mcp.json` mit HTTP- und stdio-Server-Beispielen |1021| `mcp` | Eine `.mcp.json` mit HTTP- und Stdio-Server-Beispielen |

946| `lsp` | Eine `.lsp.json` Language-Server-Beispiel |1022| `lsp` | Ein `.lsp.json`-Language-Server-Beispiel |

948| `channel` | Ein MCP-basierter [Kanal](/docs/de/channels): ein stdio-Server (`server.ts`), sein `.mcp.json` und ein `package.json` |1024| `channel` | Ein MCP-basierter [channel](/docs/de/channels): ein Stdio-Server (`server.ts`), seine `.mcp.json` und eine `package.json` |

949 1025

950Das erstellte Plugin verwendet die `@skills-dir` Quelle anstelle eines Marktplatzes. Administratoren können diese Quelle mit `strictKnownMarketplaces` blockieren oder indem sie `{"source": "skills-dir"}` zu `blockedMarketplaces` in [verwalteten Einstellungen](/docs/de/plugin-marketplaces#managed-marketplace-restrictions) hinzufügen. Wenn blockiert, schlägt `plugin init` fehl, bevor etwas geschrieben wird.1026Das gerüstete Plugin verwendet die `@skills-dir`-Quelle statt eines Marketplace. Administratoren können diese Quelle mit `strictKnownMarketplaces` blockieren oder indem sie `{"source": "skills-dir"}` zu `blockedMarketplaces` in [managed settings](/docs/de/plugin-marketplaces#managed-marketplace-restrictions) hinzufügen. Wenn blockiert, schlägt `plugin init` fehl, bevor etwas geschrieben wird.

951 1027

952**Beispiele:**1028**Beispiele:**

953 1029

954```bash theme={null}1030```bash theme={null}

955# Erstellen Sie ein minimales Plugin1031# Minimales Plugin gerüsten

956claude plugin init my-helper1032claude plugin init my-helper

957 1033

958# Erstellen Sie mit Skill- und Hook-Ordnern1034# Mit Skill- und Hook-Ordnern gerüsten

959claude plugin init my-helper --with skills hooks1035claude plugin init my-helper --with skills hooks

960 1036

961# Überschreiben Sie ein vorhandenes Gerüst1037# Vorhandenes Gerüst überschreiben

962claude plugin init my-helper --force1038claude plugin init my-helper --force

963```1039```

964 1040

966 plugin install1042 plugin install

967</h3>1043</h3>

968 1044

969Installieren Sie ein Plugin aus verfügbaren Marktplätzen.1045Ein Plugin aus verfügbaren Marketplaces installieren.

970 1046

971```bash theme={null}1047```bash theme={null}

972claude plugin install <plugin> [options]1048claude plugin install <plugin> [options]

974 1050

975**Argumente:**1051**Argumente:**

976 1052

977* `<plugin>`: Plugin-Name oder `plugin-name@marketplace-name` für einen bestimmten Marktplatz1053* `<plugin>`: Plugin-Name oder `plugin-name@marketplace-name` für einen bestimmten Marketplace

978 1054

979**Optionen:**1055**Optionen:**

980 1056

982| :-------------------- | :--------------------------------------------------- | :------- |1058| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------- |

1060| `--config <key=value>` | Setzen Sie eine [`userConfig`](#user-configuration)-Option, die im Plugin-Manifest deklariert ist. Wiederholen Sie das Flag, um mehrere Optionen zu setzen | |

1061| `-y, --yes` | Akzeptieren Sie einen Befehl, den der Marketplace des Plugins deklariert, ohne die Bestätigungsaufforderung: den Befehl, der ein Plugin mit einer [`command`-Quelle](/docs/de/plugin-marketplaces#command-sources) erzeugt, oder den [`headersHelper`](/docs/de/plugin-marketplaces#authenticate-archive-downloads), der einen Archiv-Download authentifiziert. Das Akzeptieren eines `headersHelper` erfordert Claude Code v2.1.238 oder später. Claude Code druckt den Befehl trotzdem zuerst. Erforderlich, wenn stdin oder stdout kein TTY ist. Hat keine Auswirkung innerhalb einer Claude Code-Sitzung, daher führen Sie den Befehl von Ihrem eigenen Terminal aus | |

985 1063

986Der Bereich bestimmt, welche Einstellungsdatei das installierte Plugin hinzugefügt wird. Beispielsweise schreibt `--scope project` zu `enabledPlugins` in .claude/settings.json, wodurch das Plugin für alle verfügbar wird, die das Projekt-Repository klonen.1064Der Umfang bestimmt, welche Einstellungsdatei das installierte Plugin hinzugefügt wird. Beispielsweise schreibt `--scope project` zu `enabledPlugins` in .claude/settings.json, wodurch das Plugin für alle verfügbar wird, die das Projekt-Repository klonen.

987 1065

988**Beispiele:**1066**Beispiele:**

989 1067

990```bash theme={null}1068```bash theme={null}

991# Installieren Sie im Benutzerbereich (Standard)1069# Im Benutzerumfang installieren (Standard)

992claude plugin install formatter@my-marketplace1070claude plugin install formatter@my-marketplace

993 1071

994# Installieren Sie im Projektbereich (geteilt mit Team)1072# Im Projektumfang installieren (mit Team geteilt)

995claude plugin install formatter@my-marketplace --scope project1073claude plugin install formatter@my-marketplace --scope project

996 1074

997# Installieren Sie im lokalen Bereich (gitignoriert)1075# Im lokalen Umfang installieren (nicht mit Team geteilt)

998claude plugin install formatter@my-marketplace --scope local1076claude plugin install formatter@my-marketplace --scope local

999```1077```

1000 1078

1002 plugin uninstall1080 plugin uninstall

1003</h3>1081</h3>

1004 1082

1005Entfernen Sie ein installiertes Plugin.1083Ein installiertes Plugin entfernen.

1006 1084

1007```bash theme={null}1085```bash theme={null}

1008claude plugin uninstall <plugin> [options]1086claude plugin uninstall <plugin> [options]

1015**Optionen:**1093**Optionen:**

1016 1094

1018| :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------- | :------- |1096| :-------------------- | :---------------------------------------------------------------------------------------------------------------------------- | :------- |

1021| `--prune` | Entfernen Sie auch automatisch installierte Abhängigkeiten, die kein anderes Plugin benötigt. Siehe [plugin prune](#plugin-prune) | |1099| `--prune` | Auch automatisch installierte Abhängigkeiten entfernen, die kein anderes Plugin benötigt. Siehe [plugin prune](#plugin-prune) | |

1022| `-y, --yes` | Überspringen Sie die `--prune` Bestätigungsaufforderung. Erforderlich, wenn stdin oder stdout kein TTY ist | |1100| `-y, --yes` | Bestätigungsaufforderung für `--prune` überspringen. Erforderlich, wenn stdin oder stdout kein TTY ist | |

1024 1102

1025**Aliase:** `remove`, `rm`1103**Aliase:** `remove`, `rm`

1026 1104

1027Standardmäßig löscht das Deinstallieren aus dem letzten verbleibenden Bereich auch das `${CLAUDE_PLUGIN_DATA}` Verzeichnis des Plugins. Verwenden Sie `--keep-data`, um es zu bewahren, beispielsweise beim Neuinstallieren nach dem Testen einer neuen Version.1105Standardmäßig werden beim Deinstallieren aus dem letzten verbleibenden Umfang auch das `${CLAUDE_PLUGIN_DATA}`-Verzeichnis des Plugins gelöscht. Verwenden Sie `--keep-data`, um es zu bewahren, beispielsweise beim Neuinstallieren nach dem Testen einer neuen Version.

1106

1107<Note>

1108 Wenn installierte Plugins aus verschiedenen Marketplaces einen Namen teilen, deinstalliert die `plugin-name@marketplace-name`-Form nur das Plugin aus dem benannten Marketplace. Vor v2.1.212 konnte die qualifizierte Form das gleichnamige Plugin aus einem anderen Marketplace abgleichen und deinstallieren.

1109</Note>

1028 1110

1029<h3 id="plugin-prune">1111<h3 id="plugin-prune">

1030 plugin prune1112 plugin prune

1031</h3>1113</h3>

1032 1114

1033Entfernen Sie automatisch installierte Plugin-Abhängigkeiten, die nicht mehr von einem installierten Plugin benötigt werden. Abhängigkeiten, die Claude Code eingezogen hat, um das [`dependencies`](/docs/de/plugin-dependencies) Feld eines anderen Plugins zu erfüllen, werden entfernt; Plugins, die Sie direkt installiert haben, werden niemals berührt.1115Automatisch installierte Plugin-Abhängigkeiten entfernen, die nicht mehr von einem installierten Plugin benötigt werden. Abhängigkeiten, die Claude Code eingezogen hat, um das [`dependencies`](/docs/de/plugin-dependencies)-Feld eines anderen Plugins zu erfüllen, werden entfernt; Plugins, die Sie direkt installiert haben, werden nie berührt.

1034 1116

1035```bash theme={null}1117```bash theme={null}

1036claude plugin prune [options]1118claude plugin prune [options]

1039**Optionen:**1121**Optionen:**

1040 1122

1042| :-------------------- | :----------------------------------------------------------------------------------------------- | :------- |1124| :-------------------- | :--------------------------------------------------------------------------------------- | :------- |

1047 1129

1048**Aliase:** `autoremove`1130**Aliase:** `autoremove`

1049 1131

1050Der Befehl listet verwaiste Abhängigkeiten auf und fragt vor dem Entfernen um Bestätigung. Um ein Plugin zu entfernen und seine Abhängigkeiten in einem Schritt zu bereinigen, führen Sie `claude plugin uninstall <plugin> --prune` aus.1132Der Befehl listet verwaiste Abhängigkeiten auf und fragt vor dem Entfernen um Bestätigung. Um ein Plugin zu entfernen und seine Abhängigkeiten in einem Schritt zu bereinigen, führen Sie `claude plugin uninstall <plugin> --prune` aus.

1051 1133

1052<Note>

1053 `claude plugin prune` erfordert Claude Code v2.1.121 oder später.

1054</Note>

~~1055~~

1056<h3 id="plugin-enable">1134<h3 id="plugin-enable">

1057 plugin enable1135 plugin enable

1058</h3>1136</h3>

1059 1137

1060Aktivieren Sie ein deaktiviertes Plugin. Wenn das Plugin [Abhängigkeiten](/docs/de/plugin-dependencies) deklariert, aktiviert Claude Code diese transitiv im gleichen Bereich, und der Befehl schlägt fehl, wenn eine Abhängigkeit nicht installiert ist.1138Ein deaktiviertes Plugin aktivieren. Wenn das Ziel aus einem Marketplace installiert ist und [Abhängigkeiten](/docs/de/plugin-dependencies) deklariert, aktiviert Claude Code diese transitiv im gleichen Umfang. Der Befehl schlägt unter den Bedingungen fehl, die [Enable or disable a plugin with dependencies](/docs/de/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies) auflistet.

1061 1139

1062```bash theme={null}1140```bash theme={null}

1063claude plugin enable <plugin> [options]1141claude plugin enable <plugin> [options]

1070**Optionen:**1148**Optionen:**

1071 1149

1073| :-------------------- | :----------------------------------------------------- | :------- |1151| :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- | :--------------------- |

1076 1154

1077<h3 id="plugin-disable">1155<h3 id="plugin-disable">

1078 plugin disable1156 plugin disable

1079</h3>1157</h3>

1080 1158

1081Deaktivieren Sie ein Plugin, ohne es zu deinstallieren. Schlägt fehl, wenn ein anderes aktiviertes Plugin [von](/docs/de/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies) dem Ziel abhängt. Die Fehlermeldung enthält einen verketteten Befehl, der zuerst alle abhängigen Plugins deaktiviert.1159Ein Plugin deaktivieren, ohne es zu deinstallieren. Wenn das Ziel aus einem Marketplace installiert ist, schlägt der Befehl fehl, wenn ein anderes aktiviertes Plugin [davon abhängt](/docs/de/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies). Die Fehlermeldung enthält einen verketteten Befehl, der zuerst alle abhängigen Plugins deaktiviert.

1082 1160

1083```bash theme={null}1161```bash theme={null}

1084claude plugin disable <plugin> [options]1162claude plugin disable [plugin] [options]

1085```1163```

1086 1164

1087**Argumente:**1165**Argumente:**

1088 1166

1089* `<plugin>`: Plugin-Name oder `plugin-name@marketplace-name`1167* `[plugin]`: Plugin-Name oder `plugin-name@marketplace-name`. Optional bei Verwendung von `--all`

1090 1168

1091**Optionen:**1169**Optionen:**

1092 1170

1094| :-------------------- | :------------------------------------------------------- | :------- |1172| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------- |

1174| `-s, --scope <scope>` | Umfang zum Deaktivieren: `user`, `project` oder `local`. Wenn weggelassen, erkennt Claude Code den Umfang, in dem das Plugin installiert ist | Automatische Erkennung |

1097 1176

1098<h3 id="plugin-update">1177<h3 id="plugin-update">

1099 plugin update1178 plugin update

1100</h3>1179</h3>

1101 1180

1102Aktualisieren Sie ein Plugin auf die neueste Version.1181Ein Plugin auf die neueste Version aktualisieren.

1103 1182

1104```bash theme={null}1183```bash theme={null}

1105claude plugin update <plugin> [options]1184claude plugin update <plugin> [options]

1112**Optionen:**1191**Optionen:**

1113 1192

1115| :-------------------- | :------------------------------------------------------------------- | :------- |1194| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------- |

1196| `-y, --yes` | Akzeptieren Sie einen Befehl, den der Marketplace des Plugins deklariert, ohne die Bestätigungsaufforderung: den Befehl, der ein Plugin mit einer [`command`-Quelle](/docs/de/plugin-marketplaces#command-sources) erzeugt, oder den [`headersHelper`](/docs/de/plugin-marketplaces#authenticate-archive-downloads), der einen Archiv-Download authentifiziert. Das Akzeptieren eines `headersHelper` erfordert Claude Code v2.1.238 oder später. Claude Code druckt den Befehl trotzdem zuerst. Erforderlich, wenn stdin oder stdout kein TTY ist. Hat keine Auswirkung innerhalb einer Claude Code-Sitzung, daher führen Sie den Befehl von Ihrem eigenen Terminal aus | |

1118 1198

1199<Note>

1200 Claude Code löst einen einfachen Plugin-Namen gegen Ihre installierten Plugins auf. Wenn installierte Plugins aus verschiedenen Marketplaces den Namen teilen, weigert sich Claude Code zu aktualisieren und listet stattdessen die qualifizierten `plugin-name@marketplace-name`-Befehle auf, die ausgeführt werden sollen. Vor v2.1.246 akzeptierte Claude Code nur die qualifizierte Form und lehnte einen einfachen Namen als nicht gefunden ab.

1201</Note>

1202

1119***1203***

1120 1204

1121<h3 id="plugin-list">1205<h3 id="plugin-list">

1122 plugin list1206 plugin list

1123</h3>1207</h3>

1124 1208

1125Listet installierte Plugins mit ihrer Version, Quell-Marktplatz und Aktivierungsstatus auf.1209Installierte Plugins mit ihrer Version, Quell-Marketplace und Aktivierungsstatus auflisten.

1126 1210

1127```bash theme={null}1211```bash theme={null}

1128claude plugin list [options]1212claude plugin list [options]

1134| :------------ | :------------------------------------------------------------------- | :------- |1218| :------------ | :------------------------------------------------------------------- | :------- |

1138 1222

1139Innerhalb einer interaktiven Sitzung druckt `/plugin list` die gleiche Auflistung inline. Die interaktive Form akzeptiert `--enabled` oder `--disabled`, um nur Plugins in diesem Zustand anzuzeigen, und `ls` als Kurzform für `list`.1223Innerhalb einer interaktiven Sitzung druckt `/plugin list` eine ähnliche Auflistung inline, aber sie umfasst nur Marketplace-installierte Plugins:

1224

1225* Plugins, die aus Skills-Verzeichnissen geladen werden, erscheinen in der `/plugin`-Schnittstelle und in `claude plugin list`, aber nicht in der Inline-Ausgabe `/plugin list`.

1226* Auf Claude Code v2.1.239 oder später erscheinen [Plugins, die von claude.ai synchronisiert werden](#synced-plugins), in `claude plugin list`, wenn Sie es in der Umgebung ausführen, in der eine synchronisierte Sitzung sie heruntergeladen hat. Sie erscheinen nicht in der Inline-Ausgabe `/plugin list`.

1227* Plugins, die für die Sitzung mit `--plugin-dir` oder `--plugin-url` geladen werden, erscheinen in der `/plugin`-Schnittstelle und in `claude plugin list` nur, wenn das gleiche Flag dem Unterbefehl vorangeht, wie in `claude --plugin-dir <dir> plugin list`. Nur das Flag benennt ihren Standort, daher kann ein einfaches `claude plugin list` sie nicht finden, anders als synchronisierte Plugins und Skills-Directory-Plugins, deren feste Verzeichnisse Claude Code scannt.

1228

1229Die interaktive Form akzeptiert `--enabled` oder `--disabled`, um nur Plugins in diesem Zustand anzuzeigen, und `ls` als Kurzform für `list`.

1140 1230

1141<h3 id="plugin-details">1231<h3 id="plugin-details">

1142 plugin details1232 plugin details

1143</h3>1233</h3>

1144 1234

1145Zeigen Sie das Komponenten-Inventar eines Plugins und die geschätzten Token-Kosten an. Die Ausgabe listet alle Komponenten auf, die das Plugin bereitstellt, gruppiert als Skills, Agents, Hooks, MCP-Server und LSP-Server, zusammen mit einer Schätzung, wie viele Token es jeder Sitzung hinzufügt. Die Skills-Gruppe umfasst sowohl `skills/` als auch `commands/` Einträge.1235Zeigen Sie das Komponenten-Inventar eines Plugins und die geschätzte Token-Kosten an. Die Ausgabe listet alle Komponenten auf, die das Plugin beiträgt, gruppiert als Skills, Agents, Hooks, MCP-Server und LSP-Server, zusammen mit einer Schätzung, wie viele Token es jeder Sitzung hinzufügt. Die Skills-Gruppe umfasst sowohl `skills/`- als auch `commands/`-Einträge.

1146 1236

1147```bash theme={null}1237```bash theme={null}

1148claude plugin details <name>1238claude plugin details <name>

1173Component inventory1263Component inventory

1174 Skills (2) scan-dependencies, review-changes1264 Skills (2) scan-dependencies, review-changes

1175 Agents (0)1265 Agents (0)

1176 Hooks (1) (harness-only — no model context cost)1266 Hooks (1) SessionStart (harness-only — no model context cost)

1177 MCP servers (0)1267 MCP servers (0)

1178 LSP servers (0)1268 LSP servers (0)

1179 1269

1189 Token counts are estimates and may differ from actual usage.1279 Token counts are estimates and may differ from actual usage.

1190```1280```

1191 1281

1192Die Always-on-Gesamtsumme wird über die `count_tokens` API für Ihr aktives Modell berechnet. Pro-Komponenten-Zahlen werden proportional von dieser Gesamtsumme skaliert. Wenn die API nicht erreichbar ist, greift der Befehl auf eine zeichenbasierte Schätzung zurück.1282Die Always-on-Gesamtsumme wird über die `count_tokens`-API für Ihr aktives Modell berechnet. Pro-Komponenten-Zahlen werden proportional von dieser Gesamtsumme skaliert. Wenn die API nicht erreichbar ist, greift der Befehl auf eine zeichenbasierte Schätzung zurück.

1283

1284<h3 id="plugin-validate">

1285 plugin validate

1286</h3>

1287

1288Überprüfen Sie ein Plugin oder einen Marketplace auf Syntax- und Schema-Fehler, bevor Sie veröffentlichen.

1289

1290Der Befehl beendet sich mit 0, wenn die Validierung erfolgreich ist, mit 1, wenn sie fehlschlägt, und mit 2, wenn der Validierungslauf selbst fehlschlägt, z. B. wenn der übergebene Pfad nicht lesbar ist.

1291

1292```bash theme={null}

1293claude plugin validate <path> [options]

1294```

1295

1296**Argumente:**

1297

1298* `<path>`: Pfad zu einem Plugin-Verzeichnis oder einem Marketplace-Verzeichnis. Siehe [Validate a plugin or a directory without a manifest](/docs/de/plugin-marketplaces#validate-a-plugin-or-a-directory-without-a-manifest) für die Dateien, die ein Plugin-Lauf abdeckt.

1299

1300**Optionen:**

1301

1302| Option | Beschreibung | Standard |

1303| :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------- |

1304| `--strict` | Warnungen als Fehler behandeln und mit 1 beenden. Verwenden Sie in CI, um Probleme zu erfassen, die die Laufzeit toleriert, wie [unrecognized fields](#unrecognized-fields) | |

1305| `--json` | Geben Sie den Validierungsbericht als ein JSON-Objekt aus mit den gleichen Exit-Codes. Erfordert Claude Code v2.1.259 oder später | |

1306| `-h, --help` | Hilfe für Befehl anzeigen | |

1307

1308Mit `--json` schreibt Claude Code den Bericht auf stdout als ein JSON-Objekt mit diesen Top-Level-Feldern:

1309

1310* `success`: das gleiche Urteil, das der Exit-Code gibt

1311* `strict`: ob der Lauf Warnungen als Fehler behandelt hat

1312* `target`: der aufgelöste Pfad, den Claude Code validiert hat

1313* `manifest`: das eigene Ergebnis des Manifests oder `null` für einen [Lauf ohne Manifest](/docs/de/plugin-marketplaces#validate-a-plugin-or-a-directory-without-a-manifest)

1314* `contents`: Pro-Datei-Ergebnisse, jede benannt nach ihrer `file` und mit `errors`-, `warnings`- und `notes`-Arrays

1315

1316Bei Exit 2 schreibt der Befehl nichts auf stdout; die Fehlermeldung geht auf stderr.

1317

1318Innerhalb einer interaktiven Sitzung führt `/plugin validate <path>` die gleichen Überprüfungen inline aus.

1193 1319

1194<h3 id="plugin-tag">1320<h3 id="plugin-tag">

1195 plugin tag1321 plugin tag

1196</h3>1322</h3>

1197 1323

1198Erstellen Sie ein Release-Git-Tag für das Plugin im aktuellen Verzeichnis. Führen Sie es im Ordner des Plugins aus. Siehe [Tag-Plugin-Releases](/docs/de/plugin-dependencies#tag-plugin-releases-for-version-resolution).1324Erstellen Sie ein Release-Git-Tag für ein Plugin. Standardmäßig taggt der Befehl das Plugin im aktuellen Verzeichnis; übergeben Sie einen Pfad, um ein Plugin an anderer Stelle zu taggen. Siehe [Tag plugin releases](/docs/de/plugin-dependencies#tag-plugin-releases-for-version-resolution).

1199 1325

1200```bash theme={null}1326```bash theme={null}

1201claude plugin tag [options]1327claude plugin tag [path] [options]

1202```1328```

1203 1329

1330**Argumente:**

1331

1332* `[path]`: Pfad zum Plugin-Verzeichnis. Standardmäßig das aktuelle Verzeichnis.

1333

1204**Optionen:**1334**Optionen:**

1205 1335

1207| :------------ | :------------------------------------------------------------------------------------------- | :------- |1337| :-------------------- | :----------------------------------------------------------------------------------------- | :------- |

1341| `-m, --message <msg>` | Tag-Anmerkungsnachricht. Verwenden Sie `%s` als Platzhalter für die Version | |

1342| `--remote <name>` | Remote zum Pushen mit `--push` | `origin` |

1212 1344

1213***1345***

1220 Debugging-Befehle1352 Debugging-Befehle

1221</h3>1353</h3>

1222 1354

1223Verwenden Sie `claude --debug`, um Plugin-Lade-Details zu sehen:1355Verwenden Sie `claude --debug`, um Details zum Laden von Plugins anzuzeigen:

1224 1356

1225Dies zeigt:1357Dies zeigt:

1226 1358

1227* Welche Plugins geladen werden1359* Welche Plugins geladen werden

1228* Alle Fehler in Plugin-Manifesten1360* Alle Fehler in Plugin-Manifesten

1229* Skill-, Agent- und Hook-Registrierung1361* Registrierung von Skills, Agents und Hooks

1230* MCP-Server-Initialisierung1362* MCP-Server-Initialisierung

1231 1363

1232<h3 id="common-issues">1364<h3 id="common-issues">

1234</h3>1366</h3>

1235 1367

1237| :---------------------------------- | :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1369| :---------------------------------- | :-------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1238| Plugin wird nicht geladen | Ungültige `plugin.json` | Führen Sie `claude plugin validate` oder `/plugin validate` aus, um `plugin.json`, Skill/Agent/Command Frontmatter und `hooks/hooks.json` auf Syntax- und Schema-Fehler zu überprüfen |1370| Plugin wird nicht geladen | Ungültige `plugin.json` | Führen Sie `claude plugin validate ./my-plugin` oder `/plugin validate ./my-plugin` aus, wobei `./my-plugin` Ihr Plugin-Verzeichnis ist, um `plugin.json`, `hooks/hooks.json` und die Frontmatter der Skills, Agents und Commands in den Standard-Verzeichnissen des Plugins auf Syntax- und Schema-Fehler zu überprüfen. Siehe [Plugin oder Verzeichnis ohne Manifest validieren](/docs/de/plugin-marketplaces#validate-a-plugin-or-a-directory-without-a-manifest), um zu erfahren, was eine Ausführung abdeckt |

1239| Skills nicht erscheinend | Falsche Verzeichnisstruktur | Stellen Sie sicher, dass `skills/` oder `commands/` im Plugin-Root ist, nicht in `.claude-plugin/` |1371| Skills werden nicht angezeigt | Falsche Verzeichnisstruktur | Stellen Sie sicher, dass `skills/` oder `commands/` sich im Plugin-Root befindet, nicht in `.claude-plugin/` |

1241| MCP-Server schlägt fehl | Fehlender `${CLAUDE_PLUGIN_ROOT}` | Verwenden Sie Variable für alle Plugin-Pfade |1373| MCP-Server schlägt fehl | Fehlende `${CLAUDE_PLUGIN_ROOT}` | Verwenden Sie Variable für alle Plugin-Pfade |

1243| LSP `Executable not found in $PATH` | Language Server nicht installiert | Installieren Sie die Binärdatei (z.B. `npm install -g typescript-language-server typescript`) |1375| LSP `Executable not found in $PATH` | Language Server nicht installiert | Installieren Sie die Binärdatei (z. B. `npm install -g typescript-language-server typescript`) |

1244 1376

1245<h3 id="example-error-messages">1377<h3 id="example-error-messages">

1246 Beispiel-Fehlermeldungen1378 Beispiel-Fehlermeldungen

1248 1380

1249**Manifest-Validierungsfehler**:1381**Manifest-Validierungsfehler**:

1250 1382

1251* `Invalid JSON syntax: Unexpected token } in JSON at position 142`: Überprüfen Sie auf fehlende Kommas, zusätzliche Kommas oder nicht zitierte Strings1383* `Invalid JSON syntax: Unexpected token } in JSON at position 142`: Überprüfen Sie auf fehlende Kommas, zusätzliche Kommas oder nicht in Anführungszeichen gesetzte Strings

1252* `Plugin has an invalid manifest file at .claude-plugin/plugin.json. Validation errors: name: Required`: Ein erforderliches Feld fehlt1384* `Plugin <name> has an invalid manifest file at .claude-plugin/plugin.json. Validation errors: name: Invalid input: expected string, received undefined`: Ein erforderliches Feld fehlt

1253* `Plugin has a corrupt manifest file at .claude-plugin/plugin.json. JSON parse error: ...`: JSON-Syntaxfehler1385* `Plugin <name> has a corrupt manifest file at .claude-plugin/plugin.json. JSON parse error: ...`: JSON-Syntaxfehler. Vor v2.1.246 erzeugte Claude Code diesen Fehler auch für eine `plugin.json`, die als UTF-8 mit einer führenden Byte-Order-Mark (BOM) gespeichert wurde, selbst wenn das JSON ansonsten gültig war.

1254 1386

1255**Plugin-Ladefehler**:1387**Plugin-Ladefehler**:

1256 1388

1257* `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 Befehlsdateien1389* `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

1258* `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 Verzeichnis1390* `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 vorhandenes Verzeichnis

1259* `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-Eintrag1391* `Plugin my-plugin has conflicting manifests: both plugin.json and marketplace entry specify components.`: Entfernen Sie doppelte Komponentendefinitionen oder entfernen Sie `strict: false` im Marketplace-Eintrag

1260 1392

1261<h3 id="hook-troubleshooting">1393<h3 id="hook-troubleshooting">

1262 Hook-Fehlerbehebung1394 Hook-Fehlerbehebung

1265**Hook-Skript wird nicht ausgeführt**:1397**Hook-Skript wird nicht ausgeführt**:

1266 1398

12671. Überprüfen Sie, dass das Skript ausführbar ist: `chmod +x ./scripts/your-script.sh`13991. Überprüfen Sie, dass das Skript ausführbar ist: `chmod +x ./scripts/your-script.sh`

12682. Überprüfen Sie die Shebang-Zeile: Erste Zeile sollte `#!/bin/bash` oder `#!/usr/bin/env bash` sein14002. Überprüfen Sie die Shebang-Zeile: Die erste Zeile sollte `#!/bin/bash` oder `#!/usr/bin/env bash` sein

12693. Überprüfen Sie, dass der Pfad `${CLAUDE_PLUGIN_ROOT}` verwendet: `"command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/your-script.sh"`14013. Überprüfen Sie, dass der Pfad `${CLAUDE_PLUGIN_ROOT}` verwendet: `"command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/your-script.sh"`

12704. Testen Sie das Skript manuell: `./scripts/your-script.sh`14024. Testen Sie das Skript manuell: `./scripts/your-script.sh`

1271 1403

1272**Hook wird nicht bei erwarteten Events ausgelöst**:1404**Hook wird bei erwarteten Ereignissen nicht ausgelöst**:

1273 1405

12741. Überprüfen Sie, dass der Event-Name korrekt ist (Groß-/Kleinschreibung beachten): `PostToolUse`, nicht `postToolUse`14061. Überprüfen Sie, dass der Ereignisname korrekt ist (Groß-/Kleinschreibung beachten): `PostToolUse`, nicht `postToolUse`

12752. Überprüfen Sie, dass das Matcher-Muster Ihre Tools passt: `"matcher": "Write|Edit"` für Dateivorgänge14072. Überprüfen Sie, dass das Matcher-Muster Ihre Tools entspricht: `"matcher": "Write|Edit"` für Dateivorgänge

12763. Bestätigen Sie, dass der Hook-Typ gültig ist: `command`, `http`, `mcp_tool`, `prompt` oder `agent`14083. Bestätigen Sie, dass der Hook-Typ gültig ist: `command`, `http`, `mcp_tool`, `prompt` oder `agent`

1277 1409

1278<h3 id="mcp-server-troubleshooting">1410<h3 id="mcp-server-troubleshooting">

1279 MCP-Server-Fehlerbehebung1411 MCP-Server-Fehlerbehebung

1280</h3>1412</h3>

1281 1413

1282**Server wird nicht gestartet**:1414**Server startet nicht**:

1283 1415

12841. Überprüfen Sie, dass der Befehl existiert und ausführbar ist14161. Überprüfen Sie, dass der Befehl existiert und ausführbar ist

12852. Überprüfen Sie, dass alle Pfade die `${CLAUDE_PLUGIN_ROOT}` Variable verwenden14172. Überprüfen Sie, dass alle Pfade die `${CLAUDE_PLUGIN_ROOT}` Variable verwenden

12863. Überprüfen Sie die MCP-Server-Logs: `claude --debug` zeigt Initialisierungsfehler14183. Überprüfen Sie die MCP-Server-Protokolle: `claude --debug` zeigt Initialisierungsfehler

12874. Testen Sie den Server manuell außerhalb von Claude Code14194. Testen Sie den Server manuell außerhalb von Claude Code

1288 1420

1289**Server-Tools erscheinen nicht**:1421**Server-Tools werden nicht angezeigt**:

1290 1422

12911. Stellen Sie sicher, dass der Server ordnungsgemäß in `.mcp.json` oder `plugin.json` konfiguriert ist14231. Stellen Sie sicher, dass der Server ordnungsgemäß in `.mcp.json` oder `plugin.json` konfiguriert ist

12922. Überprüfen Sie, dass der Server das MCP-Protokoll ordnungsgemäß implementiert14242. Überprüfen Sie, dass der Server das MCP-Protokoll korrekt implementiert

12933. Überprüfen Sie auf Verbindungs-Timeouts in der Debug-Ausgabe14253. Überprüfen Sie auf Verbindungs-Timeouts in der Debug-Ausgabe

1294 1426

1295<h3 id="directory-structure-mistakes">1427<h3 id="directory-structure-mistakes">

1296 Verzeichnisstruktur-Fehler1428 Fehler in der Verzeichnisstruktur

1297</h3>1429</h3>

1298 1430

1299**Symptome**: Plugin wird geladen, aber Komponenten (Skills, Agents, Hooks) fehlen.1431**Symptome**: Plugin wird geladen, aber Komponenten (Skills, Agents, Hooks) fehlen.

1300 1432

1301**Korrekte Struktur**: Komponenten müssen sich im Plugin-Root befinden, nicht innerhalb von `.claude-plugin/`. Nur `plugin.json` gehört in `.claude-plugin/`.1433**Korrekte Struktur**: Komponenten müssen sich im Plugin-Root befinden, nicht in `.claude-plugin/`. Nur `plugin.json` gehört in `.claude-plugin/`.

~~1302~~

1303```text theme={null}

1304my-plugin/

1305├── .claude-plugin/

1306│ └── plugin.json ← Nur Manifest hier

1307├── commands/ ← Auf Root-Ebene

1308├── agents/ ← Auf Root-Ebene

1309└── hooks/ ← Auf Root-Ebene

1310```

~~1311~~

1312Wenn sich Ihre Komponenten in `.claude-plugin/` befinden, verschieben Sie sie in den Plugin-Root.

1313 1434

1314**Debug-Checkliste**:1435**Debug-Checkliste**:

1315 1436

13161. Führen Sie `claude --debug` aus und suchen Sie nach „loading plugin" Meldungen14371. Führen Sie `claude --debug` aus und suchen Sie nach „loading plugin"-Meldungen

13172. Überprüfen Sie, dass jedes Komponentenverzeichnis in der Debug-Ausgabe aufgelistet ist14382. Überprüfen Sie, dass jedes Komponenten-Verzeichnis in der Debug-Ausgabe aufgelistet ist

13183. Überprüfen Sie Dateiberechtigungen, die das Lesen der Plugin-Dateien ermöglichen14393. Überprüfen Sie, dass Dateiberechtigungen das Lesen der Plugin-Dateien ermöglichen

1319 1440

1320***1441***

1321 1442

1322<h2 id="distribution-and-versioning-reference">1443<h2 id="distribution-and-versioning-reference">

1323 Verteilungs- und Versionierungs-Referenz1444 Verteilungs- und Versionierungsreferenz

1324</h2>1445</h2>

1325 1446

1326<h3 id="version-management">1447<h3 id="version-management">

1327 Versionsverwaltung1448 Versionsverwaltung

1328</h3>1449</h3>

1329 1450

1330Claude Code verwendet die Version des Plugins als Cache-Schlüssel, der bestimmt, ob ein Update verfügbar ist. Wenn Sie `/plugin update` ausführen oder Auto-Update aktiviert ist, berechnet Claude Code die aktuelle Version und überspringt das Update, wenn es mit der bereits installierten Version übereinstimmt.1451Claude Code verwendet die Version des Plugins als Cache-Schlüssel, der bestimmt, ob ein Update verfügbar ist. Wenn Sie `/plugin update` ausführen oder Auto-Update aktiviert ist, berechnet Claude Code die aktuelle Version und überspringt das Update, wenn sie mit der bereits installierten Version übereinstimmt.

1331 1452

1332Die Version wird aus dem ersten dieser Felder aufgelöst, das gesetzt ist:1453Für jeden Quellentyp außer `command` löst Claude Code die Version aus dem ersten dieser Punkte auf, der gesetzt ist:

1333 1454

13341. Das Feld `version` in der `plugin.json` des Plugins14551. Das Feld `version` in der `plugin.json` des Plugins

13352. Das Feld `version` im Marketplace-Eintrag des Plugins in `marketplace.json`14562. Das Feld `version` im Marketplace-Eintrag des Plugins in `marketplace.json`

13363. Der Git-Commit-SHA des Plugin-Quellcodes für `github`, `url`, `git-subdir` und relative-path-Quellen in einem Git-gehosteten Marketplace14573. Der Git-Commit-SHA des Plugin-Quellcodes für `github`, `url`, `git-subdir` und relative-path-Quellen in einem Git-gehosteten Marketplace

13374. `unknown`, für `npm`-Quellen oder lokale Verzeichnisse, die sich nicht in einem Git-Repository befinden14584. Der SHA-256-Digest für [`archive`-Quellen](/docs/de/plugin-marketplaces#zip-archives): der `sha256`-Pin im Marketplace-Eintrag oder der Digest der heruntergeladenen Datei, wenn Sie keinen Pin setzen. Claude Code kürzt ihn auf die ersten 12 Zeichen

14595. `unknown` für `npm`-Quellen oder lokale Verzeichnisse, die sich nicht in einem Git-Repository befinden

1460

1461Für eine [`command`-Quelle](/docs/de/plugin-marketplaces#command-sources) leitet Claude Code die Version immer aus dem ab, was der Befehl produziert: einen 12-stelligen Content-Hash allein oder an die `plugin.json`-Version als `<version>-<hash>` angehängt, wenn einer gesetzt ist. Claude Code ignoriert das Feld `version` des Marketplace-Eintrags für Command-Quellen. Ein Befehl, dessen gehashte Ausgabe sich ändert, produziert daher eine neue Version, auch wenn die verfasste Versionsnummer gleich bleibt. Im [Link-Modus](/docs/de/plugin-marketplaces#copy-mode-and-link-mode) deckt der Hash den echten Pfad des gedruckten Verzeichnisses und seine Einträge auf oberster Ebene ab, anstatt der Dateiinhalte.

1338 1462

1339Dies gibt Ihnen zwei Möglichkeiten, ein Plugin zu versionieren:1463Für diese Quellentypen gibt es drei Möglichkeiten, ein Plugin zu versionieren:

1340 1464

1341| Ansatz | Wie | Update-Verhalten | Am besten für |1465| Ansatz | Wie | Update-Verhalten | Am besten für |

1342| :--------------------- | :------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------- |1466| :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- |

1343| **Explizite Version** | Setzen Sie `"version": "2.1.0"` in `plugin.json` | Benutzer erhalten Updates nur, wenn Sie dieses Feld erhöhen. Das Pushen neuer Commits ohne Erhöhung hat keine Auswirkung, und `/plugin update` meldet „bereits auf der neuesten Version". | Veröffentlichte Plugins mit stabilen Release-Zyklen |1467| **Explizite Version** | Setzen Sie `"version": "2.1.0"` in `plugin.json` | Benutzer erhalten Updates nur, wenn Sie dieses Feld erhöhen. Das Pushen neuer Commits ohne Erhöhung hat keine Auswirkung, und `/plugin update` meldet „bereits auf der neuesten Version". | Veröffentlichte Plugins mit stabilen Release-Zyklen |

1344| **Commit-SHA-Version** | Lassen Sie `version` sowohl in `plugin.json` als auch im Marketplace-Eintrag weg | Benutzer erhalten Updates bei jedem neuen Commit zur Git-Quelle des Plugins | Interne oder Team-Plugins unter aktiver Entwicklung |1468| **Commit-SHA-Version** | Lassen Sie `version` sowohl in `plugin.json` als auch im Marketplace-Eintrag weg | Benutzer erhalten Updates, wenn sich der aufgelöste Commit der Quelle ändert | Interne oder Team-Plugins unter aktiver Entwicklung |

~~1345~~ 1469| **Digest-Version** | Verwenden Sie eine [`archive`-Quelle](/docs/de/plugin-marketplaces#zip-archives) und lassen Sie `version` sowohl in `plugin.json` als auch im Marketplace-Eintrag weg | Mit einem `sha256`-Pin erhalten Benutzer Updates, wenn Sie den Pin ändern. Ohne einen erhalten Benutzer Updates, wenn sich die Bytes der gehosteten ZIP-Datei ändern | Plugins, die als ZIP-Dateien auf einem statischen Server oder in einem Artefakt-Repository veröffentlicht werden |

1346<Warning>

1347 Wenn Sie `version` in `plugin.json` setzen, müssen Sie es jedes Mal erhöhen, wenn Benutzer Änderungen erhalten sollen. Das bloße Pushen neuer Commits reicht nicht aus, da Claude Code die gleiche Versionszeichenkette sieht und die zwischengespeicherte Kopie behält. Wenn Sie schnell iterieren, lassen Sie `version` ungesetzt, damit stattdessen der Git-Commit-SHA verwendet wird.

1348</Warning>

1349 1470

1350Wenn Sie explizite Versionen verwenden, folgen Sie [semantischer Versionierung](https://semver.org) (`MAJOR.MINOR.PATCH`): Erhöhen Sie MAJOR für Breaking Changes, MINOR für neue Features, PATCH für Bugfixes. Dokumentieren Sie Änderungen in einer `CHANGELOG.md`.1471Wenn Sie explizite Versionen verwenden, folgen Sie [semantischer Versionierung](https://semver.org) (`MAJOR.MINOR.PATCH`): erhöhen Sie MAJOR für Breaking Changes, MINOR für neue Funktionen, PATCH für Bugfixes. Dokumentieren Sie Änderungen in einer `CHANGELOG.md`.

1351 1472

1352***1473***

1353 1474

plugins-reference.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

Plugins-Referenz

Referenz für Plugin-Komponenten

Skills

Agents

Hooks

MCP servers

LSP servers

Monitors

Themes

Installationsbereiche für Plugins

Plugins aus dem Skills-Verzeichnis

Wählen Sie, von wo aus das Plugin geladen wird

Bearbeiten, neu laden und deaktivieren Sie ein Plugin aus dem Skills-Verzeichnis

Plugins synchronisiert von claude.ai

Plugin-Manifest-Schema

Vollständiges Schema

Erforderliche Felder

Nicht erkannte Felder

Metadatenfelder

Standardaktivierung

Komponentenpfad-Felder

Experimentelle Komponenten

Benutzerkonfiguration

Kanäle

Pfadverhaltenregeln

Umgebungsvariablen

Persistentes Datenverzeichnis

Plugin-Caching und Dateiauflösung

Node.js-Paketabhängigkeiten

Einschränkungen bei der Pfadtraversierung

Dateien innerhalb eines Marketplace mit Symlinks freigeben

Verzeichnisstruktur von Plugins

Standard-Plugin-Layout

Dateistandorte-Referenz

CLI-Befehle – Referenz

plugin init

plugin install

plugin uninstall

plugin prune

plugin enable

plugin disable

plugin update

plugin list

plugin details

plugin validate

plugin tag

Debugging- und Entwicklungstools

Debugging-Befehle

Häufige Probleme

Beispiel-Fehlermeldungen

Hook-Fehlerbehebung

MCP-Server-Fehlerbehebung

Fehler in der Verzeichnisstruktur

Verteilungs- und Versionierungsreferenz

Versionsverwaltung

Siehe auch