# claude plugin configure: как заменить токен без переустановки

> В Claude Code 2.1.285 появилась команда claude plugin configure. Узнайте, как проверить настройки установленного плагина и заменить токен или адрес без переустановки.

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


<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>

Эта инструкция предназначена для пользователей, у которых уже установлен плагин Claude Code с параметрами `userConfig`, например адресом, токеном или путём к каталогу. Она поможет исправить ошибочное значение или обновить токен без переустановки. Сведения ниже взяты из официальной документации и журнала изменений Claude Code; собственного тестирования в статье нет.

Сведения об использовании Ailoot приведены в [документации](https://ailoot.ai/docs/).

## Нововведения версии 2.1.285

В записи о версии 2.1.285 журнала изменений Claude Code, соответствующей коммиту от 29.09.2026, перечислено несколько обновлений для плагинов. Для этой инструкции важны два пункта:

> 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`

Перевод: появилась команда `claude plugin configure <plugin>`. Она показывает параметры плагина и отмечает незаданные, а также позволяет сохранять новые значения, полученные из стандартного ввода с флагом `--values-stdin`.

> В установочную команду добавили параметр для передачи настроек MCP-сервера из пакета `.mcpb`. Сервер можно настроить при установке без отдельного перехода в меню Configure.

Перевод: в `claude plugin install --config` добавлен формат `<server>.<key>=<value>`. Он позволяет при установке указать собственные параметры MCP-сервера, встроенного в плагин из `.mcpb`, чтобы сервер запускался без перехода в `/plugin` → Configure.

В справочнике команд указано, что для `claude plugin configure` требуется Claude Code версии 2.1.285 или новее. В более ранних версиях команды нет.

## Отличия от /plugin configure

В интерактивном Claude Code ранее появилась команда `/plugin configure <plugin>` (сокращённая форма — `config`). Она открывает диалог для настройки `userConfig` и доступна начиная с версии v2.1.147. Однако `/plugin` работает только в интерактивной сессии. При неинтерактивном запуске, например `claude -p`, Claude Code сообщает, что команда `/plugin` недоступна в этой среде.

Согласно документации, команды `claude plugin` запускаются из оболочки или сценария, за пределами сессии Claude Code. Поэтому `claude plugin configure` можно вызвать, не открывая диалог. Документация не поясняет, как команда работает без интерактивного терминала и где на сервере без графической среды размещаются секретные значения. Перед запуском в CI проверьте её поведение в своей среде.

## Шаг 1. Проверить заданные параметры

Для команды нужен полный идентификатор плагина вида `name@marketplace`, такой же, как в выводе `claude plugin list`. Команда `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` — ключ из документации. Для своего плагина укажите название нужного параметра из его манифеста или вывода первого шага.

```json
{"api_url": "НОВЫЙ_АДРЕС"}
```

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

При сохранении учитывайте следующие условия:

- Параметры, не указанные в JSON, остаются без изменений. Передавайте только те поля, которые требуется обновить.
- Описание флага относится к значениям параметров в целом и отдельно не оговаривает секретные поля. После записи проверьте первым шагом, что нужное поле отмечено как `set`.
- 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` не получится. Его состояние можно проверить командой `claude plugin configure`: она показывает для поля отметки `sensitive` и `set` либо `not set`.

## install --config: передача параметров при установке

Для установки плагина предусмотрен флаг `--config <key=value>` команды `claude plugin install`. Он задаёт параметры `userConfig`, объявленные в манифесте, и требует версии v2.1.147 или новее. Для каждой настройки флаг нужно указать отдельно. Начиная с версии 2.1.285 ключ в формате `<server>.<key>` задаёт параметр встроенного MCP-сервера, объявленный в его собственном `user_config`.

В примере замените `formatter@my-marketplace` на полный идентификатор своего плагина, `api_url` — на имя настройки из его манифеста, а `НОВЫЙ_АДРЕС` — на нужное значение. Аргумент обязательно оставьте в кавычках.

```bash
claude plugin install formatter@my-marketplace --config 'api_url=НОВЫЙ_АДРЕС'
```

Используйте команду, соответствующую ситуации: `install --config` задаёт значения во время первой установки, а `plugin configure --values-stdin` обновляет настройки уже установленного плагина.

Для параметров встроенного MCP-сервера документация называет два способа настройки: `plugin install --config` или пункт **Configure** в `/plugin`. Команда `plugin configure` для этих параметров не предлагается.

## Если команда не находит плагин

Если `claude plugin configure` не находит установленный плагин с указанным идентификатором, она выводит `No installed plugin has the id "<plugin>".` и завершается с кодом `1`. Убедитесь, что передали полный идентификатор `name@marketplace` из `claude plugin list`: одного имени недостаточно.

Для команд внутри сессии предусмотрено отдельное сообщение. Если в `/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`; проверяйте их состояние той же командой.

<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: справочник по манифесту плагина, раздел User configuration](https://code.claude.com/docs/en/plugins-reference.md)

</div>



Познакомьтесь с [Ailoot](https://ailoot.ai/).

## Вопросы и ответы

### Почему configure не находит установленный плагин?

Укажите полный идентификатор name@marketplace из claude plugin list и проверьте установку в нужной области настроек. Одно короткое имя плагина эта команда не принимает.

### Как проверить заменённый токен, не печатая его?

Запустите claude plugin configure с полным идентификатором плагина и проверьте, что секретное поле отмечено как установленное. После сохранения перезапустите Claude Code. Не коммитьте входной JSON с токеном.


## Ailoot · Компания и портфель её проектов

Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI.

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.