Claude Code: Kako znova konfigurirati nameščeni vtičnik brez ponovne namestitve (2.1.285)

Ta vodnik je namenjen uporabnikom, ki že imajo nameščen vtičnik Claude Code z nastavitvami userConfig, kot so naslov, žeton ali pot do mape. Popraviti morate napačno vneseno vrednost ali zamenjati žeton, ne da bi vtičnik znova namestili. Vse spodnje informacije temeljijo na uradni dokumentaciji in dnevniku sprememb Claude Code. Članek ne vključuje lastnega testnega zagona.

Informacije o uporabi Ailoota so na voljo v dokumentaciji.

Kaj je bilo dodano v različici 2.1.285#

Vnos za različico 2.1.285 v dnevniku sprememb Claude Code (commit z datumom 29. september 2026) vsebuje več vrstic o vtičnikih. Za ta članek sta pomembni dve:

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

To pomeni, da novi ukaz claude plugin configure <plugin> prikaže nastavitve vtičnika in tiste, ki niso nastavljene, ali pa z zastavico --values-stdin shrani nove vrednosti, prebrane s standardnega vhoda.

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

To pomeni, da claude plugin install --config zdaj podpira obliko <server>.<key>=<value>, s katero je mogoče med namestitvijo podati nastavitve strežnika MCP, priloženega vtičniku v datoteki .mcpb, tako da se strežnik zažene brez obiska /plugin → Configure.

Referenca ukazov potrjuje zahtevano različico: claude plugin configure zahteva Claude Code v2.1.285 ali novejšo. V starejših različicah ta ukaz ne obstaja.

Kako se razlikuje od /plugin configure#

Ukaz /plugin configure <plugin> (z vzdevkom config) je bil na voljo že prej, znotraj interaktivne seje Claude Code. Odpre pogovorno okno za nastavitve userConfig in zahteva v2.1.147 ali novejšo. Vendar /plugin deluje samo v interaktivni seji: pri neinteraktivnem klicu, kot je claude -p, Claude Code sporoči, da /plugin v tem okolju ni na voljo.

Po dokumentaciji se ukazi claude plugin izvajajo iz lupine ali skripta, zunaj seje Claude Code. Tako lahko zaženete tudi claude plugin configure, ne da bi odprli pogovorno okno. Dokumentacija ne opisuje, kako se ta ukaz obnaša brez interaktivnega terminala ali kam shranjuje skrivne vrednosti na strežniku brez grafičnega okolja. Pred uporabo v CI to preverite v svojem okolju.

1. korak. Preverite, katere nastavitve so nastavljene#

Dokumentacija zahteva polni identifikator vtičnika v obliki name@marketplace, kot ga izpiše claude plugin list. Ukaz configure ne sprejme imena brez @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

formatter@my-marketplace zamenjajte z identifikatorjem svojega vtičnika. Brez zastavic ukaz za vsako nastavitev izpiše oznake: required ali optional, nato pri skrivnem polju še sensitive, zatem pa set ali not set. Shranjenih vrednosti ne izpiše.

Če potrebujete strojno berljiv izhod, dodajte --json. Izhod bo nato vključeval shranjene vrednosti običajnih polj, vsebina skrivnega polja pa ne bo nikoli izpisana.

2. korak. Spremenite vrednost z datoteko#

Vrednosti podate kot objekt JSON, pri čemer je vsak ključ ime nastavitve iz manifesta, vsaka vrednost pa niz brez prelomov vrstic. Dokumentacija prikazuje način z datoteko: objekt zapišite v values.json in to datoteko podajte kot standardni vhod ukaza. V tem primeru je api_url ključ iz primera v dokumentaciji. Za svoj vtičnik uporabite ime potrebne nastavitve iz njegovega manifesta ali izhoda 1. koraka.

{"api_url": "NEW_ADDRESS"}

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

Pri shranjevanju veljajo naslednja pravila:

• Nastavitve, ki jih v JSON-u ne navedete, ohranijo prejšnje vrednosti. Podate lahko samo polje, ki ga spreminjate.
• Opis zastavice se na splošno nanaša na nastavljanje vrednosti in ne določa posebnega pravila za skrivna polja. Po shranjevanju v 1. koraku preverite, ali je ustrezno polje označeno z set.
• Claude Code vsako vrednost preveri glede na deklarirano vrsto in izpiše Configuration saved. Restart Claude Code to apply it. To pomeni, da je bila nastavitev shranjena in bo začela veljati po ponovnem zagonu Claude Code.
• Če JSON vsebuje ključ, ki v manifestu ni deklariran, ali vrednost ne prestane preverjanja, ukaz ne shrani ničesar, izpiše Failed to save configuration: in nato razlog ter se konča z izhodno kodo 1.

Če v datoteko values.json zapišete žeton, ne pozabite, da gre za običajno datoteko na disku. Po shranjevanju konfiguracije jo izbrišite in je ne dodajajte v repozitorij.

Kje je shranjena vrednost#

Po dokumentaciji manifesta vtičnika so običajne vrednosti shranjene pod pluginConfigs v uporabnikovi datoteki settings.json. Vrednosti polj z oznako sensitive: true so namesto v settings.json shranjene v varni shrambi poverilnic sistema; vnos za ta polja je zakrit.

Skrivne vrednosti polja ni smiselno iskati v datoteki settings.json. claude plugin configure prikaže njegovo stanje z oznakama sensitive in set ali not set.

install --config: nastavitev vrednosti med namestitvijo#

Za novo namestitev ukaz claude plugin install ponuja zastavico --config <key=value>. Nastavi nastavitev userConfig, deklarirano v manifestu, in zahteva v2.1.147 ali novejšo. Zastavico ponovite za vsako nastavitev. Od različice 2.1.285 naprej ključ v obliki <server>.<key> nastavi nastavitev priloženega strežnika MCP, deklarirano v njegovem lastnem user_config.

V spodnjem primeru formatter@my-marketplace zamenjajte z identifikatorjem svojega vtičnika, api_url z imenom nastavitve iz njegovega manifesta, celoten nadomestni niz NEW_ADDRESS pa s svojo vrednostjo. Narekovaje okoli argumenta pustite.

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

Kateri ukaz uporabite, je odvisno od tega, ali je vtičnik že nameščen: install --config nastavi vrednosti ob prvi namestitvi, plugin configure --values-stdin pa spremeni vrednosti že nameščenega vtičnika.

Za nastavitve priloženega strežnika MCP dokumentacija navaja druge načine: plugin install --config ali Configure v /plugin. Ukaza plugin configure za te nastavitve ne predlaga.

Če ukaz ne najde vtičnika#

Če claude plugin configure ne najde naloženega vtičnika s tem identifikatorjem, izpiše No installed plugin has the id "<plugin>". in se konča z izhodno kodo 1. Najprej preverite, ali ste podali polni identifikator name@marketplace iz ukaza claude plugin list. Samo ime vtičnika ne zadostuje.

Ukaz v seji uporablja svoje sporočilo. Če pri uporabi /plugin enable, disable, uninstall ali configure navedete vtičnik, ki ni nameščen v trenutnem projektu, Claude Code izpiše Plugin "<plugin>" is not installed in this project in ne izvede ničesar.

Sklep#

Če želite spremeniti žeton ali naslov že nameščenega vtičnika v Claude Code 2.1.285 ali novejši različici, poiščite njegov identifikator z claude plugin list, preverite stanje nastavitev z claude plugin configure, podajte novo vrednost iz datoteke z --values-stdin in znova zaženite Claude Code. Vrednosti skrivnih polj niso shranjene v settings.json, zato njihovo stanje preverite z istim ukazom.

Vodnik o Skills, Subagents, MCP in Plugins v Claude Code vam lahko pomaga izbrati vrsto razširitve. Če še niste izbrali vtičnika, lahko začnete z 10 najboljšimi vtičniki Claude Code. Za Telegramov bot je na voljo ločen vodnik: namestitev vtičnika v Telegramovega agenta se razlikuje od namestitve v Claude Code.

Spoznajte Ailoot.