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

​

Fügen Sie jede Art von Komponente hinzu

​

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 skills/review/SKILL.md in my-plugin ist /my-plugin:review. Wenn Sie name in der Frontmatter setzen, ersetzt es das letzte Segment und das Plugin-Präfix bleibt. Siehe wie ein Skill seinen Befehlsnamen erhält
• Wer ruft ihn auf: Claude, der Benutzer oder beide, gesteuert durch Frontmatter. Siehe Kontrollieren Sie, wer einen Skill aufruft

• Zusätzliche Verzeichnisse: Listen Sie sie im skills-Manifest-Schlüssel auf. Sie ergänzen den Standard-skills/-Scan, anstatt ihn zu ersetzen, anders als commands und agents
• Ein einzelner Skill im Plugin-Root: Ohne skills/-Verzeichnis und ohne skills-Manifest-Schlüssel lädt eine SKILL.md im Plugin-Root als ein Skill. Setzen Sie name in seiner Frontmatter, da sonst eine Marketplace-Installation den Skill nach seinem Cache-Verzeichnis benennt, anstatt nach Ihrem Plugin

​

Befehle

​

Definieren Sie Befehle im Manifest

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

​

Agents

---
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.

​

Organisieren Sie Agents in Unterordnern

• Frontmatter name: Sie ersetzt nur den Dateinamen, also name: audit in agents/review/security.md lädt als my-plugin:review:audit
• Manifest agents-Feld: Eine Datei, die Sie dort auflisten, lädt ohne Unterordnernamen, also "agents": "./custom/review/security.md" lädt als my-plugin:security

​

Frontmatter-Felder in Plugin-Agents

• Unterstützte Felder: name, description, model, effort, maxTurns, tools, disallowedTools, skills, memory, background, omitClaudeMd, isolation, color und der cacheTtl-Schlüssel von experimental. Der einzige gültige isolation-Wert ist "worktree". Siehe unterstützte Frontmatter-Felder für das, was jedes tut
• Ignorierte Felder: permissionMode, hooks, mcpServers und initialPrompt. Eine Agent-Datei kann nicht auf eigene Faust Hooks oder MCP-Server hinzufügen, daher fügen Sie diese stattdessen als Plugin-Hooks und MCP-Server hinzu
• Frontmatter, die nicht analysiert wird: Der Agent lädt immer noch mit jedem Feld ignoriert. Er wird nach der Datei benannt, und seine Beschreibung liest 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\""
          }
        ]
      }
    ]
  }
}

​

Wenn Plugin-Hooks auslösen

​

Umgebung, Anführungszeichen und Matching von MCP-Tools

• Umgebung: Jeder Hook-Prozess erhält CLAUDE_PLUGIN_ROOT und CLAUDE_PLUGIN_DATA in seiner Umgebung, plus CLAUDE_PLUGIN_OPTION_<KEY> für jeden Benutzerkonfiguration-Wert, damit Ihr Script sie von dort lesen kann
• Anführungszeichen: Wenn command keine args hat, läuft es durch eine Shell, daher wickeln Sie den ${CLAUDE_PLUGIN_ROOT}-Pfad in doppelte Anführungszeichen, wie das Beispiel hooks/hooks.json unter Hooks tut, um den erweiterten Pfad ein Shell-Wort zu halten. Wenn Sie stattdessen args übergeben, wird jedes Element als ein Argument ohne Shell übergeben und braucht keine Anführungszeichen. Siehe Exec-Form und Shell-Form
• Matching der eigenen MCP-Tools des Plugins: Ein Tool von einem MCP-Server, den dieses Plugin deklariert, wird mcp__plugin_<plugin>_<server>__<tool> genannt, daher schreiben Sie diesen vollständigen Namen in den Matcher. Ein Matcher nur auf dem Servernamen löst nie aus. Siehe Match MCP-Tools

​

MCP-Server

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

​

Erreichen Sie Benutzer auf claude.ai und Cowork

​

Server-Namen, Tool-Namen und Neuladen

• Server-Name: plugin:<plugin>:<server>, also der db-Server in my-plugin ist plugin:my-plugin:db in /mcp. Verwenden Sie die gleiche Form, um den Server in einem mcp_tool-Hook zu benennen
• Tool-Namen: mcp__plugin_<plugin>_<server>__<tool>, also ein query-Tool auf diesem db-Server ist mcp__plugin_my-plugin_db__query. Das ist der Name, der in Berechtigungsregeln und Hook-Matchern verwendet wird
• Substitution: ${CLAUDE_PLUGIN_ROOT} und die anderen Pfad-Variablen werden in command, args und env ersetzt. Keine Anführungszeichen sind in args erforderlich, da jedes Element als ein Argument übergeben wird
• Neuladen: Wenn der Benutzer /reload-plugins ausführt und das Neuladen angewendet wird, behält ein Server, dessen Konfiguration unverändert ist, seine Verbindung. Ein Server, dessen Konfiguration sich geändert hat, verbindet sich neu, und einer, den Sie entfernt haben, trennt sich

​

Schließen Sie einen verpackten MCPB-Server ein

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

​

LSP-Server

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

• Fehlendes Binär: Claude Code startet command nach Name aus dem PATH des Benutzers. Wenn das Binär nicht da ist, schlägt der Server fehl zu starten und claude --debug protokolliert LSP server <name> failed to start
• Erweiterungs-Konflikte: Wenn zwei aktivierte Server die gleiche Erweiterung beanspruchen, behandelt der erste registrierte diese Dateien und der andere wird nicht für sie verwendet, ob die Server von einem Plugin oder zwei kommen. Die /plugin-Registerkarte Errors zeigt die Warnung LSP server "<name>" is not used for <ext> files

​

Ausführbare Dateien

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

​

Standard-Einstellungen

{
  "agent": "security-reviewer"
}

• Datei über Manifest: Wenn beide existieren und settings.json mindestens einen unterstützten Schlüssel setzt, wendet settings.json an und das Manifest settings wird ignoriert
• Benutzer-Einstellungen über Plugin-Standard: Über Einstellungs-Quellen hinweg sind Plugin-Standard die niedrigste Schicht, daher überschreibt Ihr eigenes agent eines Benutzers in ~/.claude/settings.json Ihres
• Zwei Plugins setzen den gleichen Schlüssel: Der Wert vom zuletzt geladenen Plugin wendet an, und claude --debug protokolliert overrides setting

​

Themen und Output-Stile

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

​

Kanäle

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

• Nur interaktive Sitzungen: Plugin-Monitore starten in einer interaktiven Sitzung und nie im nicht-interaktiven Modus mit dem -p-Flag. Sie starten auch nur, wo das Monitor-Tool verfügbar ist
• Keine Benutzerkonfiguration: command erhält die Pfad-Variablen und ${ENV_VAR} aus der Umgebung, aber nie ${user_config.*}. Ein Monitor, der einen referenziert, startet nicht, und Monitor-Prozesse erhalten auch nicht CLAUDE_PLUGIN_OPTION_<KEY>
• Deaktivieren während der Sitzung: Wenn Sie ein Plugin während der Sitzung deaktivieren, stoppt Claude Code nicht die Monitore, die bereits laufen. 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