Plugins installieren und verwalten

Installieren Sie Claude Code-Plugins aus einem Marketplace auf jeder Oberfläche, die Sie verwenden, wählen Sie einen Installationsbereich aus, und aktualisieren oder entfernen Sie sie später.

Das Installieren eines Plugins fügt seine Skills, Agents, Hooks und MCP-Server zu Claude Code auf Ihrem Computer hinzu.

Diese Seite ist für alle gedacht, die Plugins auf ihrem eigenen Computer oder Konto verwenden, ob im Terminal, in der Desktop-App, einer IDE oder einer Cloud-Sitzung: Sie behandelt Installation, Bereichswahl, Hinzufügen von Marketplaces und Aktualisierung von Plugins.

Beginnen Sie mit Plugin installieren. Wenn Ihnen jemand einen Installationsbefehl gesendet hat, dessen @-Name nicht claude-plugins-official ist, fügen Sie zuerst diesen Marketplace hinzu.

Plugin installieren

Als Beispiel installiert dieser Abschnitt commit-commands aus Anthropics offiziellem Marketplace, das Befehle zum Committen, Pushen und Öffnen von Pull Requests hinzufügt.

Die gleichen Schritte installieren jedes andere Plugin: ersetzen Sie seinen Namen und den Namen seines Marketplace überall dort, wo commit-commands und claude-plugins-official erscheinen. Wenn dieses Plugin aus einem anderen Marketplace stammt, fügen Sie zuerst den Marketplace hinzu.

Wählen Sie den Tab für den Ort, an dem Sie Claude Code ausführen.

/plugin install commit-commands@claude-plugins-official

Wählen Sie einen Installationsbereich

Der Installationsbereich eines Plugins entscheidet, wer das Plugin erhält und welche Einstellungsdatei es als aktiviert aufzeichnet:

• User scope: Das Plugin ist für Sie in jedem Projekt auf diesem Computer aktiviert. Der Eintrag geht in enabledPlugins in ~/.claude/settings.json.
• Project scope: Das Plugin ist für alle aktiviert, die in diesem Repository arbeiten. Der Eintrag geht in .claude/settings.json, das Sie committen.
• Local scope: Das Plugin ist für Sie nur in diesem Repository aktiviert. Der Eintrag geht in .claude/settings.local.json.

Einige Plugins sind vom Autor so eingestellt, dass sie standardmäßig ausgeschaltet sind, über das Feld defaultEnabled. Ein solches Plugin wird installiert, bleibt aber aus, bis Sie es mit claude plugin enable <name> in Ihrer Shell oder von der Registerkarte Installed von /plugin in einer Sitzung aktivieren.

Wenn das gleiche Plugin an mehreren Bereichen gesetzt ist, überschreibt die lokale Einstellung die Projekteinstellung, und die Projekteinstellung überschreibt die Benutzereinstellung. Siehe Finden Sie, wo ein Plugin aktiviert ist für die vollständige Regel.

Das Terminal, die lokalen Sitzungen der Desktop-App und die VS Code-Erweiterung auf einem Computer lesen die gleichen Einstellungsdateien, daher ist ein Plugin, das Sie in einem von ihnen im Benutzerbereich installieren, auch in den anderen beiden verfügbar.

JetBrains, nicht-interaktive Ausführungen und das Agent SDK

Einige Orte, an denen Sie Claude Code ausführen, haben keinen eigenen Plugin-Browser:

• JetBrains IDEs: Das JetBrains-Plugin führt Claude Code im Terminal der IDE aus, daher verwenden Sie die Schritte der Registerkarte Terminal dort.
• claude -p und andere nicht-interaktive Ausführungen: /plugin wird nicht ausgeführt, und Claude antwortet /plugin isn't available in this environment. Plugins, die Sie bereits installiert haben, werden geladen. Installieren und verwalten Sie sie von Ihrer Shell aus mit claude plugin-Befehlen.
• Agent SDK: Laden Sie Plugins über die Plugin-Option des SDK. Siehe Plugins im Agent SDK laden.

Wenn Claude Code meldet, dass ein Plugin, das in der .claude/settings.json des Repositorys aktiviert ist, nicht installiert ist, siehe In Projekteinstellungen aktiviert, aber nicht installiert.

Plugins aus Ihrem claude.ai-Konto

Ihr claude.ai-Konto ist eine separate Quelle von Plugins, neben den Marketplaces, aus denen Sie installieren:

• What arrives: Jedes Plugin, das Sie für Ihr claude.ai-Konto aktivieren, und jedes Plugin, das Ihre Organisation für ihre Mitglieder aktiviert. In einer Terminal-Sitzung werden sie im Hintergrund synchronisiert, jedes Mal wenn Sie Claude Code starten, während Sie mit diesem Konto angemeldet sind; in Cowork-Sitzungen werden sie heruntergeladen, wenn die Sitzung startet.
• Where you see them: in /plugin und claude plugin list unter der ID <name>@synced. Sie können eines ausschalten, es sei denn, Ihre Organisation verlangt es.
• What doesn't go the other way: Plugins, die Sie mit /plugin oder claude plugin install installieren, bleiben auf diesem Computer und werden nicht zu Ihrem claude.ai-Konto hinzugefügt.

Für Synchronisierungszeitpunkt, Anmeldeanforderungen und Ausschalten der Synchronisierung siehe Plugins, die von claude.ai synchronisiert werden.

Von Ihrer Shell installieren

Führen Sie claude plugin install in Ihrer Shell aus, um ein Plugin zu installieren, ohne eine Claude Code-Sitzung zu starten, zum Beispiel aus einem Setup-Skript.

• Scope: Benutzerbereich standardmäßig. Übergeben Sie --scope project oder --scope local, um es zu ändern.
• When the plugins load: Plugins, die es installiert, werden geladen, wenn Sie Claude Code das nächste Mal starten, oder wenn Sie /reload-plugins in einer bereits offenen Sitzung ausführen.
• The marketplace must be added first: Auf einem Computer, auf dem noch niemand eine interaktive Claude Code-Sitzung geöffnet hat, ist der offizielle Marketplace nicht registriert, daher führt ein Skript, das von ihm installiert, zuerst claude plugin marketplace add anthropics/claude-plugins-official aus, bevor die Installation erfolgt.

claude plugin install formatter@your-org --scope project

Der Befehl druckt Successfully installed plugin: formatter@your-org (scope: project), wenn er fertig ist.

Einige Plugins installieren, indem sie einen Befehl ausführen, den ihr Marketplace benennt, genannt eine command-Quelle. Claude Code zeigt Ihnen diesen Befehl und fragt Sie, ihn zu akzeptieren, bevor er ausgeführt wird. Ein Skript hat niemanden, um diese Aufforderung zu beantworten, daher übergeben Sie dort --yes, um es zu akzeptieren.

Für jedes claude plugin install-Flag siehe plugin install.

Marketplace hinzufügen

Sie benötigen diesen Abschnitt nur, wenn das Plugin, das Sie möchten, nicht im offiziellen Marketplace von Anthropic ist, zum Beispiel eines, das ein Kollege veröffentlicht hat, oder eines aus dem Community-Marketplace von Anthropic.

Ein Marketplace ist ein Katalog von Plugins, und Claude Code muss einen Marketplace kennen, bevor Sie von ihm installieren können. Sie fügen einen Marketplace einmal hinzu. Danach erscheinen seine Plugins auf der Registerkarte Discover und installieren mit /plugin install <plugin>@<marketplace> in einer Sitzung oder claude plugin install <plugin>@<marketplace> in Ihrer Shell, wobei <marketplace> der Name ist, unter dem sich der Marketplace registriert hat. Um beides in einem Schritt zu tun, siehe Marketplace hinzufügen und in einem Befehl installieren.

Führen Sie in einer Claude Code-Sitzung /plugin marketplace add gefolgt von der Quelle des Marketplace aus: ein GitHub-Repository, ein Git-Repository auf einem beliebigen Host, ein lokales Verzeichnis oder eine Datei, oder ein gehostetes marketplace.json.

Von Ihrer Shell aus nimmt claude plugin marketplace add die gleichen Quellen.

Fügen Sie das Präfix https:// auf jeder URL ein, oder verwenden Sie das Formular git@host:path für SSH. Wenn Sie ein bloßes gitlab.example.com/your-group/your-marketplace.git eingeben, liest Claude Code es als GitHub owner/repo-Kurzform und lehnt es ab.

Wenn der Befehl erfolgreich ist, druckt er Successfully added marketplace: <name>, und die Plugins des Marketplace erscheinen auf der Registerkarte Discover, wenn Sie /plugin das nächste Mal öffnen, ohne dass ein Neuladen erforderlich ist. Wenn es fehlschlägt, stimmen Sie die Fehlermeldung in Plugins fehlerbeheben ab.

Marketplace hinzufügen und in einem Befehl installieren

Um ein Plugin aus einem Marketplace zu installieren, den Sie noch nicht hinzugefügt haben, führen Sie /plugin install in einer Claude Code-Sitzung aus und benennen Sie die Marketplace-Quelle mit --marketplace. Erfordert Claude Code v2.1.275 oder später.

/plugin install deploy-helper --marketplace your-org/plugins

Die Quelle nimmt die gleichen Formen wie /plugin marketplace add an, wie GitHub owner/repo, eine Git-URL oder einen lokalen Pfad, außer dass sie keine Leerzeichen enthalten kann. Geben Sie den Plugin-Namen allein an, ohne ein @marketplace-Suffix.

Wenn Sie diesen Marketplace noch nicht hinzugefügt haben, zeigt Claude Code die aufgelöste Quelle an und fragt Sie, bevor Sie sie hinzufügen. Sobald der Marketplace hinzugefügt ist, öffnen sich die Details des Plugins und Sie wählen einen Installationsbereich. Wenn die Quelle einem Marketplace entspricht, den Sie bereits hinzugefügt haben, überspringt Claude Code die Bestätigung und öffnet die Details des Plugins in diesem Marketplace.

Privaten Marketplace hinzufügen

Ein privater Marketplace ist einer in einem Repository, auf das Sie Anmeldedaten zum Klonen benötigen, auf GitHub oder einem anderen Git-Host. Sie fügen ihn mit dem gleichen /plugin marketplace add- oder claude plugin marketplace add-Befehl wie einen öffentlichen hinzu. Claude Code klont ihn mit den Git-Anmeldedaten, die bereits auf Ihrem Computer vorhanden sind, und fragt nie, daher hat jede Verbindungsweise eine Anforderung:

• HTTPS: Ihre Git-Credential-Helper gelten, daher funktioniert der Zugriff, den Sie mit gh auth login, dem macOS-Schlüsselbund oder git-credential-store einrichten. Interaktive Aufforderungen werden unterdrückt, daher schlägt ein Host, bei dem Sie sich noch nie authentifiziert haben, statt zu fragen, fehl.
• SSH: Der Host muss bereits in Ihrer known_hosts-Datei sein und der Schlüssel muss ohne Passphrase-Aufforderung funktionieren, da die Host-Fingerprint- und Passphrase-Aufforderungen auch unterdrückt werden.
• GitHub owner/repo-Kurzform: Claude Code prüft, ob Ihr SSH-Schlüssel sich bei github.com authentifiziert, klont dann über SSH, wenn ja, und über HTTPS, wenn nein. Setzen Sie CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1, um diese Prüfung zu überspringen und immer über HTTPS zu klonen.

Die gleichen Anmeldedaten gelten, wenn Sie /plugin install, /plugin marketplace update und claude plugin update ausführen.

Auf einem GitHub Enterprise Server-Host siehe Plugin-Marketplaces auf GHES für die Anmeldedaten, die jede Operation benötigt.

Wenn Ihre Organisation den Marketplace für Sie über verwaltete Einstellungen registriert, fügen Sie ihn nicht selbst hinzu. Siehe Plugins vorinstallieren und erforderlich machen.

Marketplace von claude.ai hinzufügen

In Terminal-Sitzungen, in denen Plugins von Ihrem claude.ai-Konto synchronisiert werden, kann claude.ai auch Plugin-Marketplaces für Sie auflisten, wie die Plugin-Bibliothek Ihrer Organisation und Ihre eigenen claude.ai-Uploads. Sie fügen einen davon nach seinem Namen hinzu, anstatt nach einer Quelle. Das Hinzufügen eines Marketplace von claude.ai erfordert Claude Code v2.1.273 oder später.

Fügen Sie einen claude.ai-Marketplace vom /plugin-Panel oder von Ihrer Shell aus hinzu:

• Inside a session: Führen Sie /plugin aus und gehen Sie zur Registerkarte Marketplaces, die die Marketplaces von claude.ai auflistet. Wählen Sie einen dort aus, um ihn hinzuzufügen.
• From your shell: Führen Sie claude plugin marketplace list aus, das sie in einem Abschnitt From claude.ai: druckt. Führen Sie dann claude plugin marketplace add mit dem Flag --claudeai und dem in der Liste angezeigten Namen aus.

Zum Beispiel fügt dieser Befehl einen Marketplace namens claudeai-organization-library hinzu:

claude plugin marketplace add --claudeai claudeai-organization-library

Claude Code registriert den Marketplace unter einem lokalen Namen, der mit claudeai- beginnt, abgeleitet vom Namen, unter dem claude.ai ihn auflistet. Zum Beispiel wird ein Marketplace, der als "Organization library" aufgelistet ist, zu claudeai-organization-library. Installieren Sie seine Plugins unter diesem Namen, zum Beispiel mit claude plugin install <plugin>@claudeai-organization-library.

Wenn Sie sich abmelden oder sich bei einer anderen claude.ai-Organisation anmelden, bleibt der Marketplace konfiguriert, zeigt aber keine Plugins an, und die Plugins, die Sie bereits von ihm installiert haben, werden weiterhin geladen.

Der Abschnitt From claude.ai: kann auch Git-basierte Marketplaces auflisten, die über claude.ai geteilt werden, und druckt eine Quelle für jeden davon. Fügen Sie sie nach dieser Quelle wie in Marketplace hinzufügen hinzu, nicht mit --claudeai.

Installierte Plugins verwalten

Die Registerkarte Installed in /plugin listet Ihre Plugins mit Aktionen auf, um jedes zu aktivieren, zu deaktivieren, zu aktualisieren oder zu deinstallieren. Führen Sie in einer Claude Code-Sitzung /plugin aus und drücken Sie Tab, um es zu erreichen, oder führen Sie /plugin enable, /plugin disable oder /plugin uninstall aus, um das Panel zu öffnen und diese Änderung dort vorzunehmen. Deaktivierte Plugins werden unter einer eingeklappten Kopfzeile am unteren Ende der Liste gruppiert. Verwenden Sie diese Tasten auf der Liste:

• Geben Sie ein, um nach Name oder Beschreibung zu filtern.
• Drücken Sie Space, um das ausgewählte Plugin zu aktivieren oder zu deaktivieren, und f, um es zu favorisieren.
• Drücken Sie Enter, um die Details eines Plugins zu öffnen. Das Menü dort bietet Disable plugin oder Enable plugin, Update now und Uninstall. Plugins, die Einstellungen vornehmen, bieten auch Configure options.

Die Registerkarte kann auch Plugins im Bereich Managed anzeigen. Ihre Organisation hat diese über verwaltete Einstellungen installiert, und Sie können sie hier nicht aktivieren, deaktivieren oder deinstallieren.

Für ein synchronisiertes Plugin, das Ihre Organisation auf claude.ai erforderlich macht, siehe Plugins verwalten, die von claude.ai synchronisiert werden.

Wenn Sie das /plugin-Panel mit ausstehenden Änderungen schließen, die Sie darin vorgenommen haben, führt Claude Code /reload-plugins für Sie aus, um sie anzuwenden. Wenn das Neuladen den Prompt-Cache ungültig machen würde, warnt es und lässt die Änderungen stattdessen ausstehend. Führen Sie /reload-plugins --force aus, um sie trotzdem anzuwenden.

Plugins verwalten, die von claude.ai synchronisiert werden

Die Registerkarte Installed in /plugin listet auch die Plugins, die von Ihrem claude.ai-Konto synchronisiert werden, mit synced als ihrer Quelle. Synchronisierte Plugins erscheinen in Terminal-Sitzungen auf Claude Code v2.1.273 oder später.

• Enable or disable: Verwenden Sie die Registerkarte Installed, es sei denn, Ihre Organisation hat das Plugin als erforderlich markiert.
• Remove: Schalten Sie das Plugin auf claude.ai aus.

Wenn Claude Code ein hinzugefügtes, aktualisiertes oder entferntes Plugin in eine interaktive Sitzung synchronisiert, sehen Sie Plugins changed. Run /reload-plugins to activate. Führen Sie /reload-plugins aus, um die Änderung in dieser Sitzung zu laden, oder lassen Sie sie für das nächste Mal, wenn Sie Claude Code starten.

Deinstallieren Sie ein Plugin, das das Projekt aktiviert

Wenn Sie Uninstall für ein Plugin wählen, das die .claude/settings.json dieses Repositorys aktiviert, ob von der Registerkarte Installed oder mit /plugin uninstall, fragt Claude Code, ob es für Sie deaktiviert oder für alle deinstalliert werden soll:

• Disable for me: Drücken Sie y. Claude Code schreibt false für das Plugin in Ihre .claude/settings.local.json und lässt es für das Projekt installiert.
• Uninstall for everyone: Drücken Sie u. Claude Code entfernt das Plugin aus der gemeinsamen .claude/settings.json.

Sehen Sie, was ein installiertes Plugin zu Ihren Sitzungen hinzufügt

Führen Sie in Ihrer Shell claude plugin details <name> für ein installiertes Plugin aus. Die Zeile Always-on ist die Anzahl der Token, die das Plugin zu jeder Sitzung hinzufügt, in der es aktiviert ist, und die Pro-Komponenten-Zeilen zeigen, welche Skill oder welcher Agent am meisten beiträgt. Für die vollständige Ausgabe und was jede Zahl bedeutet, siehe Messen Sie, was ein Plugin kostet.

Finden Sie Plugins, die Sie nicht mehr verwenden

Auf der Registerkarte Installed in /plugin erscheinen Plugins, die Sie selbst installiert haben und kürzlich nicht verwendet haben, unter einer Kopfzeile Not used recently, und die Details jedes Plugins zeigen eine Zeile Last used. Verwenden Sie diese Kopfzeile und diese Zeile, um Plugins zu finden, die immer noch Startup- und Kontextkosten hinzufügen, und deaktivieren oder deinstallieren Sie sie dann.

Plugins mit Abhängigkeiten

Ein Plugin kann andere Plugins deklarieren, von denen es abhängt. Wenn Sie ein solches Plugin aus einem Marketplace installieren, deaktivieren oder deinstallieren, handelt Claude Code auch mit diesen Abhängigkeiten:

• Install: Claude Code installiert und aktiviert auch die deklarierten Abhängigkeiten des Plugins im gleichen Bereich. Die Erfolgsmeldung listet sie auf.
• Enable: Claude Code aktiviert auch die Abhängigkeiten des Plugins, die installiert, aber deaktiviert sind. Wenn eine deklarierte Abhängigkeit nicht installiert ist, schlägt die Aktivierung fehl und die Nachricht sagt Ihnen, sie zuerst zu installieren.
• Disable: Wenn ein anderes aktiviertes Plugin das benötigte noch braucht, weigert sich Claude Code und druckt einen verketteten Befehl, der beide in der richtigen Reihenfolge deaktiviert.
• Uninstall: Auto-installierte Abhängigkeiten bleiben, bis Sie claude plugin prune in Ihrer Shell ausführen; siehe plugin prune.

Wenn Sie das Plugin stattdessen mit --plugin-dir geladen haben, siehe Testen Sie ein Plugin und seine Abhängigkeit lokal.

Plugins von Ihrer Shell verwalten

Sie können Plugins auch verwalten, ohne eine Claude Code-Sitzung zu starten. Führen Sie in Ihrer Shell claude plugin install, enable, disable oder uninstall als gewöhnliche Terminal-Befehle aus; sie ändern die gleichen Einstellungen, die das /plugin-Panel tut. Jeder nimmt --scope, um einen Bereich anzuvisieren, und verwendet einen Standardbereich, wenn Sie ihn weglassen:

• enable und disable handeln mit dem spezifischsten Bereich, dessen Einstellungen das Plugin bereits auflisten.
• install und uninstall handeln mit dem Benutzerbereich.

Zum Beispiel deaktivieren und reaktivieren diese Befehle ein Plugin, dann deinstallieren es im Projektbereich:

claude plugin disable formatter@your-org
claude plugin enable formatter@your-org
claude plugin uninstall formatter@your-org --scope project

Halten Sie Plugins aktualisiert

Plugins werden automatisch aktualisiert, wenn der Marketplace, aus dem sie stammen, Auto-Update aktiviert hat. Nachdem eine Sitzung startet, aktualisiert Claude Code diese Marketplaces und aktualisiert die On-Disk-Kopien der Plugins, die Sie von ihnen installiert haben.

Die laufende Sitzung behält die Versionen, die sie bereits geladen hat. Nach einer Aktualisierung sehen Sie Plugin updated: <name> · Run /reload-plugins to apply, und die nächste Sitzung lädt die neuen Versionen automatisch.

Dies sind die Auto-Update-Standardeinstellungen für jede Art von Marketplace:

• On by default: claude-plugins-official und die anderen offiziellen Marketplace-Namen außer knowledge-work-plugins und first-party-plugins, plus Marketplaces, die von claude.ai hinzugefügt werden.
• Off by default: jeder andere Marketplace, einschließlich des Community-Marketplace, Drittanbieter-Marketplaces und lokaler Entwicklungs-Marketplaces.

Für wann Auto-Update läuft, welche Plugins es überspringt, und die Umgebungsvariablen, die es ausschalten, siehe Wenn Auto-Update läuft.

Schalten Sie Auto-Update für einen Marketplace ein oder aus

Führen Sie in einer Claude Code-Sitzung /plugin aus und gehen Sie zur Registerkarte Marketplaces. Wählen Sie den Marketplace aus, dann wählen Sie Enable auto-update oder Disable auto-update.

Aktualisieren Sie ein Plugin jetzt

Öffnen Sie in einer Sitzung das Plugin auf der Registerkarte Installed in /plugin und wählen Sie Update now, oder führen Sie in Ihrer Shell claude plugin update <plugin>@<marketplace> aus.

Auto-Update von einem privaten Marketplace

Für einen privaten Marketplace siehe Was Background-Auto-Update mit Anmeldedaten tut für wie Background-Auto-Updates sich über SSH und HTTPS authentifizieren, und Plugins fehlerbeheben für die Nachrichten, die Sie sehen, wenn sie fehlschlagen.

Marketplaces verwalten

Die Registerkarte Marketplaces in /plugin listet jeden Marketplace auf, den Sie registriert haben, zusammen mit seiner Quelle. Wählen Sie einen aus, um seine Plugins zu durchsuchen, seine Auflistung zu aktualisieren, Auto-Update ein- oder auszuschalten, oder ihn zu entfernen.

Sie können Marketplaces auch mit Befehlen auflisten, aktualisieren und entfernen, von Ihrer Shell oder innerhalb einer Sitzung:

Wenn Sie einen Marketplace entfernen, deinstalliert Claude Code jedes Plugin, das Sie von ihm installiert haben, und entfernt ihre enabledPlugins-Einträge aus Ihren Einstellungsdateien. Die Registerkarte Marketplaces benennt diese Plugins, bevor sie Sie zur Bestätigung auffordert.

Nächste Schritte

• Anthropics Marketplaces: wie sich der offizielle, Community- und Demo-Marketplace unterscheiden und wo Sie jeden durchsuchen können
• Plugin-Lade-Referenz: warum ein Plugin geladen wurde, nicht geladen wurde, oder sich nach einer Aktualisierung nicht änderte
• Plugin-Sicherheit und Vertrauen: was Sie überprüfen sollten, bevor Sie ein Plugin aus einem Marketplace installieren, den Sie nicht kennen
• Plugins fehlerbeheben: Installations- und Marketplace-Fehlermeldungen mit ihren Fixes
• Erstellen Sie ein Plugin: bauen Sie Ihr eigenes