Claude Code Plugin konfigurieren: claude plugin configure

Diese Anleitung richtet sich an Nutzer, die bereits ein Claude-Code-Plugin installiert haben, das userConfig-Einstellungen wie eine Adresse, ein Token oder einen Ordnerpfad definiert. Sie müssen einen falsch eingegebenen Wert korrigieren oder ein Token ersetzen, ohne das Plugin neu zu installieren. Alle folgenden Angaben basieren auf der offiziellen Claude-Code-Dokumentation und dem Changelog. Der Artikel enthält keinen eigenen Testlauf.

Informationen zur Verwendung von Ailoot finden Sie in der Dokumentation.

Welche Claude-Code-Version benötigt claude plugin configure?#

Der Changelog-Eintrag von Claude Code für Version 2.1.285 (ein Commit vom 29. September 2026) enthält mehrere Zeilen zu Plugins. Zwei davon sind für diesen Artikel relevant:

claude plugin configure <plugin> hinzugefügt, um die Optionen eines Plugins und diejenigen anzuzeigen, die nicht gesetzt sind, oder mit --values-stdin neue Werte zu speichern, die von stdin gelesen werden

Das bedeutet, dass der neue Befehl claude plugin configure <plugin> die Einstellungen eines Plugins und diejenigen anzeigt, die nicht gesetzt sind, oder bei Verwendung mit --values-stdin neue Werte speichert, die von der Standardeingabe gelesen werden.

<server>.<key>=<value> zu claude plugin install --config hinzugefügt, damit die eigenen Einstellungen eines gebündelten .mcpb-MCP-Servers während der Installation gesetzt werden können und er startet, ohne /plugin → Configure aufzurufen

Das bedeutet, dass claude plugin install --config nun das Format <server>.<key>=<value> unterstützt. Damit können die Einstellungen eines MCP-Servers, der mit einem Plugin in einer .mcpb-Datei gebündelt ist, bei der Installation angegeben werden, sodass der Server startet, ohne /plugin → Configure aufzurufen.

Die Befehlsreferenz bestätigt die Versionsanforderung: claude plugin configure erfordert Claude Code v2.1.285 oder höher. In früheren Versionen gibt es den Befehl nicht.

Unterschiede zu /plugin configure#

Der Befehl /plugin configure <plugin> (mit dem Alias config) war bereits in einer interaktiven Claude-Code-Sitzung verfügbar. Er öffnet einen Dialog für userConfig-Einstellungen und erfordert v2.1.147 oder höher. /plugin funktioniert jedoch nur in einer interaktiven Sitzung: Bei einem nicht interaktiven Aufruf wie claude -p meldet Claude Code, dass /plugin in dieser Umgebung nicht verfügbar ist.

Laut Dokumentation werden claude plugin-Befehle in einer Shell oder einem Skript außerhalb einer Claude-Code-Sitzung ausgeführt. Dadurch können Sie claude plugin configure auch ohne Dialog ausführen. Die Dokumentation beschreibt nicht, wie sich dieser Befehl ohne interaktives Terminal verhält oder wo er geheime Werte auf einem Server ohne grafische Umgebung speichert. Prüfen Sie dies in Ihrer eigenen Umgebung, bevor Sie ihn in CI verwenden.

Schritt 1. Prüfen, welche Einstellungen gesetzt sind#

Laut Dokumentation ist die vollständige Plugin-Kennung im Format name@marketplace erforderlich, wie sie von claude plugin list angezeigt wird. Der Befehl configure akzeptiert keinen Namen ohne @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

Ersetzen Sie formatter@my-marketplace durch die Kennung Ihres Plugins. Ohne Flags listet der Befehl jede Einstellung mit Labels auf: required oder optional, bei einem geheimen Feld anschließend sensitive, gefolgt von set oder not set. Die gespeicherten Werte werden nicht ausgegeben.

Wenn Sie eine maschinenlesbare Ausgabe benötigen, fügen Sie --json hinzu. Die Ausgabe enthält dann gespeicherte Werte für normale Felder, aber der Inhalt eines geheimen Feldes wird niemals ausgegeben.

Schritt 2. Einen Wert mithilfe einer Datei ändern#

Die Werte werden als JSON-Objekt übergeben, in dem jeder Schlüssel der Name einer Einstellung aus dem Manifest und jeder Wert eine Zeichenfolge ohne Zeilenumbrüche ist. Die Dokumentation zeigt eine dateibasierte Methode: Schreiben Sie das Objekt in values.json und übergeben Sie die Datei über die Standardeingabe an den Befehl. Hier ist api_url der Schlüssel aus dem Dokumentationsbeispiel. Verwenden Sie für Ihr eigenes Plugin den Namen der benötigten Einstellung aus dessen Manifest oder aus der Ausgabe in Schritt 1.

{"api_url": "NEW_ADDRESS"}

claude plugin configure formatter@my-marketplace --values-stdin < values.json

Beim Speichern gelten folgende Regeln:

• Einstellungen, die im JSON ausgelassen werden, behalten ihre bisherigen Werte. Sie können nur das Feld angeben, das Sie ändern.
• Die Beschreibung des Flags bezieht sich allgemein auf das Setzen von Werten und nennt keine gesonderte Regel für geheime Felder. Prüfen Sie nach dem Speichern mit Schritt 1, ob das betreffende Feld als set markiert ist.
• Claude Code prüft jeden Wert anhand des deklarierten Typs und gibt Configuration saved. Restart Claude Code to apply it. aus. Das bedeutet, dass die Einstellung gespeichert wurde und nach einem Neustart von Claude Code wirksam wird.
• Wenn das JSON einen Schlüssel enthält, der nicht im Manifest deklariert ist, oder ein Wert die Validierung nicht besteht, speichert der Befehl nichts, gibt Failed to save configuration: gefolgt vom Grund aus und wird mit Code 1 beendet.

Wenn Sie ein Token in values.json schreiben, beachten Sie, dass es sich dabei um eine normale Datei auf dem Datenträger handelt. Löschen Sie sie nach dem Speichern der Konfiguration und fügen Sie eine solche Datei nicht zum Repository hinzu.

Wo der Wert gespeichert wird#

Laut der Dokumentation zum Plugin-Manifest werden normale Werte unter pluginConfigs in der settings.json des Nutzers gespeichert. Werte für Felder mit sensitive: true werden stattdessen im sicheren Anmeldedatenspeicher des Systems und nicht in settings.json gespeichert; die Eingabe für diese Felder wird maskiert.

Es bringt nichts, den Wert eines geheimen Felds in settings.json zu suchen. claude plugin configure zeigt dessen Status mit den Labels sensitive und set oder not set an.

install --config: Einen Wert bei der Installation setzen#

Für eine Neuinstallation bietet claude plugin install das Flag --config <key=value>. Damit wird eine im Manifest deklarierte userConfig-Einstellung gesetzt; erforderlich ist v2.1.147 oder höher. Wiederholen Sie das Flag für jede Einstellung. Ab Version 2.1.285 setzt ein Schlüssel im Format <server>.<key> eine Einstellung eines gebündelten MCP-Servers, die in dessen eigener user_config deklariert ist.

Ersetzen Sie im folgenden Beispiel formatter@my-marketplace durch die Kennung Ihres Plugins, api_url durch den Einstellungsnamen aus dessen Manifest und den gesamten Platzhalter NEW_ADDRESS durch Ihren eigenen Wert. Lassen Sie die Anführungszeichen um das Argument stehen.

claude plugin install formatter@my-marketplace --config 'api_url=NEW_ADDRESS'

Welchen Befehl Sie verwenden, hängt davon ab, ob das Plugin bereits installiert ist: install --config setzt Werte bei der Erstinstallation, während plugin configure --values-stdin Werte für ein bereits installiertes Plugin ändert.

Für Einstellungen eines gebündelten MCP-Servers nennt die Dokumentation andere Methoden: plugin install --config oder Configure in /plugin. Für diese Einstellungen empfiehlt sie nicht den Befehl plugin configure.

Wenn der Befehl das Plugin nicht finden kann#

Wenn claude plugin configure ein geladenes Plugin mit dieser Kennung nicht finden kann, gibt er No installed plugin has the id "<plugin>". aus und wird mit Code 1 beendet. Prüfen Sie zunächst, ob Sie die vollständige Kennung im Format name@marketplace aus claude plugin list angegeben haben. Der Plugin-Name allein reicht nicht aus.

Der Befehl innerhalb der Sitzung hat eine eigene Meldung. Wenn Sie bei Verwendung von /plugin enable, disable, uninstall oder configure ein Plugin angeben, das im aktuellen Projekt nicht installiert ist, gibt Claude Code Plugin "<plugin>" is not installed in this project aus und führt nichts aus.

Fazit#

Um ein Token oder eine Adresse für ein bereits installiertes Plugin in Claude Code 2.1.285 oder höher zu ändern, ermitteln Sie die Kennung mit claude plugin list, prüfen Sie den Status der Einstellungen mit claude plugin configure, übergeben Sie den neuen Wert mit --values-stdin aus einer Datei und starten Sie Claude Code neu. Werte geheimer Felder werden nicht in settings.json gespeichert; prüfen Sie ihren Status daher mit demselben Befehl.

Die Anleitung zu Skills, Subagents, MCP und Plugins in Claude Code kann Ihnen bei der Auswahl zwischen Erweiterungstypen helfen. Wenn Sie noch kein Plugin ausgewählt haben, können Sie mit den Top 10 Claude-Code-Plugins beginnen. Für einen Telegram-Bot gibt es eine separate Anleitung: Ein Plugin in einem Telegram-Agenten installieren funktioniert anders als die Installation in Claude Code.

Lernen Sie Ailoot kennen.