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

> A Claude Code 2.1.285 bevezette a claude plugin configure parancsot. Hogyan ellenőrizhetők a pluginbeállítások a dokumentációban, és hogyan módosítható egy token vagy cím újratelepítés nélkül.

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


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="A szakasz fő üzenete">

Fő üzenet

A Claude Code 2.1.285 bevezette a `claude plugin configure <plugin>` terminálparancsot. Kapcsolók nélkül megjeleníti, hogy mely pluginbeállítások vannak megadva, és melyek nincsenek, anélkül, hogy kiírná az értékeiket. A `--values-stdin` kapcsolóval új értékeket ment egy bemenetként megadott JSON-fájlból, a plugin újratelepítése nélkül. A szokásos értékek a `settings.json` fájlban, a `pluginConfigs` alatt tárolódnak, míg a `sensitive: true` jelölésű mezők értékei a rendszer biztonságos hitelesítőadat-tárolójába kerülnek.

</div>

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

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

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

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

```bash
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](https://ailoot.ai/blog/hu/skills-subagents-mcp-plugins-claude-code/) 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](https://ailoot.ai/blog/hu/telegram-ai-agent-plugins/) eltér a Claude Code-ban történő telepítéstől.

<div class="section" role="doc-bibliography" aria-label="Források">

### Források

- [Claude Code CHANGELOG, 2.1.285-ös bejegyzés](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code: pluginparancsok referenciája](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code: pluginmanifest-referencia, felhasználói konfiguráció](https://code.claude.com/docs/en/plugins-reference.md)

</div>





Ismerje meg az [Ailootot](https://ailoot.ai/).

## Kérdések és válaszok: Claude Code: Telepített plugin újrakonfigurálása újratelepítés nélkül (2.1.285)

### Miért állítja a configure, hogy nem találja a telepített pluginomat?

A claude plugin list kimenetéből használd a teljes name@marketplace azonosítót, és ellenőrizd, hogy a plugin a megfelelő hatókörbe van telepítve. Ez a parancs önmagában a rövid pluginnevet nem fogadja el.

### Hogyan ellenőrizzek egy módosított tokent az érték kiírása nélkül?

Futtasd a claude plugin configure parancsot a plugin teljes azonosítójával, és ellenőrizd, hogy az érzékeny mező beállítottnak van-e jelölve. Mentés után indítsd újra a Claude Code-ot; a tokent tartalmazó JSON-bemeneti fájlt ne commitold.


## Ailoot · A vállalat és projektportfóliója

Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít.

A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben.

Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.