Plugins erstellen

​

Wann Plugins vs. eigenständige Konfiguration verwenden

• Sie Claude Code für ein einzelnes Projekt anpassen
• Die Konfiguration persönlich ist und nicht freigegeben werden muss
• Sie mit Schrägstrichbefehlen oder Hooks experimentieren, bevor Sie sie verpacken
• Sie kurze Schrägstrichbefehlsnamen wie /hello oder /review möchten

• Sie Funktionen mit Ihrem Team oder der Community teilen möchten
• Sie die gleichen Schrägstrichbefehle/Agenten über mehrere Projekte hinweg benötigen
• Sie Versionskontrolle und einfache Updates für Ihre Erweiterungen möchten
• Sie über einen Marketplace verteilen
• Sie mit Namespace-Schrägstrichbefehlen wie /my-plugin:hello einverstanden sind (Namespacing verhindert Konflikte zwischen Plugins)

​

Schnelleinstieg

​

Voraussetzungen

• Claude Code installiert und authentifiziert
• Claude Code Version 1.0.33 oder später (führen Sie claude --version aus, um zu überprüfen)

​

Erstellen Sie Ihr erstes Plugin

mkdir my-first-plugin

mkdir 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 my-first-plugin/commands

---
description: Greet the user with a friendly message
---

# Hello Command

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

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

/my-first-plugin:hello

---
description: Greet the user with a personalized message
---

# Hello Command

Greet the user named "$ARGUMENTS" warmly and ask how you can help them today. Make the greeting personal and encouraging.

/my-first-plugin:hello Alex

• Plugin-Manifest (.claude-plugin/plugin.json): beschreibt die Metadaten Ihres Plugins
• Befehls-Verzeichnis (commands/): enthält Ihre benutzerdefinierten Schrägstrichbefehle
• Befehlsargumente ($ARGUMENTS): erfasst Benutzereingaben für dynamisches Verhalten

​

Plugin-Struktur-Übersicht

​

Entwickeln Sie komplexere Plugins

​

Fügen Sie Skills zu Ihrem Plugin hinzu

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

---
name: code-review
description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
---

When reviewing code, check for:
1. Code organization and structure
2. Error handling
3. Security concerns
4. Test coverage

​

Fügen Sie LSP-Server zu Ihrem Plugin hinzu

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

​

Organisieren Sie komplexe Plugins

​

Testen Sie Ihre Plugins lokal

claude --plugin-dir ./my-plugin

• Versuchen Sie Ihre Befehle mit /command-name
• Überprüfen Sie, dass Agenten in /agents angezeigt werden
• Überprüfen Sie, dass Hooks wie erwartet funktionieren

claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two

​

Debuggen Sie Plugin-Probleme

1. Überprüfen Sie die Struktur: Stellen Sie sicher, dass Ihre Verzeichnisse auf der Plugin-Root-Ebene sind, 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

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 Marketplace: Verteilen Sie über Plugin-Marketplaces zur Installation
4. Testen Sie mit anderen: Lassen Sie Teamkollegen das Plugin vor einer breiteren Verteilung testen

​

Konvertieren Sie vorhandene Konfigurationen in Plugins

​

Migrationschritte

mkdir -p my-plugin/.claude-plugin

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

# Copy commands
cp -r .claude/commands my-plugin/

# Copy agents (if any)
cp -r .claude/agents my-plugin/

# Copy skills (if any)
cp -r .claude/skills my-plugin/

mkdir my-plugin/hooks

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{ "type": "command", "command": "npm run lint:fix $FILE" }]
      }
    ]
  }
}

claude --plugin-dir ./my-plugin

​

Was sich bei der Migration ändert

​

Nächste Schritte

​

Für Plugin-Benutzer

• Plugins entdecken und installieren: Durchsuchen Sie Marketplaces und installieren Sie Plugins
• Konfigurieren Sie Team-Marketplaces: Richten Sie Repository-Level-Plugins für Ihr Team ein

​

Für Plugin-Entwickler

• Erstellen und verteilen Sie einen Marketplace: Verpacken und teilen Sie Ihre Plugins
• Plugins-Referenz: Vollständige technische Spezifikationen
• Tauchen Sie tiefer in spezifische Plugin-Komponenten ein:
  • Schrägstrichbefehle: Befehlsentwicklungsdetails
  • Subagenten: Agent-Konfiguration und Fähigkeiten
  • Agent-Skills: Erweitern Sie die Fähigkeiten von Claude
  • Hooks: Event-Handling und Automatisierung
  • MCP: Integration externer Tools