Saltar al contenido

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)
  1. Qué cambió en Claude Code 2.1.292 (y qué no)
  2. Instalar plugins con --marketplace en un comando
  3. Revisiones de seguridad: qué trae la 2.1.292 y qué te toca a ti
  4. Subagentes con nivel de esfuerzo
  5. Cómo actualizar y comprobar tu versión
  6. Errores comunes
  7. Preguntas frecuentes
  8. Checklist

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:

CambioQué dice el changelogDónde lo notas
--marketplace <source> en claude plugin installAgrega el marketplace si hace falta, con los mismos controles de política que claude plugin marketplace add, y luego instala el plugin desde élTerminal y scripts
Parámetro effort en la herramienta AgentClaude corre un subagente al nivel de esfuerzo que le pidasDentro de una sesión
La política carga primeroLos 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 usoEquipos con políticas de plugins
Nombres que imitan a los oficialesMejores pasos cuando un marketplace declarado en un archivo de ajustes tiene un nombre parecido a uno oficial de AnthropicAjustes con marketplaces declarados
Nombres de agentesMáximo 256 caracteres; un name más largo en una skill o en un archivo de plugin se ignoraAutores 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
  1. claude plugin marketplace add acme/tools registra el marketplace del repositorio de GitHub acme/tools. Queda registrado con el name que trae su marketplace.json, que en este ejemplo es acme-tools, no con el nombre del repositorio.
  2. claude plugin install deploy-helper@acme-tools instala el plugin. Lo que va después de la arroba es ese nombre del marketplace, y tenías que conocerlo de antemano.
  3. claude plugin install deploy-helper --marketplace acme/tools hace las dos cosas. El plugin va solo, sin @marketplace, y la fuente toma las mismas formas que marketplace add: owner/repo de 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/tools muestra 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.
instalar un plugin de un marketplace que aún no agregasteantes · dos comandosclaude plugin marketplace add acme/toolsregistra el catálogo; su nombre sale del marketplace.jsonclaude plugin install deploy-helper@acme-toolsahora · un comando (2.1.292, terminal)claude plugin install deploy-helper --marketplace acme/toolsagrega el marketplace si falta, con las mismas políticas, e instalaen una sesión (2.1.275+), muestra la fuente y pide confirmar:/plugin install deploy-helper --marketplace acme/toolsla terminal no pide confirmación; la sesión sífuente: changelog 2.1.292 (6 oct 2026) y docs de instalación de plugins

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"
    }
  ]
}
  1. name es lo que la gente escribe después de la arroba. Solo admite letras, dígitos, ., _ y -, y no puede ser un nombre reservado como claude-plugins-official.
  2. description es opcional, pero claude plugin validate avisa si falta.
  3. owner es obligatorio, y su name también; email y url son opcionales.
  4. plugins lleva una entrada por plugin. source es una ruta relativa a la raíz del marketplace (la carpeta que contiene .claude-plugin/): empieza con ./ y no puede llevar ...
  5. category es texto libre para ordenar el catálogo. No pusimos version en la entrada: va en el plugin.json del 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 --marketplace pasa por la lista de permitidos strictKnownMarketplaces y la de bloqueados blockedMarketplaces, igual que con marketplace 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 add e install ya 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á en github.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:

  1. Corre claude plugin marketplace list para ver de dónde viene cada marketplace.
  2. En una sesión, abre /plugin y lee la sección Will install del plugin: comandos, agentes, skills, hooks y servidores MCP y LSP.
  3. 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 en bin/.
  4. 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 effort del 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.
  1. name y description son los únicos campos obligatorios. Claude usa la descripción para decidir cuándo delegar.
  2. tools: Read, Grep, Glob deja al revisor sin herramientas para editar.
  3. model: sonnet elige el modelo; sin este campo, Claude Code sigue su orden de resolución de modelos.
  4. effort: high fija el nivel mientras el subagente corre, aunque la sesión esté en otro. Una llamada con effort lo cambia solo para esa invocación.
  5. 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.

qué nivel de esfuerzo darle a cada subagentenivelpara qué tareadefault enlowcambios chicos que revisas tú: un rename—mediumtrabajo diario con alcance claroOpus/Sonnet/Haiku 5.5higharreglar un bug en código existenteotros modelosxhighrazonamiento más profundo, más tokensOpus 4.7maxproblemas difíciles: buscar vulnerabilidades—quién manda: gana el primeroCLAUDE_CODE_EFFORT_LEVEL>effort de la llamada (2.1.292)>effort del archivosin ninguno: en el modelo de la sesión, usa el nivel de la sesiónlos niveles disponibles dependen del modelofuente: docs de model-config y sub-agents, consultadas el 11 nov 2026

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
  1. claude --version imprime tu versión. Aquí: 2.1.238 (Claude Code). Necesitas la 2.1.292 o posterior para --marketplace en la terminal, y la 2.1.275 para la forma de sesión.
  2. claude plugin install --help lista las opciones de tu versión, y el grep busca la nueva. En la 2.1.238 no imprimió nada: la ayuda solo trae --config, --scope y --yes. En PowerShell, cambia el grep por Select-String -SimpleMatch "--marketplace", que tampoco encontró nada.
  3. claude update instala la versión más reciente sin esperar a la actualización automática. Según la guía, responde Successfully updated from <old version> to version <new version> o Claude 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.

los comandos de plugins que vas a usar, y desde qué versióncomandoqué hacedesdeclaude --versionmuestra tu versión—claude updateactualiza ya, sin esperar—claude plugin marketplace add <src>registra un catálogo—claude plugin install <p>@<mkt>instala de un catálogo agregado—claude plugin install <p> --marketplace <src>agrega el catálogo e instala2.1.292/plugin install <p> --marketplace <src>igual en sesión, pide confirmar2.1.275claude plugin validate <path>valida marketplace y plugins—claude plugin marketplace remove <name>lo quita con sus plugins—en la terminal, --marketplace pide la 2.1.292 o posterior— = ya existía antes · claude plugin install --help lista tus opciones

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@marketplace junto 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/tools puede registrarse como acme-tools o como cualquier otro.
  • Probar la opción en una versión vieja. En la terminal pide la 2.1.292. Revisa claude --version antes 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 project comparta 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.git se lee como un owner/repo de 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/, y validate las rechaza.
  • Poner effort: max a todos los subagentes. La documentación lo reserva para problemas difíciles y pide probarlo antes; además, CLAUDE_CODE_EFFORT_LEVEL lo 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 --version muestra la 2.1.292 o posterior.
  • claude plugin install --help lista --marketplace.
  • Leíste los hooks, el .mcp.json y el bin/ del plugin antes de instalarlo.
  • Sabes desde qué fuente se agregó cada marketplace (claude plugin marketplace list).
  • Tu marketplace.json pasa claude plugin validate --strict.
  • La version está en el plugin.json, no repetida en la entrada.
  • Cada subagente tiene un effort pensado para su tarea, no max por 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

Luis Morales

Luis Morales

Desarrollador frontend y Shopify, EcomLabs

@luismoralesdev en Instagram

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

← Blog