Claude Code: cómo reconfigurar un plugin instalado sin reinstalarlo (2.1.285)

Esta guía está dirigida a quienes ya tienen instalado un plugin de Claude Code que declara ajustes userConfig, como una dirección, un token o la ruta de una carpeta. Necesita corregir un valor introducido incorrectamente o reemplazar un token sin reinstalar el plugin. Todo lo que sigue se basa en la documentación y el registro de cambios oficiales de Claude Code. El artículo no incluye una prueba realizada por el autor.

Encontrará información sobre cómo usar Ailoot en la documentación.

Qué añadió la versión 2.1.285#

La entrada del registro de cambios de Claude Code para la versión 2.1.285 (un commit con fecha del 29 de septiembre de 2026) contiene varias líneas sobre plugins. Dos de ellas son relevantes para este artículo:

Se añadió claude plugin configure <plugin> para mostrar las opciones de un plugin y cuáles no están configuradas, o guardar nuevos valores leídos de stdin con --values-stdin

Esto significa que el nuevo comando claude plugin configure <plugin> muestra los ajustes de un plugin y cuáles no están configurados, o guarda nuevos valores leídos de la entrada estándar cuando se usa con --values-stdin.

Se añadió <server>.<key>=<value> a claude plugin install --config, para que los ajustes propios de un servidor MCP incluido en un archivo .mcpb puedan configurarse durante la instalación y este se inicie sin visitar /plugin → Configure

Esto significa que claude plugin install --config ahora admite el formato <server>.<key>=<value>, que permite proporcionar durante la instalación los ajustes de un servidor MCP incluido en un plugin dentro de un archivo .mcpb, de modo que el servidor se inicie sin visitar /plugin → Configure.

La referencia de comandos confirma el requisito de versión: claude plugin configure requiere Claude Code v2.1.285 o posterior. El comando no existe en versiones anteriores.

¿En qué se diferencia claude plugin configure de /plugin configure?#

El comando /plugin configure <plugin> (con el alias config) ya estaba disponible dentro de una sesión interactiva de Claude Code. Abre un diálogo para los ajustes userConfig y requiere v2.1.147 o posterior. Sin embargo, /plugin solo funciona en una sesión interactiva: en una invocación no interactiva como claude -p, Claude Code responde que /plugin no está disponible en ese entorno.

Según la documentación, los comandos claude plugin se ejecutan desde un shell o un script, fuera de una sesión de Claude Code. Esto también permite ejecutar claude plugin configure sin abrir un diálogo. La documentación no describe cómo se comporta este comando sin un terminal interactivo ni dónde guarda los valores secretos en un servidor sin entorno gráfico. Compruébelo en su propio entorno antes de usarlo en CI.

Paso 1. Ver qué ajustes están configurados#

La documentación exige el identificador completo del plugin con el formato name@marketplace, como el que muestra claude plugin list. El comando configure no acepta un nombre sin @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

Sustituya formatter@my-marketplace por el identificador de su plugin. Sin opciones, el comando muestra cada ajuste con las etiquetas required u optional; después, sensitive en el caso de un campo secreto, y finalmente set o not set. No muestra los valores guardados.

Si necesita una salida legible por máquina, añada --json. La salida incluirá entonces los valores guardados de los campos normales, pero el contenido de un campo secreto nunca se mostrará.

Paso 2. Cambiar un valor con un archivo#

Los valores se proporcionan como un objeto JSON, donde cada clave es el nombre de un ajuste del manifiesto y cada valor es una cadena sin saltos de línea. La documentación muestra un método basado en un archivo: escriba el objeto en values.json y pase ese archivo a la entrada estándar del comando. Aquí, api_url es la clave utilizada en el ejemplo de la documentación. Para su propio plugin, use el nombre del ajuste que necesita, tal como aparece en su manifiesto o en la salida del paso 1.

{"api_url": "NEW_ADDRESS"}

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

Al guardar, se aplican las reglas siguientes:

• Los ajustes omitidos en el JSON conservan sus valores anteriores. Puede proporcionar solo el campo que va a cambiar.
• La descripción de la opción se refiere a la configuración de valores en general y no indica una regla específica para los campos secretos. Después de guardar, use el paso 1 para comprobar que el campo correspondiente aparezca como set.
• Claude Code comprueba cada valor según el tipo declarado y muestra Configuration saved. Restart Claude Code to apply it. Esto significa que el ajuste se ha guardado y tendrá efecto después de reiniciar Claude Code.
• Si el JSON contiene una clave no declarada en el manifiesto o un valor no supera la validación, el comando no guarda nada, muestra Failed to save configuration: seguido del motivo y termina con el código 1.

Si escribe un token en values.json, recuerde que es un archivo normal en el disco. Elimínelo después de guardar la configuración y no añada ese archivo al repositorio.

Dónde se guarda el valor#

Según la documentación del manifiesto del plugin, los valores normales se guardan bajo pluginConfigs en el archivo settings.json del usuario. En cambio, los valores de los campos marcados como sensitive: true se guardan en el almacén seguro de credenciales del sistema, no en settings.json; la entrada de estos campos se oculta.

No tiene sentido buscar en settings.json el valor de un campo secreto. claude plugin configure muestra su estado con las etiquetas sensitive y set o not set.

install --config: establecer un valor durante la instalación#

Para una instalación nueva, claude plugin install ofrece la opción --config <key=value>. Esta establece un ajuste userConfig declarado en el manifiesto y requiere v2.1.147 o posterior. Repita la opción para cada ajuste. A partir de la versión 2.1.285, una clave con el formato <server>.<key> establece un ajuste de un servidor MCP incluido, declarado en su propio user_config.

En el ejemplo siguiente, sustituya formatter@my-marketplace por el identificador de su plugin, api_url por el nombre del ajuste de su manifiesto y todo el marcador de posición NEW_ADDRESS por su propio valor. Mantenga las comillas alrededor del argumento.

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

El comando que debe usar depende de si el plugin ya está instalado: install --config establece valores durante la primera instalación, mientras que plugin configure --values-stdin cambia los valores de un plugin ya instalado.

Para los ajustes de un servidor MCP incluido, la documentación enumera otros métodos: plugin install --config o Configure en /plugin. No recomienda el comando plugin configure para esos ajustes.

Si el comando no encuentra el plugin#

Si claude plugin configure no encuentra un plugin cargado con ese identificador, muestra No installed plugin has the id "<plugin>". y termina con el código 1. Primero compruebe que haya proporcionado el identificador completo name@marketplace de claude plugin list. El nombre del plugin por sí solo no basta.

El comando dentro de la sesión tiene su propio mensaje. Si indica un plugin que no está instalado en el proyecto actual al usar /plugin enable, disable, uninstall o configure, Claude Code muestra Plugin "<plugin>" is not installed in this project y no hace nada.

Conclusión#

Para cambiar un token o una dirección de un plugin ya instalado en Claude Code 2.1.285 o posterior, busque su identificador con claude plugin list, compruebe el estado de los ajustes con claude plugin configure, proporcione el nuevo valor desde un archivo con --values-stdin y reinicie Claude Code. Los valores de los campos secretos no se guardan en settings.json, así que compruebe su estado con el mismo comando.

La guía sobre Skills, Subagents, MCP y Plugins en Claude Code puede ayudarle a elegir entre los tipos de extensiones. Si aún no ha elegido un plugin, puede empezar por los 10 mejores plugins de Claude Code. Hay una guía aparte para un bot de Telegram: instalar un plugin en un agente de Telegram funciona de forma diferente a instalarlo en Claude Code.

Conoce Ailoot.