Claude Code: Telepített plugin újrakonfigurálása újratelepítés nélkül (2.1.285)

Ez az útmutató azoknak szól, akik már telepítettek egy userConfig beállításokat deklaráló Claude Code plugint, például egy címet, tokent vagy mappaútvonalat. Ki kell javítaniuk egy hibásan megadott értéket, vagy újratelepítés nélkül kell lecserélniük egy tokent. Az alábbiak a Claude Code hivatalos dokumentációján és változásnaplóján alapulnak. A cikk nem tartalmaz saját tesztfuttatást.

Az Ailoot használatáról a dokumentációban talál információt.

Mit adott hozzá a 2.1.285-ös verzió#

A Claude Code 2.1.285-ös verziójához tartozó változásnapló-bejegyzés (egy 2026. szeptember 29-i dátumú commit) több sort is tartalmaz a pluginekről. Ezek közül kettő kapcsolódik ehhez a cikkhez:

Added claude plugin configure <plugin> to show a plugin's options and which are unset, or save new values read from stdin with --values-stdin

Ez azt jelenti, hogy az új claude plugin configure <plugin> parancs megjeleníti a plugin beállításait és azt, hogy melyek nincsenek megadva, illetve --values-stdin kapcsolóval új, standard bemenetről beolvasott értékeket ment.

Added <server>.<key>=<value> to claude plugin install --config, so a bundled .mcpb MCP server's own settings can be set at install time and it starts without visiting /plugin → Configure

Ez azt jelenti, hogy a claude plugin install --config mostantól támogatja a <server>.<key>=<value> formát, így a pluginba egy .mcpb fájlban beágyazott MCP-kiszolgáló beállításai már telepítéskor megadhatók, és a kiszolgáló a /plugin → Configure megnyitása nélkül is elindul.

A parancsreferencia megerősíti a verziókövetelményt: a claude plugin configure használatához Claude Code v2.1.285 vagy újabb szükséges. Korábbi verziókban ez a parancs nem létezik.

Miben különbözik a /plugin configure parancstól#

A /plugin configure <plugin> parancs (a config aliasával) már korábban is elérhető volt egy interaktív Claude Code-munkameneten belül. Párbeszédablakot nyit a userConfig beállításokhoz, és v2.1.147 vagy újabb verziót igényel. A /plugin azonban csak interaktív munkamenetben működik: nem interaktív meghíváskor, például claude -p esetén, a Claude Code azt jelzi, hogy a /plugin ebben a környezetben nem érhető el.

A dokumentáció szerint a claude plugin parancsokat shellből vagy szkriptből, egy Claude Code-munkameneten kívül kell futtatni. Így a claude plugin configure párbeszédablak megnyitása nélkül is futtatható. A dokumentáció nem írja le, hogyan viselkedik ez a parancs interaktív terminál nélkül, vagy hol tárolja a titkos értékeket grafikus környezet nélküli kiszolgálón. CI-beli használat előtt ellenőrizze ezt a saját környezetében.

1. lépés: Nézze meg, mely beállítások vannak megadva#

A dokumentáció a teljes pluginazonosítót írja elő name@marketplace formában, ahogyan az a claude plugin list kimenetében látható. A configure parancs nem fogad el olyan nevet, amelyből hiányzik az @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

Cserélje le a formatter@my-marketplace értéket a pluginja azonosítójára. Kapcsolók nélkül a parancs minden beállítást felsorol a következő címkékkel: required vagy optional, titkos mező esetén ezt követi a sensitive, majd a set vagy not set. A tárolt értékeket nem írja ki.

Ha géppel feldolgozható kimenetre van szüksége, adja hozzá a --json kapcsolót. A kimenet ekkor tartalmazza a szokásos mezők tárolt értékeit, a titkos mezők tartalma azonban soha nem jelenik meg.

2. lépés: Módosítson egy értéket fájl használatával#

Az értékeket JSON-objektumként kell megadni: minden kulcs a manifestben szereplő beállítás neve, minden érték pedig sortörés nélküli karakterlánc. A dokumentáció fájlalapú módszert mutat: írja az objektumot a values.json fájlba, majd adja át a fájlt a parancs standard bemeneteként. Itt az api_url a dokumentációs példában használt kulcs. Saját pluginja esetén a manifestből vagy az 1. lépés kimenetéből vegye a szükséges beállítás nevét.

{"api_url": "NEW_ADDRESS"}

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

Mentéskor a következő szabályok érvényesek:

• A JSON-ból kihagyott beállítások megtartják korábbi értéküket. Csak a módosítandó mezőt is megadhatja.
• A kapcsoló leírása általánosságban hivatkozik az értékek beállítására, és nem említ külön szabályt a titkos mezőkre. Mentés után az 1. lépéssel ellenőrizze, hogy az érintett mező set jelölést kapott-e.
• A Claude Code a deklarált típus alapján ellenőrzi az egyes értékeket, majd kiírja: Configuration saved. Restart Claude Code to apply it. Ez azt jelenti, hogy a beállítás mentése megtörtént, és a Claude Code újraindítása után lép érvénybe.
• Ha a JSON a manifestben nem deklarált kulcsot tartalmaz, vagy egy érték nem felel meg az ellenőrzésnek, a parancs semmit sem ment, kiírja a Failed to save configuration: szöveget, majd az okot, és 1-es kóddal lép ki.

Ha tokent ír a values.json fájlba, ne feledje, hogy az egy hagyományos lemezen tárolt fájl. A konfiguráció mentése után törölje, és ne vegye fel a tárolóba.

Hol tárolódik az érték#

A pluginmanifest dokumentációja szerint a szokásos értékek a felhasználó settings.json fájljában, a pluginConfigs alatt tárolódnak. A sensitive: true jelölésű mezők értékei a rendszer biztonságos hitelesítőadat-tárolójába kerülnek a settings.json helyett; ezeknek a mezőknek a bemenete maszkolva van.

Nincs értelme egy titkos mező értékét a settings.json fájlban keresni. A claude plugin configure a mező állapotát a sensitive és a set vagy not set címkével jeleníti meg.

install --config: érték beállítása telepítéskor#

Új telepítésnél a claude plugin install biztosítja a --config <key=value> kapcsolót. Ez a manifestben deklarált userConfig beállításokat állítja be, és v2.1.147 vagy újabb verziót igényel. Minden beállításhoz ismételje meg a kapcsolót. A 2.1.285-ös verziótól kezdve a <server>.<key> formájú kulcs egy beágyazott MCP-kiszolgáló saját user_config beállítását állítja be.

Az alábbi példában cserélje le a formatter@my-marketplace értéket a pluginja azonosítójára, az api_url értéket a manifestben szereplő beállítás nevére, a teljes NEW_ADDRESS helyőrzőt pedig a saját értékére. Az argumentum körüli idézőjeleket hagyja meg.

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

A használandó parancs attól függ, hogy a plugin telepítve van-e: az install --config az első telepítéskor állítja be az értékeket, a plugin configure --values-stdin pedig egy már telepített plugin értékeit módosítja.

A beágyazott MCP-kiszolgálóhoz tartozó beállításoknál a dokumentáció más módszereket sorol fel: plugin install --config vagy a /plugin alatti Configure. Ezekhez a beállításokhoz nem javasolja a plugin configure parancsot.

Ha a parancs nem találja a plugint#

Ha a claude plugin configure nem talál betöltött plugint az adott azonosítóval, kiírja a No installed plugin has the id "<plugin>". szöveget, majd 1-es kóddal lép ki. Először ellenőrizze, hogy a claude plugin list kimenetéből származó teljes name@marketplace azonosítót adta-e meg. A plugin neve önmagában nem elég.

A munkameneten belüli parancs saját üzenetet használ. Ha olyan plugint nevez meg, amely nincs telepítve az aktuális projektben, miközben a /plugin enable, disable, uninstall vagy configure parancsot használja, a Claude Code ezt írja ki: Plugin "<plugin>" is not installed in this project, és nem hajt végre semmit.

Összegzés#

Ha egy már telepített plugin tokenjét vagy címét szeretné módosítani a Claude Code 2.1.285-ös vagy újabb verziójában, keresse meg az azonosítóját a claude plugin list paranccsal, ellenőrizze a beállítások állapotát a claude plugin configure paranccsal, adja meg az új értéket fájlból a --values-stdin kapcsolóval, majd indítsa újra a Claude Code-ot. A titkos mezők értékei nem tárolódnak a settings.json fájlban, ezért az állapotukat ugyanezzel a paranccsal ellenőrizze.

A Skills, Subagents, MCP és Plugins a Claude Code-ban című útmutató segíthet a bővítménytípus kiválasztásában. Ha még nem választott plugint, kezdheti a 10 legjobb Claude Code pluginnal. A Telegram-bothoz külön útmutató tartozik: plugin telepítése egy Telegram-ügynökben eltér a Claude Code-ban történő telepítéstől.

Ismerje meg az Ailootot.