Claude Code: орнатылған плагинді қайта орнатпай қалай қайта баптауға болады (2.1.285)

Бұл нұсқаулық userConfig параметрлерін, мысалы мекенжайды, токенді немесе бума жолын жариялайтын Claude Code плагинін орнатып қойған пайдаланушыларға арналған. Қате енгізілген мәнді түзету немесе плагинді қайта орнатпай токенді ауыстыру қажет болуы мүмкін. Төмендегі ақпараттың бәрі Claude Code ресми құжаттамасы мен өзгерістер журналында берілген. Мақалаға бастапқы сынақ жүргізу нәтижесі кірмейді.

Ailoot қызметін пайдалану туралы ақпарат құжаттамада берілген.

2.1.285 нұсқасында не қосылды#

Claude Code өзгерістер журналының 2.1.285 нұсқасына арналған жазбасында (2026 жылғы 29 қыркүйектегі коммит) плагиндер туралы бірнеше жол бар. Олардың екеуі осы мақалаға қатысты:

claude plugin configure <plugin> пәрмені плагиннің параметрлерін және қайсысы орнатылмағанын көрсету немесе --values-stdin жалаушасымен stdin арқылы оқылған жаңа мәндерді сақтау үшін қосылды

Бұл жаңа claude plugin configure <plugin> пәрмені плагин параметрлерін және қайсысы орнатылмағанын көрсететінін немесе --values-stdin жалаушасымен бірге қолданғанда стандартты кірістен оқылған жаңа мәндерді сақтайтынын білдіреді.

<server>.<key>=<value> пішімі claude plugin install --config пәрменіне қосылды, осылайша жинақталған .mcpb MCP серверінің өз параметрлерін орнату кезінде беруге болады және сервер /plugin → Configure бөліміне кірмей-ақ іске қосылады

Бұл claude plugin install --config пәрмені енді <server>.<key>=<value> пішімін қолдайтынын білдіреді. Ол .mcpb файлындағы плагинмен бірге жинақталған MCP серверінің параметрлерін орнату кезінде беруге мүмкіндік береді, сонда сервер /plugin → Configure бөліміне кірмей-ақ іске қосылады.

Пәрмен анықтамалығында нұсқаға қойылатын талап расталған: claude plugin configure пәрменін пайдалану үшін Claude Code v2.1.285 немесе одан кейінгі нұсқасы қажет. Бұрынғы нұсқаларда бұл пәрмен жоқ.

Бұл пәрменнің /plugin configure пәрменінен айырмашылығы#

/plugin configure <plugin> пәрмені (config бүркеншік атауымен) Claude Code интерактивті сеансында бұрыннан қолжетімді еді. Ол userConfig параметрлеріне арналған диалогтік терезені ашады және v2.1.147 немесе одан кейінгі нұсқаны қажет етеді. Алайда /plugin тек интерактивті сеанста жұмыс істейді: мысалы, claude -p сияқты интерактивті емес шақыруда Claude Code /plugin бұл ортада қолжетімсіз екенін хабарлайды.

Құжаттамаға сәйкес, claude plugin пәрмендері Claude Code сеансынан тыс жерде, қабықтан немесе скрипттен орындалады. Бұл сонымен қатар диалогтік терезені ашпай-ақ claude plugin configure пәрменін орындауға мүмкіндік береді. Құжаттамада пәрменнің интерактивті терминалсыз қалай жұмыс істейтіні немесе графикалық ортасы жоқ серверде құпия мәндерді қайда сақтайтыны сипатталмаған. CI ортасында қолданар алдында оны өз ортаңызда тексеріңіз.

1-қадам. Қай параметрлер орнатылғанын қараңыз#

Құжаттамаға сәйкес, claude plugin list пәрмені көрсететін name@marketplace пішіміндегі толық плагин идентификаторын пайдалану қажет. configure пәрмені @marketplace бөлігі жоқ атауды қабылдамайды.

claude plugin list
claude plugin configure formatter@my-marketplace

formatter@my-marketplace мәнін плагиніңіздің идентификаторымен ауыстырыңыз. Жалаушаларсыз пәрмен әр параметрді мына белгілермен көрсетеді: алдымен required немесе optional, құпия өріс болса, одан кейін sensitive, соңында set немесе not set. Сақталған мәндерді шығармайды.

Егер машина оқи алатын шығыс қажет болса, --json жалаушасын қосыңыз. Онда қарапайым өрістердің сақталған мәндері де көрсетіледі, бірақ құпия өрістің мазмұны ешқашан басып шығарылмайды.

2-қадам. Файл арқылы мәнді өзгертіңіз#

Мәндер JSON нысаны түрінде беріледі: әр кілт манифестегі параметр атауы, ал әр мәні жол үзілістері жоқ жол болуы керек. Құжаттамада файлды пайдалану тәсілі көрсетілген: нысанды values.json файлына жазып, сол файлды пәрменнің стандартты кірісіне беріңіз. Мұнда api_url — құжаттама мысалында қолданылған кілт. Өз плагиніңіз үшін манифесттен немесе 1-қадамдағы шығыстан қажет параметрдің атауын пайдаланыңыз.

{"api_url": "NEW_ADDRESS"}

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

Сақтау кезінде мына ережелер қолданылады:

• JSON-да көрсетілмеген параметрлер бұрынғы мәндерін сақтайды. Тек өзгертіп жатқан өрісті ғана бере аласыз.
• Жалауша сипаттамасында жалпы параметр мәндерін орнату туралы айтылған, бірақ құпия өрістерге арналған бөлек ереже көрсетілмеген. Сақтағаннан кейін тиісті өрістің set деп белгіленгенін тексеру үшін 1-қадамды орындаңыз.
• Claude Code әр мәнді жарияланған түрімен салыстырып тексереді де, Configuration saved. Restart Claude Code to apply it. мәтінін шығарады. Бұл параметр сақталғанын және Claude Code қайта іске қосылғаннан кейін күшіне енетінін білдіреді.
• JSON-да манифестте жарияланбаған кілт болса немесе мән тексеруден өтпесе, пәрмен ештеңе сақтамайды, одан кейін себебін көрсетіп Failed to save configuration: мәтінін шығарады және 1 кодымен аяқталады.

Токенді values.json файлына жазсаңыз, оның дискідегі кәдімгі файл екенін ұмытпаңыз. Баптауды сақтағаннан кейін оны жойыңыз және мұндай файлды репозиторийге қоспаңыз.

Мән қайда сақталады#

Плагин манифестінің құжаттамасына сәйкес, қарапайым мәндер пайдаланушының settings.json файлындағы pluginConfigs бөлімінде сақталады. sensitive: true деп белгіленген өрістердің мәндері settings.json орнына жүйенің қауіпсіз тіркелгі деректерін сақтау қоймасында сақталады; осы өрістерге енгізілген мәтін бүркемеленеді.

Құпия өрістің мәнін settings.json файлынан іздеудің қажеті жоқ. claude plugin configure оның күйін sensitive және set немесе not set белгілерімен көрсетеді.

install --config: орнату кезінде мәнді беру#

Жаңа орнату үшін claude plugin install пәрменінде --config <key=value> жалаушасы бар. Ол манифесте жарияланған userConfig параметрін орнатады және v2.1.147 немесе одан кейінгі нұсқаны қажет етеді. Әр параметр үшін жалаушаны қайталаңыз. 2.1.285 нұсқасынан бастап, <server>.<key> пішіміндегі кілт жинақталған MCP серверінің өз user_config бөлімінде жарияланған параметрін орнатады.

Төмендегі мысалда formatter@my-marketplace мәнін плагиніңіздің идентификаторымен, api_url мәнін оның манифестіндегі параметр атауымен, ал NEW_ADDRESS таңбалағышының тұтас мәнін өз мәніңізбен ауыстырыңыз. Аргументтің айналасындағы тырнақшаларды сақтаңыз.

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

Қай пәрменді пайдалану керегі плагиннің орнатылған-орнатылмағанына байланысты: install --config алғашқы орнату кезінде мәндерді орнатады, ал plugin configure --values-stdin орнатылып қойған плагиннің мәндерін өзгертеді.

Жинақталған MCP серверіне тиесілі параметрлер үшін құжаттамада басқа әдістер көрсетілген: plugin install --config немесе /plugin ішіндегі Configure. Онда осы параметрлерге plugin configure пәрменін пайдалану ұсынылмайды.

Пәрмен плагинді таба алмаса#

Егер claude plugin configure пәрмені көрсетілген идентификаторы бар жүктелген плагинді таба алмаса, No installed plugin has the id "<plugin>". мәтінін шығарып, 1 кодымен аяқталады. Алдымен claude plugin list көрсеткен толық name@marketplace идентификаторын бергеніңізді тексеріңіз. Тек плагин атауы жеткіліксіз.

Сеанс ішіндегі пәрменнің бөлек хабарламасы бар. /plugin enable, disable, uninstall немесе configure пәрменін пайдаланғанда ағымдағы жобада орнатылмаған плагиннің атын көрсетсеңіз, Claude Code Plugin "<plugin>" is not installed in this project мәтінін шығарып, ештеңе істемейді.

Қорытынды#

Claude Code 2.1.285 немесе одан кейінгі нұсқасында орнатылған плагиннің токенін не мекенжайын өзгерту үшін оның идентификаторын claude plugin list пәрменінен тауып, параметрлердің күйін claude plugin configure пәрменімен тексеріңіз, жаңа мәнді --values-stdin арқылы файлдан беріп, Claude Code-ты қайта іске қосыңыз. Құпия өрістердің мәндері settings.json ішінде сақталмайды, сондықтан олардың күйін осы пәрменмен тексеріңіз.

Claude Code-тағы Skills, Subagents, MCP және Plugins нұсқаулығы кеңейтім түрлерінің бірін таңдауға көмектеседі. Плагинді әлі таңдамаған болсаңыз, Claude Code-қа арналған үздік 10 плагиннен бастауға болады. Telegram ботына арналған бөлек нұсқаулық бар: Telegram агентіне плагин орнату тәсілі Claude Code-қа орнатудан өзгеше.

Ailoot-пен танысыңыз.