Plugins de Claude Code: instala desde un marketplace en un comando
Actualización/ 15 min de lectura
La 2.1.292 instala plugins de un marketplace que no agregaste con un solo comando y deja fijar el esfuerzo de cada subagente. Sintaxis, seguridad y cómo comprobar tu versión.
- IA
- Claude Code
En este artículo (8)
Desde Claude Code 2.1.292, publicada el 6 de octubre de 2026, instalas plugins de un marketplace que todavía no agregaste con un solo comando: claude plugin install <plugin> --marketplace <fuente>. La misma versión deja que Claude corra un subagente al nivel de esfuerzo que pidas. En seguridad trae controles y correcciones, no una función nueva de revisión.
Aquí tienes qué dice exactamente el changelog, la sintaxis de la documentación oficial para la terminal y para una sesión, qué revisa Claude Code antes de agregar un marketplace y qué te toca revisar a ti, cómo fijar el esfuerzo de un subagente y cómo comprobar si tu versión ya trae todo esto. Consultamos el changelog y la documentación el 11 de noviembre de 2026, y al final hay un marketplace de equipo que validamos en local.
Qué cambió en Claude Code 2.1.292 (y qué no)
La entrada de la 2.1.292 en el changelog de Claude Code tiene fecha del 6 de octubre de 2026, y el registro de npm muestra la publicación ese mismo día. Si viste otra fecha: el 7 de octubre salió la 2.1.293. La entrada trae 8 adiciones, 7 cambios, 13 mejoras y 64 correcciones. Estas son las que tocan plugins, marketplaces y subagentes:
| Cambio | Qué dice el changelog | Dónde lo notas |
|---|---|---|
--marketplace <source> en claude plugin install | Agrega el marketplace si hace falta, con los mismos controles de política que claude plugin marketplace add, y luego instala el plugin desde él | Terminal y scripts |
Parámetro effort en la herramienta Agent | Claude corre un subagente al nivel de esfuerzo que le pidas | Dentro de una sesión |
| La política carga primero | Los comandos claude plugin, como marketplace add e install, ya no corren antes de que carguen los ajustes administrados de la organización en el primer uso | Equipos con políticas de plugins |
| Nombres que imitan a los oficiales | Mejores pasos cuando un marketplace declarado en un archivo de ajustes tiene un nombre parecido a uno oficial de Anthropic | Ajustes con marketplaces declarados |
| Nombres de agentes | Máximo 256 caracteres; un name más largo en una skill o en un archivo de plugin se ignora | Autores de plugins |
Dos matices antes de seguir. El campo effort en el archivo de un subagente no es nuevo: la 2.1.267, del 9 de septiembre, ya corregía un fallo de ese campo. Lo nuevo es que Claude pueda pasar el nivel en cada llamada. Y la forma de sesión, /plugin install <plugin> --marketplace <fuente>, llegó antes, en la 2.1.275 del 17 de septiembre; la 2.1.292 lleva lo mismo a la terminal.
Lo que no está: la entrada no agrega ninguna función llamada «revisión de seguridad». Sí trae correcciones de seguridad, que repasamos más abajo, y el comando /security-review sigue en la lista de comandos, pero el changelog de la 2.1.292 no lo menciona.
Instalar plugins con --marketplace en un comando
Hasta ahora, instalar un plugin de un marketplace nuevo eran dos pasos: registrar el catálogo y después instalar con el nombre del marketplace detrás de la arroba. La guía para instalar y administrar plugins describe ahora la versión de un paso. Con el ejemplo que usa la propia documentación:
# Antes: dos comandos
claude plugin marketplace add acme/tools
claude plugin install deploy-helper@acme-tools
# Desde la 2.1.292: uno
claude plugin install deploy-helper --marketplace acme/tools
claude plugin marketplace add acme/toolsregistra el marketplace del repositorio de GitHubacme/tools. Queda registrado con elnameque trae sumarketplace.json, que en este ejemplo esacme-tools, no con el nombre del repositorio.claude plugin install deploy-helper@acme-toolsinstala el plugin. Lo que va después de la arroba es ese nombre del marketplace, y tenías que conocerlo de antemano.claude plugin install deploy-helper --marketplace acme/toolshace las dos cosas. El plugin va solo, sin@marketplace, y la fuente toma las mismas formas quemarketplace add:owner/repode GitHub, una URL de git o una ruta local. Si ya agregaste esa fuente, la reutiliza.
La referencia de comandos de plugins pide la 2.1.292 o posterior para la opción en la terminal. Hay diferencias con la forma de sesión que conviene tener claras:
- En la terminal, el marketplace se agrega sin pedir confirmación. Si es nuevo, imprime
Successfully added marketplace: <name> (declared in user settings)y luego instala, en alcance de usuario si no pasas--scope. - El marketplace queda en tus ajustes de usuario aunque pases
--scope project. El plugin se puede activar para todo el repositorio; el marketplace, por esta vía, no se comparte. - En una sesión (2.1.275 o posterior),
/plugin install deploy-helper --marketplace acme/toolsmuestra la fuente que resolvió y pide confirmar antes de agregarla. Después abre los detalles del plugin para que elijas el alcance. Ahí la fuente no puede llevar espacios.
Desliza la figura para verla completa
Un ejemplo que ya conoces: con las skills oficiales de Anthropic que vale la pena instalar, el flujo era /plugin marketplace add anthropics/skills y después /plugin install document-skills@anthropic-agent-skills. Con la sintaxis de la documentación, desde la terminal quedaría en una línea: claude plugin install document-skills --marketplace anthropics/skills. No lo ejecutamos: nuestra versión local es anterior a la 2.1.292 y la regla de esta prueba era no instalar nada.
Si el marketplace es de tu equipo
Un marketplace es una carpeta o un repositorio con .claude-plugin/marketplace.json. La guía para crear un marketplace y la referencia de marketplace.json piden tres campos: name, owner y plugins, y cada plugin necesita name y source. Este es el que armamos en local, con un plugin dentro:
{
"name": "acme-team-plugins",
"description": "Plugins internos del equipo",
"owner": {
"name": "Equipo de plataforma",
"email": "plataforma@example.com"
},
"plugins": [
{
"name": "revisor",
"source": "./plugins/revisor",
"description": "Subagente revisor y checklist de PR",
"category": "review"
}
]
}
namees lo que la gente escribe después de la arroba. Solo admite letras, dígitos,.,_y-, y no puede ser un nombre reservado comoclaude-plugins-official.descriptiones opcional, peroclaude plugin validateavisa si falta.owneres obligatorio, y sunametambién;emailyurlson opcionales.pluginslleva una entrada por plugin.sourcees una ruta relativa a la raíz del marketplace (la carpeta que contiene.claude-plugin/): empieza con./y no puede llevar...categoryes texto libre para ordenar el catálogo. No pusimosversionen la entrada: va en elplugin.jsondel plugin, que gana si las dos la declaran.
Lo validamos con claude plugin validate ./team-plugins --strict, con la 2.1.238 que tenemos instalada, que ya trae ese comando. La primera vez falló: con --strict, la falta de version en el plugin.json cuenta como error. Al moverla ahí, la salida terminó en ✔ Validation passed. Sin owner, el validador respondió owner: Invalid input: expected object, received undefined, y con ./../plugins/revisor como fuente, Path contains "..". Con eso, la línea para el README del equipo es claude plugin install revisor --marketplace tu-org/tu-repo.
Revisiones de seguridad: qué trae la 2.1.292 y qué te toca a ti
Instalar en un comando también significa que el marketplace se agrega sin una pausa en medio. Por eso importa qué revisa Claude Code y qué no. Esto es lo que trae la 2.1.292 en este terreno:
- Las mismas políticas de organización. Un marketplace nuevo agregado con
--marketplacepasa por la lista de permitidosstrictKnownMarketplacesy la de bloqueadosblockedMarketplaces, igual que conmarketplace add. Según la página para administrar plugins en una organización, esas listas se aplican antes de descargar nada y otra vez al iniciar cada sesión. - La política carga primero. En el primer uso,
marketplace addeinstallya no corren antes de que lleguen los ajustes administrados. - Nombres que imitan a los oficiales. Mejores instrucciones cuando un marketplace declarado en ajustes se parece a uno de Anthropic. Los nombres oficiales, como
claude-plugins-official, solo se aceptan si la fuente está engithub.com/anthropics/. - Correcciones de seguridad. Entre ellas, que las aprobaciones de un hook PreToolUse y el modo automático se saltaban el permiso para leer archivos en rutas de red (UNC), y que los comandos en sandbox podían leer las copias preparadas de las subidas de
/ultrareview.
Lo que no hace es revisar el código del plugin. La página de seguridad y confianza de plugins lo dice en su primera línea: un plugin puede ejecutar código arbitrario en tu máquina con tus privilegios de usuario. Sus hooks, monitores y servidores MCP corren fuera del sandbox, y tus reglas de permisos cubren las llamadas a herramientas que hace Claude, no el código que el plugin corre por su cuenta. La documentación propone revisar cada plugin antes de instalarlo:
- Corre
claude plugin marketplace listpara ver de dónde viene cada marketplace. - En una sesión, abre
/pluginy lee la sección Will install del plugin: comandos, agentes, skills, hooks y servidores MCP y LSP. - Lee el código:
hooks/hooks.json(qué comando corre cada hook),.mcp.json(comando o URL de cada servidor) y todo lo que haya enbin/. - Clona el repositorio y corre
claude --plugin-dir <carpeta> plugin details <nombre>para ver su inventario sin iniciar una sesión.
Con el comando de un paso, esa revisión pasa a ser tuya antes de pegarlo, porque la terminal no te va a preguntar. Si además quieres escanear las skills que trae un plugin, mira cómo escanear skills de agentes con SkillSpector. Y si buscabas revisar la seguridad de tu propio código, eso existe aparte y no cambió en esta versión: /security-review analiza el diff de tu rama, y el plugin security-guidance revisa los cambios mientras Claude escribe.
Subagentes con nivel de esfuerzo
El esfuerzo controla cuánto razona el modelo en cada paso: menos es más rápido y barato, más es más profundo. La página de subagentes personalizados da dos formas de fijarlo para un subagente, y la 2.1.292 agrega la segunda:
- En su definición, con el campo
effortdel frontmatter. Aplica cada vez que el subagente corre. - En la llamada, cuando le pides a Claude que corra un subagente (que no sea un fork) a un nivel concreto. Claude pasa el parámetro
effort, que manda sobre el campo y se mantiene si el subagente se reanuda.
Por encima de los dos está la variable de entorno CLAUDE_CODE_EFFORT_LEVEL. Así queda un subagente revisor con su propio nivel:
---
name: revisor
description: Revisa el diff antes de un PR. Úsalo después de cambios en lógica de negocio.
tools: Read, Grep, Glob
model: sonnet
effort: high
---
Lee los archivos cambiados y reporta errores de lógica, casos límite sin cubrir y pruebas que faltan. No edites archivos.
nameydescriptionson los únicos campos obligatorios. Claude usa la descripción para decidir cuándo delegar.tools: Read, Grep, Globdeja al revisor sin herramientas para editar.model: sonnetelige el modelo; sin este campo, Claude Code sigue su orden de resolución de modelos.effort: highfija el nivel mientras el subagente corre, aunque la sesión esté en otro. Una llamada coneffortlo cambia solo para esa invocación.- El cuerpo, después del segundo
---, es el prompt de sistema del subagente.
Guárdalo en .claude/agents/revisor.md o dentro de un plugin, en agents/: los agentes de un plugin también aceptan effort. Si quieres el paso a paso completo de un revisor de solo lectura, está en el subagente revisor de código en Claude Code.
Los niveles dependen del modelo, según la configuración de modelos. Los modelos Fable, Opus 5.5, Sonnet 5.5, Haiku 5.5 y otros de esa tabla aceptan low, medium, high, xhigh y max; Opus 4.6 y Sonnet 4.6 no tienen xhigh. Si pides un nivel que el modelo no tiene, baja al más alto que sí tenga: xhigh corre como high en Opus 4.6. Para revisar qué pasó, /tasks muestra el modelo de cada subagente y el nivel que le fijaste.
Desliza la figura para verla completa
Sin effort en el archivo ni en la llamada, un subagente en el mismo modelo de la sesión usa el nivel de la sesión. En otro modelo, ese nivel no aplica, y la documentación recomienda fijarlo en el archivo. La tabla de niveles de la documentación sirve de punto de partida: low para cambios chicos que revisas tú, high para arreglar un bug en código existente y max solo para problemas difíciles, porque advierte rendimientos decrecientes y pide probarlo antes de usarlo en todo. Un revisor que lee un diff grande es candidato a high; uno que renombra variables, a low.
Cómo actualizar y comprobar tu versión
Todo lo anterior depende de la versión que tengas. Estos comandos salen de la guía de instalación de Claude Code y de la referencia de comandos; los dos primeros los corrimos en nuestra máquina, que tiene la 2.1.238:
claude --version
claude plugin install --help | grep -- --marketplace
claude update
claude --versionimprime tu versión. Aquí:2.1.238 (Claude Code). Necesitas la 2.1.292 o posterior para--marketplaceen la terminal, y la 2.1.275 para la forma de sesión.claude plugin install --helplista las opciones de tu versión, y elgrepbusca la nueva. En la 2.1.238 no imprimió nada: la ayuda solo trae--config,--scopey--yes. En PowerShell, cambia elgrepporSelect-String -SimpleMatch "--marketplace", que tampoco encontró nada.claude updateinstala la versión más reciente sin esperar a la actualización automática. Según la guía, respondeSuccessfully updated from <old version> to version <new version>oClaude Code is up to date (<version>). No lo corrimos: la regla de esta prueba era no tocar la instalación.
Las instalaciones nativas se actualizan solas en segundo plano. Las de Homebrew y WinGet no, por defecto: ahí se actualiza con brew upgrade claude-code (o claude-code@latest, según el cask) y con winget upgrade Anthropic.ClaudeCode. El ajuste autoUpdatesChannel elige entre "latest", que recibe cada versión al salir, y "stable", que suele ir una semana atrás. Al 11 de noviembre, en npm la etiqueta latest apunta a 2.1.322 y stable a 2.1.311: las dos ya incluyen lo de la 2.1.292. Si algo no cuadra, claude doctor muestra el resultado del último intento de actualización.
Desliza la figura para verla completa
Actualizado el 11 de noviembre de 2026: después de la 2.1.292 hubo más cambios en esta zona. La 2.1.295 (8 de octubre) avisa cuando plugin install o marketplace add escriben en un archivo de ajustes que no carga, y hace que claude plugin validate sugiera una línea de instalación para el README cuando falta. La 2.1.296 (9 de octubre) corrigió en Windows la instalación desde owner/repo sin llave SSH de GitHub. La 2.1.316 (31 de octubre) agregó la variable CLAUDE_CODE_SUBAGENT_EFFORT para el nivel de los subagentes cuando nada más lo fija; todavía no aparece en la página de variables de entorno. Y la 2.1.317 (3 de noviembre) hizo que un subagente en otro modelo use el nivel guardado de ese modelo o su valor por defecto, no el de la sesión.
Errores comunes
- Escribir
plugin@marketplacejunto con--marketplace. Con la opción, el plugin va solo:deploy-helper --marketplace acme/tools. - Usar el nombre del repositorio después de la arroba. El nombre del marketplace sale de su
marketplace.json;acme/toolspuede registrarse comoacme-toolso como cualquier otro. - Probar la opción en una versión vieja. En la terminal pide la 2.1.292. Revisa
claude --versionantes de culpar al marketplace. - Pegar el comando de un README sin leer el plugin. La terminal agrega el marketplace sin preguntar. Revisa el plugin antes, con los pasos de la página de seguridad.
- Esperar que
--scope projectcomparta el marketplace. El marketplace queda en tus ajustes de usuario; cada persona del equipo corre la instalación en su clon. - Escribir la fuente sin
https://.gitlab.example.com/grupo/repo.gitse lee como unowner/repode GitHub y se rechaza. - Poner
../en la fuente de un plugin. Las rutas se resuelven desde la raíz del marketplace, no desde.claude-plugin/, yvalidatelas rechaza. - Poner
effort: maxa todos los subagentes. La documentación lo reserva para problemas difíciles y pide probarlo antes; además,CLAUDE_CODE_EFFORT_LEVELlo pisa.
Preguntas frecuentes
¿Necesito agregar el marketplace antes de usar --marketplace?
No. Esa es la idea de la opción: si no lo tienes, lo agrega y luego instala. Si ya lo agregaste desde la misma fuente, lo reutiliza. Solo necesitas la 2.1.292 o posterior en la terminal, o la 2.1.275 o posterior dentro de una sesión.
¿La 2.1.292 revisa la seguridad de los plugins que instalo?
No revisa su código. Aplica las listas de permitidos y bloqueados de tu organización, rechaza nombres que imitan marketplaces oficiales y trae correcciones de seguridad. Leer los hooks, los servidores MCP y los archivos de bin/ antes de instalar sigue siendo tu trabajo.
¿Cómo le pido a Claude que corra un subagente con otro nivel de esfuerzo?
Pídelo en el prompt, por ejemplo: usa el subagente revisor con esfuerzo low. Desde la 2.1.292, Claude puede pasar ese nivel como parámetro de la llamada, y manda sobre el effort del archivo. Si CLAUDE_CODE_EFFORT_LEVEL está definida, gana ella.
¿Cómo comparto un plugin con todo mi equipo?
Publica el marketplace en un repositorio al que tengan acceso y pon en el README la línea con --marketplace. Para activarlo en un proyecto, instala con --scope project y haz commit de .claude/settings.json; cada persona corre la instalación una vez en su clon.
Checklist
claude --versionmuestra la 2.1.292 o posterior.claude plugin install --helplista--marketplace.- Leíste los hooks, el
.mcp.jsony elbin/del plugin antes de instalarlo. - Sabes desde qué fuente se agregó cada marketplace (
claude plugin marketplace list). - Tu
marketplace.jsonpasaclaude plugin validate --strict. - La
versionestá en elplugin.json, no repetida en la entrada. - Cada subagente tiene un
effortpensado para su tarea, nomaxpor defecto. - Si tu equipo usa políticas, la fuente del marketplace está en
strictKnownMarketplaces.
Si todavía no armaste tu primer subagente, empieza por el revisor de código de solo lectura, paso a paso. Y si buscas qué instalar con el comando nuevo, revisa las skills oficiales de Anthropic para Claude Code.
Para que los plugins no se coman tu cuota, lee por qué se acaba el límite de uso de Claude Code, y para dar contexto al proyecto, cómo funciona AGENTS.md en Claude Code.
¿Viste esto en Instagram? Comenta PLUGINS en el Reel y te mando la guía.
Escrito por

Publicado el 11 de noviembre de 2026 · actualizado el 18 de noviembre de 2026