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

> Claude Code 2.1.285 нұсқасында claude plugin configure пәрмені қосылды. Құжаттамадан плагин параметрлерін қалай тексеруге және токенді не мекенжайды қайта орнатпай өзгертуге болатынын біліңіз.

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


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Осы бөлімнің негізгі түйіні">

Негізгі түйін

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

</div>

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

Ailoot қызметін пайдалану туралы ақпарат [құжаттамада](https://ailoot.ai/docs/) берілген.



## 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` бөлігі жоқ атауды қабылдамайды.

```bash
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-қадамдағы шығыстан қажет параметрдің атауын пайдаланыңыз.

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

```bash
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` таңбалағышының тұтас мәнін өз мәніңізбен ауыстырыңыз. Аргументтің айналасындағы тырнақшаларды сақтаңыз.

```bash
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](https://ailoot.ai/blog/kk/skills-subagents-mcp-plugins-claude-code/) нұсқаулығы кеңейтім түрлерінің бірін таңдауға көмектеседі. Плагинді әлі таңдамаған болсаңыз, Claude Code-қа арналған үздік 10 плагиннен бастауға болады. Telegram ботына арналған бөлек нұсқаулық бар: [Telegram агентіне плагин орнату](https://ailoot.ai/blog/kk/telegram-ai-agent-plugins/) тәсілі Claude Code-қа орнатудан өзгеше.

<div class="section" role="doc-bibliography" aria-label="Дереккөздер">

### Дереккөздер

- [Claude Code CHANGELOG, 2.1.285 нұсқасына арналған жазба](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code: плагин пәрмендерінің анықтамалығы](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code: плагин манифестінің анықтамалығы, пайдаланушы баптауы](https://code.claude.com/docs/en/plugins-reference.md)

</div>





[Ailoot-пен танысыңыз](https://ailoot.ai/).

## Жиі қойылатын сұрақтар

### Неге configure орнатылған плагинді таба алмайды?

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

### Өзгертілген токенді экранға шығармай қалай тексеремін?

Плагиннің толық идентификаторымен `claude plugin configure` орындап, құпия өрістің толтырылған деп белгіленгенін тексеріңіз. Сақтағаннан кейін Claude Code-ты қайта іске қосыңыз; токені бар кіріс JSON файлын Git-ке қоспаңыз.


## Ailoot · Компания және оның жобалар портфелі

Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді.

Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.

Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.