Komponenten zu einem Plugin hinzufügen

​

Plugin-Verzeichnis erkunden

• Ein Review-Skill und einen about-Befehl
• Einen Security-Review-Subagenten
• Einen Hook, der Dateien nach Claude-Bearbeitungen formatiert, und den scripts/-Ordner, den er aufruft
• Einen Log-Monitor
• Einen Output-Stil und ein Farbschema
• Einen Route-Audit-Workflow
• Eine hello-plugin-Ausführungsdatei
• Standard-Einstellungen
• Einen lokalen MCP-Server und einen Go-Sprachserver

​

Jede Art von Komponente hinzufügen

​

Skills

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

---
description: Reviews a pull request for style and test coverage. Use when asked to review code.
---

Review the changed files. Report style problems first, then missing tests.

• Befehlsname: /<plugin>:<directory>, also ist skills/review/SKILL.md in my-plugin gleich /my-plugin:review. Wenn Sie name im Frontmatter festlegen, ersetzt es das letzte Segment, und das Plugin-Präfix bleibt erhalten. Siehe wie ein Skill seinen Befehlsnamen erhält
• Wer ihn aufruft: Claude, der Benutzer oder beide, gesteuert über das Frontmatter. Siehe Steuern, wer einen Skill aufruft

• Zusätzliche Verzeichnisse: Führen Sie sie im Manifest-Schlüssel skills auf. Sie ergänzen den Standard-Scan von skills/, anstatt ihn zu ersetzen, anders als bei commands und agents
• Ein einzelner Skill im Plugin-Stammverzeichnis: Ohne skills/-Verzeichnis und ohne Manifest-Schlüssel skills wird eine SKILL.md im Plugin-Stammverzeichnis als ein Skill geladen. Legen Sie name in ihrem Frontmatter fest, da eine Marketplace-Installation den Skill sonst nach seinem Cache-Verzeichnis benennt statt nach Ihrem Plugin

​

Befehle

​

Befehle im Manifest definieren

{
  "name": "my-plugin",
  "commands": {
    "about": {
      "content": "Summarize what this repository does in three sentences.",
      "description": "Summarize the repository"
    }
  }
}

​

Agenten

---
name: security-reviewer
description: Reviews code changes for security issues. Use after edits to authentication or input handling.
model: sonnet
---

You are a security reviewer. Read the changed files and report injection, authentication, and secrets-handling risks.

​

Agenten in Unterordnern organisieren

• Frontmatter name: Es ersetzt nur den Dateinamen, sodass name: audit in agents/review/security.md als my-plugin:review:audit geladen wird
• Manifest-Feld agents: Eine dort aufgeführte Datei wird ohne Unterordnernamen geladen, sodass "agents": "./custom/review/security.md" als my-plugin:security geladen wird

​

Frontmatter-Felder in Plugin-Agenten

• Unterstützte Felder: name, description, model, effort, maxTurns, autoCompactWindow, tools, disallowedTools, skills, memory, background, omitClaudeMd, isolation, color und der Schlüssel cacheTtl von experimental. Der einzige gültige Wert für isolation ist "worktree". Was jedes Feld bewirkt, erfahren Sie unter unterstützte Frontmatter-Felder
• Ignorierte Felder: permissionMode, hooks, mcpServers und initialPrompt. Eine Agentendatei kann selbst keine Hooks oder MCP-Server hinzufügen, fügen Sie diese daher stattdessen als Plugin-Hooks und MCP-Server hinzu
• Ein name mit mehr als 256 Zeichen: Claude Code ignoriert ihn und benennt den Agenten nach seiner Datei, wie es auch geschieht, wenn das Feld fehlt
• Frontmatter, das sich nicht parsen lässt: Der Agent wird trotzdem geladen, wobei alle Felder ignoriert werden. Er wird nach der Datei benannt, und seine Beschreibung lautet Agent from my-plugin plugin. Führen Sie claude plugin validate in Ihrer Shell aus, um diese Dateien zu finden

​

Hooks

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

​

Wann Plugin-Hooks ausgelöst werden

​

Umgebung, Anführungszeichen und Abgleich von MCP-Tools

• Umgebung: Jeder Hook-Prozess erhält CLAUDE_PLUGIN_ROOT und CLAUDE_PLUGIN_DATA in seiner Umgebung sowie CLAUDE_PLUGIN_OPTION_<KEY> für jeden Wert der Benutzerkonfiguration, sodass Ihr Skript sie von dort lesen kann
• Anführungszeichen: Wenn command keine args hat, wird es über eine Shell ausgeführt. Setzen Sie den Pfad ${CLAUDE_PLUGIN_ROOT} daher in doppelte Anführungszeichen, wie im hooks/hooks.json-Beispiel unter Hooks, damit der expandierte Pfad ein einzelnes Shell-Wort bleibt. Wenn Sie stattdessen args übergeben, wird jedes Element ohne Shell als ein Argument übergeben und benötigt keine Anführungszeichen. Siehe Exec-Form und Shell-Form
• Abgleich der eigenen MCP-Tools des Plugins: Ein Tool von einem MCP-Server, den dieses Plugin deklariert, heißt mcp__plugin_<plugin>_<server>__<tool>. Schreiben Sie daher diesen vollständigen Namen in den Matcher. Ein Matcher allein auf den Servernamen wird nie ausgelöst. Siehe MCP-Tools abgleichen

​

MCP-Server

{
  "mcpServers": {
    "db": {
      "command": "node",
      "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"]
    }
  }
}

​

Benutzer auf claude.ai und in Cowork erreichen

​

Servernamen, Tool-Namen und Neuladen

• Servername: plugin:<plugin>:<server>, also ist der db-Server in my-plugin in /mcp gleich plugin:my-plugin:db. Verwenden Sie dieselbe Form, um den Server in einem mcp_tool-Hook zu benennen
• Tool-Namen: mcp__plugin_<plugin>_<server>__<tool>, also ist ein query-Tool auf diesem db-Server gleich mcp__plugin_my-plugin_db__query. Diesen Namen verwenden Sie in Berechtigungsregeln und Hook-Matchern
• Ersetzung: ${CLAUDE_PLUGIN_ROOT} und die anderen Pfadvariablen werden in command, args und env ersetzt. In args sind keine Anführungszeichen nötig, da jedes Element als ein Argument übergeben wird
• Neuladen: Wenn der Benutzer /reload-plugins ausführt und das Neuladen greift, behält ein Server mit unveränderter Konfiguration seine Verbindung. Ein Server, dessen Konfiguration sich geändert hat, verbindet sich neu, und einer, den Sie entfernt haben, trennt die Verbindung

​

Einen gepackten MCPB-Server einbinden

{
  "name": "my-plugin",
  "mcpServers": "./servers/db.mcpb"
}

• In /plugin: Wählen Sie das Plugin auf dem Tab Installed aus und wählen Sie Configure
• Bei der Installation, über die Shell: Übergeben Sie --config <server>.<key>=<value> an claude plugin install. Erfordert Claude Code v2.1.285 oder neuer und funktioniert nur für ein Bundle, das innerhalb des Plugins gepackt ist.

​

LSP-Server

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

• Fehlende Binärdatei: Claude Code startet command über seinen Namen aus dem PATH des Benutzers. Wenn die Binärdatei dort nicht vorhanden ist, startet der Server nicht, und claude --debug protokolliert LSP server <name> failed to start
• Konflikte bei Dateiendungen: Wenn zwei aktivierte Server dieselbe Dateiendung beanspruchen, verarbeitet der zuerst registrierte diese Dateien, und der andere wird dafür nicht verwendet, unabhängig davon, ob die Server aus einem oder zwei Plugins stammen. Der Tab Errors in /plugin zeigt die Warnung LSP server "<name>" is not used for <ext> files an

​

Ausführbare Dateien

#!/bin/bash
echo "hello from my-plugin"

​

Standardeinstellungen

{
  "agent": "security-reviewer"
}

• Datei vor Manifest: Wenn beide vorhanden sind und settings.json mindestens einen unterstützten Schlüssel festlegt, gilt settings.json, und settings im Manifest wird ignoriert
• Benutzereinstellungen vor Plugin-Standardwerten: Über alle Einstellungsquellen hinweg bilden Plugin-Standardwerte die unterste Ebene, sodass ein eigenes agent des Benutzers in ~/.claude/settings.json Ihres überschreibt
• Zwei Plugins legen denselben Schlüssel fest: Es gilt der Wert des zuletzt geladenen Plugins, und claude --debug protokolliert overrides setting

​

Themes und Ausgabestile

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

​

Channels

{
  "name": "my-plugin",
  "mcpServers": {
    "telegram": {
      "command": "node",
      "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"],
      "env": { "BOT_TOKEN": "${user_config.bot_token}" }
    }
  },
  "channels": [
    {
      "server": "telegram",
      "userConfig": {
        "bot_token": {
          "type": "string",
          "title": "Bot token",
          "description": "Telegram bot token",
          "sensitive": true
        }
      }
    }
  ]
}

​

Monitore

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

• Interaktive Sitzungen: Plugin-Monitore starten nicht im nicht interaktiven Modus mit dem Flag -p
• Mindestversion: Auf Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform oder Microsoft Foundry sowie bei gesetztem DISABLE_TELEMETRY oder CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC erfordern Monitore Claude Code v2.1.310 oder neuer. Die Anforderung gilt, wenn das Abrufen von Feature-Flags deaktiviert ist
• Keine Benutzerkonfiguration: command erhält die Pfadvariablen und ${ENV_VAR} aus der Umgebung, aber nie ${user_config.*}. Ein Monitor, der auf eine solche verweist, startet nicht, und Monitor-Prozesse erhalten auch kein CLAUDE_PLUGIN_OPTION_<KEY>
• Deaktivieren während der Sitzung: Wenn Sie ein Plugin während einer Sitzung deaktivieren, stoppt Claude Code bereits laufende Monitore nicht. Sie stoppen, wenn die Sitzung endet

​

Fragen Sie den Benutzer nach Konfigurationswerten

{
  "name": "my-plugin",
  "userConfig": {
    "api_url": {
      "type": "string",
      "title": "API URL",
      "description": "Base URL of your team's API"
    },
    "api_token": {
      "type": "string",
      "title": "API token",
      "description": "Token for your team's API",
      "sensitive": true
    }
  }
}

​

Wenn der Konfigurationsdialog erscheint

• Installiert das Plugin in /plugin
• Führt /plugin install <plugin>@<marketplace> in einer Sitzung aus
• Aktiviert das Plugin aus der Installed-Registerkarte in /plugin

​

Referenzieren Sie Plugin-Pfade und speichern Sie Daten

• ${CLAUDE_PLUGIN_ROOT}: Das Installationsverzeichnis des Plugins. Jede Version hat ihr eigenes Cache-Verzeichnis, daher ändert sich der Pfad, wenn das Plugin aktualisiert wird. Schreiben Sie keinen Zustand dort
• ${CLAUDE_PLUGIN_DATA}: Ein Verzeichnis, das Updates überlebt, für node_modules, virtuelle Umgebungen und Caches. Es wird zu ~/.claude/plugins/data/<id>/ aufgelöst und wird erstellt, wenn zuerst referenziert
• ${CLAUDE_PROJECT_DIR}: Das Projekt-Root, der gleiche Wert, den Hooks erhalten

​

Installieren Sie Abhängigkeiten in das Daten-Verzeichnis

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

​

Nächste Schritte

• Plugin-Manifest-Referenz: plugin.json-Felder, Pfad-Regeln und das Standard-Layout
• Testen Sie Plugins mit Evals: Überprüfen Sie, dass die Komponenten, die Sie hinzugefügt haben, Claudes Verhalten so ändern, wie Sie beabsichtigen
• Veröffentlichen und verteilen Sie ein Plugin: Versionieren Sie das Plugin und setzen Sie es in einen Marketplace
• Beheben Sie Plugin-Probleme: Was zu tun ist, wenn eine Komponente nicht lädt oder ein Hook nicht auslöst