# Claude Code Plugin konfigurieren: claude plugin configure

> Claude Code 2.1.285 führte den Befehl claude plugin configure ein. So prüfen Sie die Plugin-Einstellungen in der Dokumentation und ändern ein Token oder eine Adresse, ohne das Plugin neu zu installieren.

Source: https://ailoot.ai/blog/de/claude-code-plugin-configure-2-1-285/
Canonical: https://ailoot.ai/blog/de/claude-code-plugin-configure-2-1-285/
Language: de
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-050
Revision: sha256-0379dbfa7a5678cb8ad8166211abcbb262763551c4a2ec6db8e1ac5900c02a6a


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Das Wichtigste in diesem Abschnitt">

Das Wichtigste

Claude Code 2.1.285 führte den Terminalbefehl `claude plugin configure <plugin>` ein. Ohne Flags zeigt er an, welche Plugin-Einstellungen gesetzt und welche nicht gesetzt sind, ohne ihre Werte auszugeben. Mit `--values-stdin` speichert er neue Werte aus einer als Eingabe übergebenen JSON-Datei, ohne das Plugin neu zu installieren. Normale Werte werden in `settings.json` unter `pluginConfigs` gespeichert, während Werte für Felder mit `sensitive: true` im sicheren Anmeldedatenspeicher des Systems gespeichert werden.

</div>

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](https://ailoot.ai/docs/).



## 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`.

```bash
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.

```json
{"api_url": "NEW_ADDRESS"}
```

```bash
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.

```bash
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](https://ailoot.ai/blog/de/skills-subagents-mcp-plugins-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](https://ailoot.ai/blog/de/telegram-ai-agent-plugins/) funktioniert anders als die Installation in Claude Code.

<div class="section" role="doc-bibliography" aria-label="Quellen">

### Quellen

- [Claude-Code-CHANGELOG, Eintrag 2.1.285](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code: Referenz zu Plugin-Befehlen](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code: Referenz zum Plugin-Manifest, Benutzerkonfiguration](https://code.claude.com/docs/en/plugins-reference.md)

</div>





Lernen Sie [Ailoot](https://ailoot.ai/) kennen.

## Fragen und Antworten

### Warum findet configure mein installiertes Plugin nicht?

Verwende die vollständige Kennung name@marketplace aus `claude plugin list` und prüfe, ob das Plugin im passenden Geltungsbereich installiert ist. Der kurze Pluginname allein wird von diesem Befehl nicht akzeptiert.

### Wie prüfe ich ein geändertes Token, ohne es auszugeben?

Führe `claude plugin configure` mit der vollständigen Pluginkennung aus und kontrolliere, dass das vertrauliche Feld als gesetzt markiert ist. Starte Claude Code nach dem Speichern neu. Committe die JSON-Eingabedatei mit dem Token nicht.


## Ailoot · Das Unternehmen und sein Projektportfolio

Ailoot baut auf bewährte Betriebserfahrung, einen großen Kundenstamm, stabilen Service und kontinuierliche KPI-Kontrolle.

Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.

Ailoot nutzt diese Betriebserfahrung für den API-Zugang zu KI-Funktionen in Kundenprodukten, Agenten, Anwendungen und Automatisierungen.