Claude Code: как перенастроить уже установленный плагин без переустановки (2.1.285)

Разбор для тех, у кого плагин Claude Code уже установлен и объявляет настройки userConfig: адрес, токен, путь к папке. Нужно исправить неверно введённое значение или заменить токен без переустановки плагина. Всё ниже опирается на официальную документацию и журнал изменений Claude Code. Собственного тестового прогона в статье нет.

За новыми материалами об ИИ-инструментах можно следить в каналах.

Что добавила версия 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.

Added <server>.<key>=<value> to claude plugin install --config, so a bundled .mcpb MCP server's own settings can be set at install time and it starts without visiting /plugin → Configure

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

Справочник команд подтверждает требование к версии: claude plugin configure требует Claude Code v2.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 проверь это на своей среде.

Программу практикума СмыслоКода можно посмотреть отдельно от этой инструкции.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 17–19 ноября  ·  2 000 ₽

Записаться →

Шаг 1. Посмотреть, какие настройки заданы

Документация требует полный идентификатор плагина в форме name@marketplace, как его показывает claude plugin list. Имя без @marketplace команда configure не принимает.

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": "НОВЫЙ_АДРЕС"}

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

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

• Настройки, которых нет в JSON, сохраняют прежние значения. Можно передать только то поле, которое меняешь.
• Описание флага говорит о значениях настроек вообще и отдельного правила для секретных полей не называет. После сохранения проверь шагом 1, что у нужного поля стоит метка set.
• Claude Code проверяет каждое значение по объявленному типу и печатает Configuration saved. Restart Claude Code to apply it. То есть настройка сохранена, а применится после перезапуска Claude Code.
• Если в JSON есть ключ, которого манифест не объявляет, или значение не прошло проверку, команда ничего не сохраняет, печатает Failed to save configuration: с причиной и завершается с кодом 1.

Если записываешь токен в values.json, помни, что это обычный файл на диске. После сохранения удали его и не добавляй такой файл в репозиторий.

Где хранится значение

По документации манифеста плагина, обычные значения сохраняются под ключом pluginConfigs в settings.json пользователя. Значения полей с sensitive: true хранятся в защищённом хранилище учётных данных системы вместо settings.json; ввод таких полей маскируется.

Искать значение секретного поля в 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 не хранятся, поэтому проверяй их состояние этой же командой.

Выбрать между типами расширений поможет разбор Skills, Subagents, MCP и Plugins в Claude Code. Если плагин ещё не выбран, можно начать с топ-10 плагинов Claude Code. Для бота в Telegram есть отдельная инструкция: установка плагина в Telegram-агенте устроена иначе, чем в Claude Code.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 17–19 ноября  ·  2 000 ₽

Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Подписаться в Telegramили на email