Marketplace-Referenz

• Die Marketplace-Datei: Top-Level-Felder und Plugin-Einträge
• Die source eines Eintrags: Plugin-Quellen
• Ein source-Objekt in Einstellungen: Marketplace-Quellen
• Ausgabe von claude plugin validate <path>: Validierungsmeldungen, die jede Meldung dem Feld zuordnet, das sie benennt

​

Marketplace-Datei

​

Reservierte Namen

• Offizielle Marketplace-Namen: claude-code-marketplace, claude-code-plugins, claude-plugins-official, anthropic-marketplace, anthropic-plugins, agent-skills, anthropic-agent-skills, life-sciences, knowledge-work-plugins, claude-for-legal, claude-for-financial-services, financial-services-plugins, first-party-plugins und claude-tag-plugins. Reserviert, es sei denn, der Marketplace stammt von einer github- oder git-Marketplace-Quelle unter github.com/anthropics/.
• Community-Marketplace-Namen: claude-community, claude-plugins-community und healthcare. Reserviert nach der gleichen Regel wie die offiziellen Namen.
• Plugin-Verzeichnisnamen: anthropic-plugin-directory und claude-plugin-directory. Reserviert nach der gleichen Regel wie die offiziellen Namen.
• Namen, die einen offiziellen Marketplace imitieren: Namen wie official-claude-plugins oder claude-plugins-v2 und jeder Name, der ein Nicht-ASCII-Zeichen enthält. Der Fehler ist Marketplace name impersonates an official Anthropic/Claude marketplace. Ein Steuerzeichen oder bidirektionales Formatierungszeichen in einem Namen meldet auch Marketplace name cannot contain control or bidirectional-formatting characters.
• Eine andere Schreibweise eines reservierten Namens: ein Name, der sich von einem reservierten Namen nur durch einen nachgestellten Punkt oder durch ein Symbol anstelle eines Bindestrichs unterscheidet, daher zählt claude.code.plugins als claude-code-plugins. claude plugin validate akzeptiert einen solchen Namen; das Hinzufügen des Marketplace schlägt mit is another spelling of "<reserved>", a reserved marketplace name fehl, und ein bereits unter einem registrierter Marketplace wird nicht mehr geladen. Diese Überprüfung erfordert Claude Code v2.1.280 oder später.
• Namen, die Claude Code für Plugins verwendet, die nicht von einem Marketplace stammen: inline für Plugins, die mit --plugin-dir geladen werden, builtin für integrierte Plugins, skills-dir für Plugins, die automatisch von .claude/skills/ geladen werden, und synced für Plugins, die von Ihrem claude.ai-Konto synchronisiert werden. claude-plugin-test ist ebenfalls reserviert. skills-dir erscheint auch als {"source": "skills-dir"} in strictKnownMarketplaces und blockedMarketplaces, beschrieben unter Quellwerte, die nur in Richtlinienlisten gültig sind.
• npm, pip, uv, cargo, github und gh: reserviert in jeder Schreibweise. Diese Überprüfung erfordert Claude Code v2.1.275 oder später.
• Namen, die mit claudeai- beginnen: reserviert für Marketplaces, die auf claude.ai gehostet werden. claude plugin marketplace add lehnt jeden anderen Marketplace ab, der einen mit Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai verwendet.

​

Top-Level-Felder

​

Plugin-Einträge

​

Wie ein Eintrag mit plugin.json kombiniert wird

• Keine plugin.json: Der Eintrag ist das Manifest unabhängig von strict. Jedes Manifest-Feld im Eintrag gilt, einschließlich mcpServers, lspServers, userConfig und channels.
• plugin.json vorhanden: plugin.json ist das Manifest. Der Strict-Modus entscheidet, ob die sechs Komponentenfelder des Eintrags, commands, agents, skills, hooks, outputStyles und themes, damit kombiniert oder als Konflikt abgelehnt werden. Eintrag mcpServers, lspServers, userConfig und channels gelten nicht. Deklarieren Sie sie in plugin.json.

​

Hooks in einem Eintrag

​

Anzeigefelder

• Für ein Feld, das Sie auf dem Eintrag setzen, sehen Benutzer den Wert des Eintrags, auch wenn plugin.json einen anderen setzt.
• Für ein Feld, das der Eintrag nicht setzt, sehen Benutzer den plugin.json-Wert.

​

Strict-Modus

​

Plugin-Quellen

• ref: ein Branch oder Tag. Standardmäßig der Standard-Branch des Repository.
• sha: eine vollständige 40-stellige Kleinbuchstaben-Commit-SHA. Wenn Sie sowohl ref als auch sha setzen, checkt Claude Code sha aus. Auf den meisten Git-Hosts, einschließlich GitHub, GitLab und Bitbucket, bedeutet dies, dass die Installation erfolgreich ist, auch wenn der Branch oder Tag, der von ref benannt wird, seitdem upstream gelöscht wurde, solange der Commit noch vom Repository erreichbar ist. Einige Server, wie AWS CodeCommit, unterstützen das Abrufen von Commits nach SHA nicht. Auf diesen Servern muss ref noch existieren und der angeheftete Commit muss von ihm erreichbar sein.

​

Relative Pfad-Plugin-Quelle

{ "name": "formatter", "source": "./plugins/formatter" }

• github, git, file und directory: Claude Code hat die Dateien des Marketplace.
• url: Claude Code ruft nur marketplace.json ab, daher können sich relative Pfade nicht auflösen. Geben Sie jedem Plugin stattdessen eine Objekt-Quelle, wie github oder git-subdir.
• settings: relative Pfade werden sofort abgelehnt.

​

Bare Names unter pluginRoot

• Es muss selbst ein relativer Pfad im Marketplace sein.
• Es hat keine Auswirkung auf eine Quelle, die bereits mit ./ beginnt.
• Eine Quelle, die ein / enthält, wie team-a/formatter, ist kein bare Name und benötigt immer noch das ./-Präfix, auch wenn metadata.pluginRoot gesetzt ist.

​

github Plugin-Quelle

{
  "name": "formatter",
  "source": {
    "source": "github",
    "repo": "your-org/formatter",
    "ref": "v2.0.0",
    "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
  }
}

​

url Plugin-Quelle

{
  "name": "formatter",
  "source": {
    "source": "url",
    "url": "https://gitlab.example.com/your-group/formatter.git",
    "ref": "main"
  }
}

​

git-subdir Plugin-Quelle

{
  "name": "formatter",
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/your-org/monorepo.git",
    "path": "tools/formatter"
  }
}

​

npm Plugin-Quelle

• package: ein Paketname oder ein scoped Name wie @your-org/formatter
• version: eine Version oder ein Bereich
• registry: eine Registry-URL für ein Paket, das nicht in der Standard-Registry ist

{
  "name": "formatter",
  "source": {
    "source": "npm",
    "package": "@your-org/formatter",
    "version": "^2.0.0",
    "registry": "https://npm.example.com"
  }
}

​

archive Plugin-Quelle

{
  "name": "formatter",
  "source": {
    "source": "archive",
    "url": "https://artifacts.example.com/formatter-2.0.0.zip",
    "sha256": "6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1"
  }
}

​

command Plugin-Quelle

• command: ein Shell-Befehl, der den absoluten Pfad des Plugin-Verzeichnisses als eine Zeile druckt und mit 0 beendet. Claude Code zeigt Benutzern die ganze Zeichenfolge zur Überprüfung an, bevor sie ausgeführt wird. Schreiben Sie sie als druckbares ASCII, höchstens 500 Zeichen, ohne vier oder mehr Leerzeichen hintereinander.
• timeout: eine ganze Zahl von Sekunden von 1 bis 600. Standardmäßig 60.
• mode: copy, der Standard, oder link. Siehe Copy-Modus und Link-Modus.

{
  "name": "formatter",
  "source": {
    "source": "command",
    "command": "my-tool claude-plugin-path",
    "timeout": 120
  }
}

​

Was der Befehl tun muss

• Shell und Arbeitsverzeichnis: Claude Code führt den Befehl durch sh oder auf Windows durch cmd.exe aus dem Home-Verzeichnis des Benutzers aus. Geben Sie einen absoluten Pfad oder einen Befehl auf PATH an.
• Ausgabe: drucken Sie genau eine Zeile auf stdout, den absoluten Pfad des Plugin-Verzeichnisses, und beenden Sie mit 0 innerhalb von timeout Sekunden.
• Verzeichnisinhalte: das Verzeichnis enthält das vollständige Plugin, wenn der Befehl beendet wird. Der Pfad kann sich von Lauf zu Lauf unterscheiden.

​

Ausgabe, die die Installation oder Aktualisierung fehlschlagen lässt

• Kein Plugin-Inhalt: das gedruckte Verzeichnis hat keinen Plugin-Inhalt auf seiner obersten Ebene, wie ein .claude-plugin/-Verzeichnis oder ein skills/-, commands/-, agents/- oder hooks/-Verzeichnis.
• Das Verzeichnis der Sitzung selbst: das gedruckte Verzeichnis ist das, in dem Claude Code gestartet wurde, oder eines seiner übergeordneten Verzeichnisse.
• Ein Netzwerkpfad: auf Windows ist der gedruckte Pfad ein UNC-Pfad.
• Zu groß zum Kopieren: im Copy-Modus ist das Verzeichnis größer als 256 MiB oder hat mehr als 20.000 Einträge.

​

Copy-Modus und Link-Modus

• copy: Claude Code kopiert das Verzeichnis in den Plugin-Cache und leitet die Plugin-Version von einem Hash der kopierten Dateien ab. Ihr Tool kann das Verzeichnis nach dem Beenden des Befehls löschen oder umschreiben. Ein erneuter Lauf, der identische Dateien erzeugt, zählt als aktuell.
• link: Claude Code füllt den Cache-Eintrag des Plugins mit einem Link zu jedem Top-Level-Eintrag des gedruckten Verzeichnisses und lädt die Dateien an Ort und Stelle. Nichts wird kopiert, Dateiinhalte werden nicht gehasht, und die Größenlimits gelten nicht. Verwenden Sie es für ein Verzeichnis, das zu groß zum Kopieren ist, wie einen gerenderten SDK-Export.

• Halten Sie das Verzeichnis an Ort und Stelle: Claude Code lädt das Plugin bei jedem Start durch die Links, daher muss das gedruckte Verzeichnis bleiben, wo es ist, solange das Plugin installiert bleibt.
• Drucken Sie einen anderen Pfad, um neuen Inhalt zu signalisieren: die Version kommt vom echten Pfad des gedruckten Verzeichnisses und seinen Top-Level-Einträgen, nicht von den Dateien darin.
• Halten Sie Top-Level-Symlinks im Verzeichnis: die Installation schlägt fehl, wenn ein Top-Level-Eintrag ein Symlink ist, der außerhalb des gedruckten Verzeichnisses verweist.
• Schließen Sie node_modules ein: Claude Code überspringt die Node.js-Paketabhängigkeitsinstallation für ein Link-Modus-Plugin, daher drucken Sie ein Verzeichnis, das bereits die Pakete enthält, die das Plugin benötigt.
• Sitzungen, die im Verzeichnis gestartet werden: eine Sitzung, die im gedruckten Verzeichnis oder irgendwo darunter gestartet wird, lädt das Plugin nicht.
• Nicht auf Windows: Claude Code lehnt die Installation eines Link-Modus-Plugins auf Windows ab. Deklarieren Sie "mode": "copy" dort.

​

Marketplace-Quellen

• claude plugin marketplace add: Claude Code erstellt die Quelle aus der Zeichenfolge, die Sie übergeben.
• extraKnownMarketplaces: Sie schreiben die Quelle selbst als das source-Objekt.
• strictKnownMarketplaces und blockedMarketplaces: Administratoren schreiben Quellen in diese zwei Richtlinienlisten. strictKnownMarketplaces ist die Allowlist und blockedMarketplaces ist die Blocklist.

​

Felder nach Typ

​

Quellwerte, die nur in Richtlinienlisten gültig sind

• hostPattern und pathPattern: reguläre Ausdrücke, die Claude Code gegen eine Quelle testet, bevor er von ihr abruft.
• skills-dir: keine Quelle. Wenn Sie strictKnownMarketplaces überhaupt setzen, Skills-Verzeichnis-Plugins stoppen das Laden, bis Sie {"source": "skills-dir"} zu dieser Liste hinzufügen.
• owner/*: als ein github repo-Wert passt jedes Repository unter genau diesem GitHub-Besitzer. Erfordert Claude Code v2.1.223 oder später.

​

Quellobjekte in Einstellungen

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": {
        "source": "git",
        "url": "https://git.example.com/your-org/your-marketplace.git",
        "ref": "main"
      }
    }
  }
}

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "your-org/*" },
    { "source": "hostPattern", "hostPattern": "^git\\.example\\.com$" }
  ]
}

​

Validierungsmeldungen

​

Ungültige Eingabe auf einer Quelle

• Ein relativer Pfad, der nicht mit ./ beginnt, außer "." oder einem bare Name unter metadata.pluginRoot
• Ein npm package, das .. enthält
• Ein source-Typ, der nicht einer der Plugin-Quellen ist
• Ein bekannter Typ mit einem erforderlichen Feld, das fehlt oder den falschen Typ hat, wie github ohne repo

​

Fehler, die die Validierung nicht erfasst

​

Nächste Schritte

• Marketplace erstellen: Erstellen Sie einen Marketplace aus diesen Feldern und installieren Sie ihn lokal
• Marketplace hosten und verwalten: Wo Sie die Datei ablegen und wie Benutzer Änderungen erhalten
• Plugin-Manifest-Referenz: Die plugin.json-Felder, die ein Eintrag überschreiben kann
• Plugins für Ihre Organisation verwalten: Allowlist- und Blocklist-Rezepte, die diese Quellwerte verwenden