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

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

Сведения об использовании Ailoot приведены в документации.

Нововведения версии 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.

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 — ключ из документации. Для своего плагина укажите название нужного параметра из его манифеста или вывода первого шага.

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

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 — на имя настройки из его манифеста, а НОВЫЙ_АДРЕС — на нужное значение. Аргумент обязательно оставьте в кавычках.

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; проверяйте их состояние той же командой.

Познакомьтесь с Ailoot.