Claude Code: Ako znova nakonfigurovať nainštalovaný doplnok bez jeho opätovnej inštalácie (2.1.285)

Tento návod je určený používateľom, ktorí už majú nainštalovaný doplnok Claude Code deklarujúci nastavenia userConfig, napríklad adresu, token alebo cestu k priečinku. Potrebujete opraviť nesprávne zadanú hodnotu alebo vymeniť token bez opätovnej inštalácie doplnku. Všetky informácie nižšie vychádzajú z oficiálnej dokumentácie a zoznamu zmien Claude Code. Článok neobsahuje vlastné testovanie.

Informácie o používaní Ailoot nájdete v dokumentácii.

Čo priniesla verzia 2.1.285#

Záznam v zozname zmien Claude Code pre verziu 2.1.285 (commit z 29. septembra 2026) obsahuje niekoľko riadkov o doplnkoch. Dva z nich sa týkajú tohto článku:

Pridaný príkaz claude plugin configure <plugin> na zobrazenie možností doplnku a toho, ktoré nie sú nastavené, alebo na uloženie nových hodnôt načítaných zo štandardného vstupu pomocou prepínača --values-stdin

To znamená, že nový príkaz claude plugin configure <plugin> zobrazuje nastavenia doplnku a tie, ktoré nie sú nastavené, alebo pri použití s prepínačom --values-stdin ukladá nové hodnoty načítané zo štandardného vstupu.

Pridaná podpora formátu <server>.<key>=<value> pre claude plugin install --config, aby sa vlastné nastavenia servera MCP pribaleného v súbore .mcpb dali nastaviť pri inštalácii a server sa spustil bez návštevy /plugin → Configure

To znamená, že claude plugin install --config teraz podporuje formát <server>.<key>=<value>, takže nastavenia servera MCP pribaleného k doplnku v súbore .mcpb možno zadať počas inštalácie a server sa spustí bez návštevy /plugin → Configure.

Referenčná príručka príkazov potvrdzuje požiadavku na verziu: claude plugin configure vyžaduje Claude Code v2.1.285 alebo novšiu verziu. V starších verziách tento príkaz neexistuje.

Ako sa líši od príkazu /plugin configure#

Príkaz /plugin configure <plugin> (s aliasom config) bol dostupný už predtým v interaktívnej relácii Claude Code. Otvorí dialóg na nastavenie položiek userConfig a vyžaduje v2.1.147 alebo novšiu verziu. Príkaz /plugin však funguje iba v interaktívnej relácii: pri neinteraktívnom spustení, napríklad claude -p, Claude Code oznámi, že /plugin v tomto prostredí nie je dostupný.

Podľa dokumentácie sa príkazy claude plugin spúšťajú v shelli alebo skripte, mimo relácie Claude Code. Vďaka tomu možno spustiť aj claude plugin configure bez otvorenia dialógu. Dokumentácia neuvádza, ako sa tento príkaz správa bez interaktívneho terminálu ani kam ukladá tajné hodnoty na serveri bez grafického prostredia. Pred použitím v CI to overte vo svojom prostredí.

Krok 1. Zistite, ktoré nastavenia sú nastavené#

Dokumentácia vyžaduje úplný identifikátor doplnku vo formáte name@marketplace, ktorý zobrazuje príkaz claude plugin list. Príkaz configure neprijíma názov bez @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

Nahraďte formatter@my-marketplace identifikátorom svojho doplnku. Bez prepínačov príkaz vypíše každé nastavenie spolu s označeniami: required alebo optional, pri tajnom poli potom sensitive a nakoniec set alebo not set. Uložené hodnoty nevypisuje.

Ak potrebujete výstup čitateľný pre počítačové spracovanie, pridajte --json. Výstup potom bude obsahovať uložené hodnoty bežných polí, no obsah tajného poľa sa nikdy nevypíše.

Krok 2. Zmeňte hodnotu pomocou súboru#

Hodnoty sa zadávajú ako objekt JSON, v ktorom je každý kľúč názvom nastavenia z manifestu a každá hodnota je reťazec bez zalomenia riadka. Dokumentácia ukazuje postup so súborom: zapíšte objekt do súboru values.json a tento súbor presmerujte na štandardný vstup príkazu. V tomto príklade z dokumentácie sa používa kľúč api_url. Pre svoj doplnok použite názov nastavenia, ktoré potrebujete, z jeho manifestu alebo z výstupu v kroku 1.

{"api_url": "NEW_ADDRESS"}

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

Pri ukladaní platia tieto pravidlá:

• Nastavenia vynechané z JSON si zachovajú predchádzajúce hodnoty. Môžete zadať iba pole, ktoré meníte.
• Opis prepínača hovorí všeobecne o nastavovaní hodnôt a neuvádza osobitné pravidlo pre tajné polia. Po uložení pomocou kroku 1 skontrolujte, či je príslušné pole označené ako set.
• Claude Code overí každú hodnotu podľa deklarovaného typu a vypíše Configuration saved. Restart Claude Code to apply it. To znamená, že nastavenie sa uložilo a prejaví sa po reštarte Claude Code.
• Ak JSON obsahuje kľúč, ktorý nie je deklarovaný v manifeste, alebo hodnota neprejde validáciou, príkaz nič neuloží, vypíše Failed to save configuration: nasledované dôvodom a skončí s kódom 1.

Ak zapíšete token do súboru values.json, pamätajte, že ide o bežný súbor na disku. Po uložení konfigurácie ho odstráňte a nepridávajte ho do repozitára.

Kam sa hodnota ukladá#

Podľa dokumentácie k manifestu doplnku sa bežné hodnoty ukladajú pod položku pluginConfigs v používateľskom súbore settings.json. Hodnoty polí označených sensitive: true sa namiesto súboru settings.json ukladajú do zabezpečeného úložiska poverení systému; vstup pre tieto polia je maskovaný.

Hodnotu tajného poľa nemá zmysel hľadať v súbore settings.json. Príkaz claude plugin configure zobrazuje jeho stav pomocou označení sensitive a set alebo not set.

install --config: nastavenie hodnoty pri inštalácii#

Pri novej inštalácii poskytuje príkaz claude plugin install prepínač --config <key=value>. Nastavuje položku userConfig deklarovanú v manifeste a vyžaduje v2.1.147 alebo novšiu verziu. Pre každé nastavenie prepínač zopakujte. Od verzie 2.1.285 kľúč vo formáte <server>.<key> nastavuje položku servera MCP pribaleného k doplnku, ktorá je deklarovaná v jeho vlastnom user_config.

V nasledujúcom príklade nahraďte formatter@my-marketplace identifikátorom svojho doplnku, api_url názvom nastavenia z jeho manifestu a celý zástupný text NEW_ADDRESS vlastnou hodnotou. Úvodzovky okolo argumentu ponechajte.

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

Výber príkazu závisí od toho, či je doplnok nainštalovaný: install --config nastavuje hodnoty pri prvej inštalácii, zatiaľ čo plugin configure --values-stdin mení hodnoty už nainštalovaného doplnku.

Pri nastaveniach pribaleného servera MCP dokumentácia uvádza iné spôsoby: plugin install --config alebo Configure v /plugin. Pri týchto nastaveniach neodporúča príkaz plugin configure.

Ak príkaz nedokáže nájsť doplnok#

Ak claude plugin configure nedokáže nájsť načítaný doplnok s daným identifikátorom, vypíše No installed plugin has the id "<plugin>". a skončí s kódom 1. Najprv skontrolujte, či ste zadali úplný identifikátor name@marketplace z príkazu claude plugin list. Samotný názov doplnku nestačí.

Príkaz v relácii má vlastné hlásenie. Ak pomenujete doplnok, ktorý nie je nainštalovaný v aktuálnom projekte, keď používate /plugin enable, disable, uninstall alebo configure, Claude Code vypíše Plugin "<plugin>" is not installed in this project a nič neurobí.

Záver#

Ak chcete zmeniť token alebo adresu už nainštalovaného doplnku v Claude Code 2.1.285 alebo novšej verzii, zistite jeho identifikátor príkazom claude plugin list, skontrolujte stav nastavení príkazom claude plugin configure, zadajte novú hodnotu zo súboru pomocou --values-stdin a reštartujte Claude Code. Hodnoty tajných polí sa neukladajú do súboru settings.json, preto ich stav skontrolujte tým istým príkazom.

Sprievodca Skills, Subagents, MCP a Plugins v Claude Code vám môže pomôcť vybrať si medzi typmi rozšírení. Ak ste si ešte nevybrali doplnok, môžete začať s 10 najlepšími doplnkami Claude Code. Pre bota Telegram je určený samostatný návod: inštalácia doplnku v agentovi Telegram funguje inak ako inštalácia doplnku v Claude Code.

Spoznajte Ailoot.