Erstellen Sie ein Claude Code-Plugin

• Noch nichts: folgen Sie Erstellen Sie Ihr erstes Plugin, dann Entwickeln Sie ohne einen Marketplace und Testen und Debuggen.
• Dateien unter .claude/ bereits vorhanden: führen Sie die Anleitung zum ersten Plugin einmal durch, um das Layout zu verstehen, und folgen Sie dann Konvertieren Sie ein vorhandenes .claude/-Setup.

​

Entscheiden Sie, wann Sie ein Plugin verwenden

• Wo die Dateien hingehen: unter das eigene Verzeichnis des Plugins, das als Plugin-Root bezeichnet wird, als skills/, agents/, hooks/hooks.json und .mcp.json.
• Wie sie benannt werden: Plugin-Skills und Agents erhalten den Plugin-Namen als Präfix, z. B. /my-plugin:hello, sodass zwei Plugins jeweils einen hello-Skill bereitstellen können, ohne zu kollidieren.

​

Erstellen Sie Ihr erstes Plugin

mkdir -p my-first-plugin/.claude-plugin

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}

mkdir -p my-first-plugin/skills/hello

---
name: hello
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

claude plugin validate ./my-first-plugin

claude --plugin-dir ./my-first-plugin

/my-first-plugin:hello

​

Teilen Sie Ihr Plugin

• Senden Sie es direkt an ein paar Personen: geben Sie ihnen das Plugin-Verzeichnis oder eine .zip davon, und nichts muss veröffentlicht werden. Siehe Teilen Sie ein Plugin ohne einen Marketplace.
• Listen Sie es in Ihrem eigenen Marketplace auf: Teamkollegen fügen Ihren Marketplace einmal hinzu und installieren das Plugin nach Name, und sie erhalten Ihre Updates. Siehe Veröffentlichen Sie über Ihren eigenen Marketplace.
• Reichen Sie es bei Anthropics Community-Marketplace ein: Sobald es aufgelistet ist, kann jeder, der diesen Marketplace hinzufügt, es installieren. Siehe Reichen Sie beim Community-Marketplace ein.

​

Plugin-Layout

​

Entwickeln Sie ohne einen Marketplace

• --plugin-dir: lädt ein Verzeichnis oder .zip-Archiv für eine Sitzung.
• --plugin-url: ruft ein .zip-Archiv von einer URL für eine Sitzung ab.
• claude plugin init: erstellt ein Plugin unter ~/.claude/skills/, das in jeder Sitzung geladen wird.

​

Laden Sie ein Plugin für eine Sitzung

​

Von einem Verzeichnis oder .zip

claude --plugin-dir ./my-first-plugin --plugin-dir ./other-plugin.zip

​

Von einem Ordner mit Plugins

• Ein Unterordner, den Sie hinzufügen, wird als neues Plugin geladen, sobald sein Manifest vorhanden ist.
• Wenn Sie einen Unterordner entfernen, wird sein Plugin entladen.

​

Von einer URL

claude --plugin-url https://example.com/my-first-plugin.zip

​

Von einer Umgebungsvariablen

​

Machen Sie ein Plugin in jeder Sitzung geladen

​

Erstellen Sie das Plugin mit claude plugin init

claude plugin init my-tool

​

Benennen Sie die Skills des Plugins

​

Stoppen Sie das Laden des Plugins

​

Teilen Sie das Plugin über ein Repository

​

Testen und Debuggen

1. Führen Sie in Ihrer Shell claude plugin validate <path> aus. Es überprüft das Manifest und das Frontmatter jeder Skill-, Agent- und Command-Datei und beendet sich mit 0 bei Validation passed. Fügen Sie --strict hinzu, um auch bei Warnungen fehlzuschlagen. Exit-Codes und Verzeichnisbehandlung sind in der Plugin-Befehls-Referenz.
2. Führen Sie in der laufenden Sitzung /reload-plugins aus, um Änderungen anzuwenden, die Sie auf der Festplatte vorgenommen haben. Es gibt eine Reloaded:-Zeile mit Zählungen aus. Bestätigen Sie dann, dass ein Skill geladen wurde, indem Sie seinen /plugin-name:skill-Befehl eingeben, oder indem Sie das Plugin auf der Registerkarte Installed von /plugin finden.
3. Führen Sie in der gleichen Sitzung /plugin aus. Die Registerkarte Installed listet Ihr Plugin auf und zeigt in den Details des Plugins die Komponenten, die Claude Code gefunden hat. Die Registerkarte Errors listet auf, was nicht geladen wurde und warum, z. B. ein Pfad in Ihrem Manifest, der nicht existiert.
4. Führen Sie in Ihrer Shell claude plugin list aus. Es gibt Session-only- und Skills-Directory-Plugins in ihren eigenen Abschnitten mit Status: ✔ loaded oder dem Ladefehler aus. Um das Plugin einzubeziehen, das Sie entwickeln, übergeben Sie --plugin-dir mit seinem Pfad vor plugin list.

​

Ein Komponentenpfad wird nicht gefunden

​

--plugin-dir bei einem Marketplace-Root lädt die Plugins unter plugins/ nicht

​

Das Plugin wird geladen, aber seine Skills fehlen

​

Der userConfig-Dialog wird nie angezeigt

​

Überprüfen Sie, dass das Plugin Claudes Verhalten ändert

​

Konvertieren Sie ein vorhandenes .claude/-Setup

mkdir -p my-plugin/.claude-plugin

{
  "name": "my-plugin",
  "description": "Migrated from standalone configuration",
  "version": "1.0.0"
}

cp -r .claude/commands my-plugin/

cp -r .claude/agents my-plugin/

cp -r .claude/skills my-plugin/

mkdir -p my-plugin/hooks

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]
      }
    ]
  }
}

claude --plugin-dir ./my-plugin

• Skills und Agents: die beiden Sätze kollidieren nicht, da die Skills und Agents des Plugins das Präfix my-plugin: tragen. /deploy und /my-plugin:deploy funktionieren beide, und Claude sieht reviewer und my-plugin:reviewer als zwei Subagents.
• Hooks: Hooks haben kein Präfix, sodass ein Hook, der sowohl in Ihrer Einstellungsdatei als auch in hooks/hooks.json ist, jedes Mal zweimal ausgeführt wird, wenn sein Ereignis auslöst.

​

Nächste Schritte

• Plugin-Komponenten: fügen Sie Agents, Hooks, MCP-Server, LSP-Server und Benutzerkonfiguration zu Ihrem Plugin hinzu
• Testen Sie Plugins mit Evals: schreiben Sie Eval-Fälle und führen Sie sie mit claude plugin eval aus, um zu überprüfen, wie zuverlässig das Plugin Claudes Verhalten steuert
• Veröffentlichen Sie ein Plugin: versionieren Sie es, setzen Sie es in einen Marketplace und reichen Sie es beim Community-Marketplace ein
• Plugins auf claude.ai und in Cowork: derselbe Plugin-Ordner wird auf claude.ai und in Cowork installiert. Einige Komponenten sind nur für Claude Code
• Plugin-Manifest-Referenz: jedes plugin.json-Feld, jede Pfadregel und jedes Verzeichnis
• Skills: schreiben Sie die Skills, die Ihr Plugin bereitstellt
• Anthropics Plugins im claude-code-Repository: vollständige durchgearbeitete Beispiele des Layouts auf dieser Seite, z. B. feature-dev und code-review