Zum Hauptinhalt springen
Vollständige technische Spezifikationen und Schemas finden Sie unter Plugins-Referenz. Für die Verwaltung von Marktplätzen siehe Plugin-Marktplätze.
Plugins ermöglichen es Ihnen, Claude Code mit benutzerdefinierten Funktionen zu erweitern, die über Projekte und Teams hinweg gemeinsam genutzt werden können. Installieren Sie Plugins von Marktplätzen, um vorgefertigte Befehle, Agenten, Hooks, Skills und MCP-Server hinzuzufügen, oder erstellen Sie Ihre eigenen, um Ihre Workflows zu automatisieren.

​
Schnellstart

Lassen Sie uns ein einfaches Greeting-Plugin erstellen, um Sie mit dem Plugin-System vertraut zu machen. Wir werden ein funktionierendes Plugin erstellen, das einen benutzerdefinierten Befehl hinzufügt, es lokal testen und die Kernkonzepte verstehen.

​
Voraussetzungen

  • Claude Code auf Ihrem Computer installiert
  • Grundlegende Vertrautheit mit Befehlszeilentools

​
Erstellen Sie Ihr erstes Plugin

1

Erstellen Sie die Marktplatz-Struktur

mkdir test-marketplace
cd test-marketplace
2

Erstellen Sie das Plugin-Verzeichnis

mkdir my-first-plugin
cd my-first-plugin
3

Erstellen Sie das Plugin-Manifest

Create .claude-plugin/plugin.json
mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
"name": "my-first-plugin",
"description": "A simple greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
EOF
4

Fügen Sie einen benutzerdefinierten Befehl hinzu

Create commands/hello.md
mkdir commands
cat > commands/hello.md << 'EOF'
---
description: Greet the user with a personalized message
---

# Hello Command

Greet the user warmly and ask how you can help them today. Make the greeting personal and encouraging.
EOF
5

Erstellen Sie das Marktplatz-Manifest

Create marketplace.json
cd ..
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "test-marketplace",
"owner": {
"name": "Test User"
},
"plugins": [
{
  "name": "my-first-plugin",
  "source": "./my-first-plugin",
  "description": "My first test plugin"
}
]
}
EOF
6

Installieren und testen Sie Ihr Plugin

Start Claude Code from parent directory
cd ..
claude
Add the test marketplace
/plugin marketplace add ./test-marketplace
Install your plugin
/plugin install my-first-plugin@test-marketplace
Wählen Sie „Jetzt installieren”. Sie müssen Claude Code dann neu starten, um das neue Plugin zu verwenden.
Try your new command
/hello
Sie werden sehen, wie Claude Ihren Greeting-Befehl verwendet! Überprüfen Sie /help, um Ihren neuen Befehl aufgelistet zu sehen.
Sie haben erfolgreich ein Plugin mit diesen Schlüsselkomponenten erstellt und getestet:
  • Plugin-Manifest (.claude-plugin/plugin.json) - Beschreibt die Metadaten Ihres Plugins
  • Befehls-Verzeichnis (commands/) - Enthält Ihre benutzerdefinierten Schrägstrich-Befehle
  • Test-Marktplatz - Ermöglicht es Ihnen, Ihr Plugin lokal zu testen

​
Übersicht der Plugin-Struktur

Ihr Plugin folgt dieser grundlegenden Struktur: 
my-first-plugin/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata
├── commands/                 # Custom slash commands (optional)
│   └── hello.md
├── agents/                   # Custom agents (optional)
│   └── helper.md
├── skills/                   # Agent Skills (optional)
│   └── my-skill/
│       └── SKILL.md
└── hooks/                    # Event handlers (optional)
    └── hooks.json
Zusätzliche Komponenten, die Sie hinzufügen können:
  • Befehle: Erstellen Sie Markdown-Dateien im Verzeichnis commands/
  • Agenten: Erstellen Sie Agent-Definitionen im Verzeichnis agents/
  • Skills: Erstellen Sie SKILL.md-Dateien im Verzeichnis skills/
  • Hooks: Erstellen Sie hooks/hooks.json für die Event-Behandlung
  • MCP-Server: Erstellen Sie .mcp.json für die Integration externer Tools
Nächste Schritte: Bereit, weitere Funktionen hinzuzufügen? Springen Sie zu Entwickeln Sie komplexere Plugins, um Agenten, Hooks und MCP-Server hinzuzufügen. Für vollständige technische Spezifikationen aller Plugin-Komponenten siehe Plugins-Referenz.

​
Installieren und verwalten Sie Plugins

Erfahren Sie, wie Sie Plugins entdecken, installieren und verwalten, um Ihre Claude Code-Funktionen zu erweitern.

​
Voraussetzungen

  • Claude Code installiert und ausgeführt
  • Grundlegende Vertrautheit mit Befehlszeilenschnittstellen

​
Fügen Sie Marktplätze hinzu

Marktplätze sind Kataloge verfügbarer Plugins. Fügen Sie sie hinzu, um Plugins zu entdecken und zu installieren:
Add a marketplace
/plugin marketplace add your-org/claude-plugins
Browse available plugins
/plugin
Für detaillierte Marktplatz-Verwaltung, einschließlich Git-Repositories, lokale Entwicklung und Team-Verteilung, siehe Plugin-Marktplätze.

​
Installieren Sie Plugins

​
Über interaktives Menü (empfohlen für die Entdeckung)

Open the plugin management interface
/plugin
Wählen Sie „Plugins durchsuchen”, um verfügbare Optionen mit Beschreibungen, Funktionen und Installationsoptionen zu sehen.

​
Über direkte Befehle (für schnelle Installation)

Install a specific plugin
/plugin install formatter@your-org
Enable a disabled plugin
/plugin enable plugin-name@marketplace-name
Disable without uninstalling
/plugin disable plugin-name@marketplace-name
Completely remove a plugin
/plugin uninstall plugin-name@marketplace-name

​
Überprüfen Sie die Installation

Nach der Installation eines Plugins:
  1. Überprüfen Sie verfügbare Befehle: Führen Sie /help aus, um neue Befehle zu sehen
  2. Testen Sie Plugin-Funktionen: Probieren Sie die Befehle und Funktionen des Plugins aus
  3. Überprüfen Sie Plugin-Details: Verwenden Sie /plugin → „Plugins verwalten”, um zu sehen, was das Plugin bietet

​
Richten Sie Team-Plugin-Workflows ein

Konfigurieren Sie Plugins auf Repository-Ebene, um konsistente Tools über Ihr Team hinweg sicherzustellen. Wenn Team-Mitglieder Ihren Repository-Ordner vertrauen, installiert Claude Code automatisch angegebene Marktplätze und Plugins. So richten Sie Team-Plugins ein:
  1. Fügen Sie Marktplatz- und Plugin-Konfiguration zu .claude/settings.json Ihres Repositorys hinzu
  2. Team-Mitglieder vertrauen dem Repository-Ordner
  3. Plugins werden automatisch für alle Team-Mitglieder installiert
Für vollständige Anweisungen, einschließlich Konfigurationsbeispielen, Marktplatz-Setup und Best Practices für die Einführung, siehe Konfigurieren Sie Team-Marktplätze.

​
Entwickeln Sie komplexere Plugins

Sobald Sie sich mit grundlegenden Plugins vertraut gemacht haben, können Sie anspruchsvollere Erweiterungen erstellen.

​
Fügen Sie Skills zu Ihrem Plugin hinzu

Plugins können Agent Skills enthalten, um die Fähigkeiten von Claude zu erweitern. Skills werden vom Modell aufgerufen – Claude verwendet sie autonom basierend auf dem Task-Kontext. Um Skills zu Ihrem Plugin hinzuzufügen, erstellen Sie ein Verzeichnis skills/ in Ihrem Plugin-Root und fügen Sie Skill-Ordner mit SKILL.md-Dateien hinzu. Plugin-Skills sind automatisch verfügbar, wenn das Plugin installiert ist. Für vollständige Anleitung zur Skill-Erstellung siehe Agent Skills.

​
Organisieren Sie komplexe Plugins

Für Plugins mit vielen Komponenten organisieren Sie Ihre Verzeichnisstruktur nach Funktionalität. Für vollständige Verzeichnis-Layouts und Organisationsmuster siehe Plugin-Verzeichnisstruktur.

​
Testen Sie Ihre Plugins lokal

Bei der Entwicklung von Plugins verwenden Sie einen lokalen Marktplatz, um Änderungen iterativ zu testen. Dieser Workflow baut auf dem Quickstart-Muster auf und funktioniert für Plugins jeder Komplexität.
1

Richten Sie Ihre Entwicklungsstruktur ein

Organisieren Sie Ihr Plugin und Ihren Marktplatz zum Testen:
Create directory structure
mkdir dev-marketplace
cd dev-marketplace
mkdir my-plugin
Dies erstellt:
dev-marketplace/
├── .claude-plugin/marketplace.json  (you'll create this)
└── my-plugin/                        (your plugin under development)
    ├── .claude-plugin/plugin.json
    ├── commands/
    ├── agents/
    └── hooks/
2

Erstellen Sie das Marktplatz-Manifest

Create marketplace.json
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "dev-marketplace",
"owner": {
"name": "Developer"
},
"plugins": [
{
  "name": "my-plugin",
  "source": "./my-plugin",
  "description": "Plugin under development"
}
]
}
EOF
3

Installieren und testen

Start Claude Code from parent directory
cd ..
claude
Add your development marketplace
/plugin marketplace add ./dev-marketplace
Install your plugin
/plugin install my-plugin@dev-marketplace
Testen Sie Ihre Plugin-Komponenten:
  • Probieren Sie Ihre Befehle mit /command-name aus
  • Überprüfen Sie, dass Agenten in /agents angezeigt werden
  • Überprüfen Sie, dass Hooks wie erwartet funktionieren
4

Iterieren Sie über Ihr Plugin

Nach Änderungen an Ihrem Plugin-Code:
Uninstall the current version
/plugin uninstall my-plugin@dev-marketplace
Reinstall to test changes
/plugin install my-plugin@dev-marketplace
Wiederholen Sie diesen Zyklus, während Sie Ihr Plugin entwickeln und verfeinern.
Für mehrere Plugins: Organisieren Sie Plugins in Unterverzeichnissen wie ./plugins/plugin-name und aktualisieren Sie Ihre marketplace.json entsprechend. Siehe Plugin-Quellen für Organisationsmuster.

​
Debuggen Sie Plugin-Probleme

Wenn Ihr Plugin nicht wie erwartet funktioniert:
  1. Überprüfen Sie die Struktur: Stellen Sie sicher, dass Ihre Verzeichnisse sich im Plugin-Root befinden, nicht in .claude-plugin/
  2. Testen Sie Komponenten einzeln: Überprüfen Sie jeden Befehl, Agenten und Hook separat
  3. Verwenden Sie Validierungs- und Debugging-Tools: Siehe Debugging- und Entwicklungstools für CLI-Befehle und Fehlerbehebungstechniken

​
Teilen Sie Ihre Plugins

Wenn Ihr Plugin bereit zum Teilen ist:
  1. Fügen Sie Dokumentation hinzu: Fügen Sie eine README.md mit Installations- und Verwendungsanweisungen ein
  2. Versionieren Sie Ihr Plugin: Verwenden Sie semantische Versionierung in Ihrer plugin.json
  3. Erstellen oder verwenden Sie einen Marktplatz: Verteilen Sie über Plugin-Marktplätze für einfache Installation
  4. Testen Sie mit anderen: Lassen Sie Team-Mitglieder das Plugin vor einer breiteren Verteilung testen
Für vollständige technische Spezifikationen, Debugging-Techniken und Verteilungsstrategien siehe Plugins-Referenz.

​
Nächste Schritte

Jetzt, da Sie das Plugin-System von Claude Code verstehen, finden Sie hier empfohlene Pfade für verschiedene Ziele:

​
Für Plugin-Benutzer

  • Entdecken Sie Plugins: Durchsuchen Sie Community-Marktplätze nach nützlichen Tools
  • Team-Adoption: Richten Sie Plugins auf Repository-Ebene für Ihre Projekte ein
  • Marktplatz-Verwaltung: Erfahren Sie, wie Sie mehrere Plugin-Quellen verwalten
  • Erweiterte Nutzung: Erkunden Sie Plugin-Kombinationen und Workflows

​
Für Plugin-Entwickler

  • Erstellen Sie Ihren ersten Marktplatz: Plugin-Marktplätze-Anleitung
  • Erweiterte Komponenten: Tauchen Sie tiefer in spezifische Plugin-Komponenten ein:
  • Verteilungsstrategien: Packen und teilen Sie Ihre Plugins effektiv
  • Community-Beitrag: Erwägen Sie, zu Community-Plugin-Sammlungen beizutragen

​
Für Team-Leads und Administratoren

  • Repository-Konfiguration: Richten Sie automatische Plugin-Installation für Team-Projekte ein
  • Plugin-Governance: Etablieren Sie Richtlinien für Plugin-Genehmigung und Sicherheitsüberprüfung
  • Marktplatz-Wartung: Erstellen und verwalten Sie organisationsspezifische Plugin-Kataloge
  • Training und Dokumentation: Helfen Sie Team-Mitgliedern, Plugin-Workflows effektiv zu übernehmen

​
Siehe auch

  • Plugin-Marktplätze - Erstellen und Verwalten von Plugin-Katalogen
  • Schrägstrich-Befehle - Verstehen Sie benutzerdefinierte Befehle
  • Subagenten - Erstellen und Verwenden spezialisierter Agenten
  • Agent Skills - Erweitern Sie die Fähigkeiten von Claude
  • Hooks - Automatisieren Sie Workflows mit Event-Handlern
  • MCP - Verbinden Sie sich mit externen Tools und Diensten
  • Einstellungen - Konfigurationsoptionen für Plugins