Claude Code: kaip iš naujo sukonfigūruoti įdiegtą papildinį jo neįdiegiant iš naujo (2.1.285)

Šis vadovas skirtas naudotojams, kurie jau yra įdiegę Claude Code papildinį, deklaruojantį userConfig nustatymus, pavyzdžiui, adresą, prieigos raktą ar aplanko kelią. Jums reikia ištaisyti neteisingai įvestą reikšmę arba pakeisti prieigos raktą neįdiegiant papildinio iš naujo. Visa toliau pateikta informacija paremta oficialia Claude Code dokumentacija ir pakeitimų žurnalu. Straipsnyje nėra pateikta originalaus bandymo rezultatų.

Informacijos apie Ailoot naudojimą rasite dokumentacijoje.

Kas buvo pridėta 2.1.285 versijoje#

Claude Code pakeitimų žurnalo įraše apie 2.1.285 versiją (2026 m. rugsėjo 29 d. datuotame commit) yra kelios eilutės apie papildinius. Dvi iš jų susijusios su šiuo straipsniu:

Pridėta claude plugin configure <plugin> komanda papildinio parinktims ir nenustatytiems nustatymams rodyti arba naujoms reikšmėms iš stdin įrašyti naudojant --values-stdin

Tai reiškia, kad nauja komanda claude plugin configure <plugin> rodo papildinio nustatymus ir tuos, kurie nenustatyti, arba, naudojant ją su --values-stdin, įrašo naujas reikšmes, nuskaitytas iš standartinės įvesties.

Pridėta <server>.<key>=<value> forma prie claude plugin install --config, kad į papildinį įtraukto .mcpb failo MCP serverio nustatymus būtų galima nurodyti diegimo metu ir serveris būtų paleistas neatidarius /plugin → Configure

Tai reiškia, kad claude plugin install --config dabar palaiko <server>.<key>=<value> formą. Taip diegiant galima nurodyti papildinio .mcpb faile esančio MCP serverio nustatymus, kad serveris būtų paleistas neatidarius /plugin → Configure.

Komandų nuoroda patvirtina versijos reikalavimą: claude plugin configure reikia Claude Code v2.1.285 arba naujesnės versijos. Ankstesnėse versijose šios komandos nėra.

Kuo tai skiriasi nuo /plugin configure#

Komanda /plugin configure <plugin> (su pseudonimu config) jau buvo prieinama interaktyvioje Claude Code sesijoje. Ji atveria userConfig nustatymų dialogo langą ir jai reikia v2.1.147 arba naujesnės versijos. Tačiau /plugin veikia tik interaktyvioje sesijoje: neinteraktyvaus paleidimo, pavyzdžiui, claude -p, metu Claude Code praneša, kad /plugin šioje aplinkoje nepasiekiama.

Dokumentacijoje nurodyta, kad claude plugin komandos vykdomos apvalkale arba scenarijuje, ne Claude Code sesijoje. Todėl claude plugin configure galima paleisti neatveriant dialogo lango. Dokumentacijoje neaprašyta, kaip ši komanda veikia be interaktyviojo terminalo arba kur ji saugo slaptas reikšmes serveryje be grafinės aplinkos. Prieš naudodami ją CI aplinkoje, patikrinkite savo aplinką.

1 žingsnis. Sužinokite, kurie nustatymai nustatyti#

Dokumentacijoje reikalaujama nurodyti visą papildinio identifikatorių formatu name@marketplace, kurį rodo claude plugin list. Komanda configure nepriima pavadinimo be @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

Vietoj formatter@my-marketplace įrašykite savo papildinio identifikatorių. Nenurodžius vėliavėlių, komanda pateikia kiekvieną nustatymą su žymomis: required arba optional, tada slapto lauko atveju sensitive, o galiausiai set arba not set. Išsaugotų reikšmių ji nerodo.

Jei reikia kompiuterio skaitomo išvesties formato, pridėkite --json. Tada išvestyje bus pateiktos įprastų laukų išsaugotos reikšmės, tačiau slapto lauko turinys niekada nerodomas.

2 žingsnis. Pakeiskite reikšmę naudodami failą#

Reikšmės pateikiamos kaip JSON objektas: kiekvienas raktas yra nustatymo pavadinimas iš manifesto, o kiekviena reikšmė – eilutė be eilučių lūžių. Dokumentacijoje pateikiamas būdas naudojant failą: įrašykite objektą į values.json ir nukreipkite šį failą į komandos standartinę įvestį. Čia api_url yra dokumentacijos pavyzdyje naudojamas raktas. Savo papildiniui naudokite reikiamo nustatymo pavadinimą iš jo manifesto arba 1 žingsnio išvesties.

{"api_url": "NEW_ADDRESS"}

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

Išsaugant taikomos šios taisyklės:

• JSON nenurodyti nustatymai išlaiko ankstesnes reikšmes. Galite pateikti tik keičiamą lauką.
• Vėliavėlės apraše bendrai kalbama apie reikšmių nustatymą, tačiau atskiros taisyklės slaptiems laukams nenurodyta. Išsaugoję, 1 žingsnyje patikrinkite, ar atitinkamas laukas pažymėtas set.
• Claude Code patikrina kiekvieną reikšmę pagal deklaruotą tipą ir išveda Configuration saved. Restart Claude Code to apply it. Tai reiškia, kad nustatymas išsaugotas ir įsigalios iš naujo paleidus Claude Code.
• Jei JSON yra manifeste nedeklaruotas raktas arba reikšmė neatitinka patikros, komanda nieko neišsaugo, išveda Failed to save configuration: ir nurodo priežastį, tada baigia darbą kodu 1.

Jei įrašysite prieigos raktą į values.json, atminkite, kad tai įprastas diske saugomas failas. Išsaugoję konfigūraciją jį ištrinkite ir nedėkite tokio failo į saugyklą.

Kur saugoma reikšmė#

Papildinio manifesto dokumentacijoje nurodyta, kad įprastos reikšmės saugomos naudotojo settings.json faile, skiltyje pluginConfigs. Laukų, pažymėtų sensitive: true, reikšmės saugomos sistemos saugioje kredencialų saugykloje, o ne settings.json faile; įvestis šiems laukams yra užmaskuojama.

Nėra prasmės ieškoti slapto lauko reikšmės settings.json faile. claude plugin configure jo būseną rodo žymomis sensitive ir set arba not set.

install --config: nustatykite reikšmę diegdami#

Diegiant naują papildinį, claude plugin install komanda turi vėliavėlę --config <key=value>. Ji nustato manifeste deklaruotą userConfig reikšmę; tam reikia v2.1.147 arba naujesnės versijos. Kiekvienam nustatymui vėliavėlę pakartokite. Nuo 2.1.285 versijos raktas formatu <server>.<key> nustato papildinyje esančio MCP serverio parametrą, deklaruotą jo paties user_config.

Toliau pateiktame pavyzdyje vietoj formatter@my-marketplace įrašykite savo papildinio identifikatorių, vietoj api_url – manifesto nustatymo pavadinimą, o visą vietaženklį NEW_ADDRESS pakeiskite savo reikšme. Argumentą apgaubiančias kabutes palikite.

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

Kokią komandą naudoti, priklauso nuo to, ar papildinys jau įdiegtas: install --config nustato reikšmes pirmojo diegimo metu, o plugin configure --values-stdin pakeičia jau įdiegto papildinio reikšmes.

Papildinyje esančio MCP serverio nustatymams dokumentacijoje nurodyti kiti būdai: plugin install --config arba Configure skiltyje /plugin. Šiems nustatymams naudoti komandą plugin configure nesiūloma.

Jei komanda neranda papildinio#

Jei claude plugin configure neranda įkelto papildinio su tuo identifikatoriumi, išveda No installed plugin has the id "<plugin>". ir baigia darbą kodu 1. Pirmiausia patikrinkite, ar nurodėte visą name@marketplace identifikatorių iš claude plugin list. Vien papildinio pavadinimo nepakanka.

Sesijoje vykdoma komanda pateikia kitokį pranešimą. Jei naudodami /plugin enable, disable, uninstall arba configure nurodysite papildinį, kuris nėra įdiegtas dabartiniame projekte, Claude Code išves Plugin "<plugin>" is not installed in this project ir nieko nedarys.

Išvada#

Norėdami pakeisti jau įdiegto papildinio prieigos raktą arba adresą Claude Code 2.1.285 ar naujesnėje versijoje, komanda claude plugin list raskite jo identifikatorių, claude plugin configure patikrinkite nustatymų būseną, su --values-stdin pateikite naują reikšmę iš failo ir iš naujo paleiskite Claude Code. Slaptų laukų reikšmės nesaugomos settings.json faile, todėl jų būseną tikrinkite ta pačia komanda.

Vadovas apie Skills, Subagents, MCP ir Plugins Claude Code aplinkoje gali padėti pasirinkti plėtinio tipą. Jei dar nepasirinkote papildinio, galite pradėti nuo 10 geriausių Claude Code papildinių. Yra atskiras vadovas apie Telegram botą: papildinio įdiegimas Telegram agente skiriasi nuo papildinio diegimo Claude Code aplinkoje.

Susipažinkite su Ailoot.