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

> Claude Code 2.1.285 introdujo el comando claude plugin configure. Cómo consultar la configuración de un plugin en la documentación y cambiar un token o una dirección sin reinstalarlo.

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


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto clave de esta sección">

Punto clave

Claude Code 2.1.285 introdujo el comando de terminal `claude plugin configure <plugin>`. Sin opciones, muestra qué ajustes del plugin están configurados y cuáles no, sin mostrar sus valores. Con `--values-stdin`, guarda nuevos valores desde un archivo JSON proporcionado como entrada, sin reinstalar el plugin. Los valores normales se guardan en `settings.json`, bajo `pluginConfigs`, mientras que los valores de los campos marcados como `sensitive: true` se guardan en el almacén seguro de credenciales del sistema.

</div>

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](https://ailoot.ai/docs/).



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

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

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

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

```bash
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](https://ailoot.ai/blog/es/skills-subagents-mcp-plugins-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](https://ailoot.ai/blog/es/telegram-ai-agent-plugins/) funciona de forma diferente a instalarlo en Claude Code.

<div class="section" role="doc-bibliography" aria-label="Fuentes">

### Fuentes

- [Claude Code CHANGELOG, entrada 2.1.285](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code: referencia de comandos de plugins](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code: referencia del manifiesto de plugins, configuración de usuario](https://code.claude.com/docs/en/plugins-reference.md)

</div>





Conoce [Ailoot](https://ailoot.ai/).

## Preguntas sobre Claude

### ¿Por qué configure dice que no encuentra mi plugin instalado?

Usa el identificador completo name@marketplace de `claude plugin list` y comprueba que esté instalado en el ámbito adecuado. Este comando no acepta solo el nombre corto del plugin.

### ¿Cómo compruebo un token cambiado sin imprimirlo?

Ejecuta `claude plugin configure` con el identificador completo y verifica que el campo sensible figure como set. Reinicia Claude Code después de guardar; no añadas al repositorio el JSON de entrada que contiene el token.


## Ailoot · La empresa y su cartera de proyectos

Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI.

La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.

Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.