Mods de Claude Code: instálalos, úsalos y desactívalos con seguridad
Los mods son plugins con function hooks en el proceso que pueden redibujar la interfaz, añadir comandos e interceptar llamadas a herramientas. Esta guía recorre tu primer mod, la lista integrada y los interruptores de apagado — con cada dato verificado contra la documentación oficial.
En resumen
- Los mods son plugins de Claude Code que traen un módulo de hooks — JavaScript que corre dentro del propio Claude Code y puede observar, reescribir o responder a eventos.
- En v2.1.287 o superior los mods funcionan al abrir la caja: instala con /plugin install name@marketplace y el mod queda activo tras reiniciar la sesión.
- El mod integrado You Should Know es opcional: actívalo una vez con /plugin enable cc-plugin-you-should-know@builtin.
- Para renunciar: desactiva un mod concreto en /plugin, arranca con --safe-mode para una sesión, o pon "disableAllHooks": true para mantener todos los mods instalados apagados.
Claude Mods Make Claude Code 10x More Powerful
Canal: Firecrawl4:40
Claude Code v2.1.287 — Claude Mods and Agent Plugins
Canal: Claude Code Changelog2:13
Mods overview — official docs (function hooks)
Docs: code.claude.com/docs
Las capturas provienen de los dos vídeos de arriba; solo se usaron segmentos limpios de pantalla y diapositivas tipográficas del changelog — los fragmentos con presentador se descartaron. Los datos se verificaron contra la documentación oficial de mods, no contra los vídeos.
Las marcas de tiempo enlazan de vuelta con los vídeos originales para que las visitas lleguen a los creadores. Claude Code es una marca de Anthropic; esta guía es independiente y no está afiliada.
Instala y usa tu primer mod de Claude Code
Entender qué es un mod
- 1
Saber qué cambia un mod
Claude Code 2.1.287 introduce los mods: plugins que modifican el comportamiento más profundo del propio agente. Un mod puede reaccionar a eventos de sesión, mantener su propio estado y dibujar directamente en la interfaz — un pequeño programa que extiende tu terminal, no otra instrucción para el modelo.
Las notas de la v2.1.287 presentan los mods como plugins que modifican el comportamiento más profundo dentro de Claude Code.Ver en 0:30 - 2
Coloca los mods entre las demás capas de extensión
Las skills dirigen el comportamiento del modelo, los servidores MCP exponen herramientas externas, los shell hooks ejecutan comandos en eventos del ciclo de vida. Los mods son la cuarta capa: código que corre en el proceso, puede cambiar la interfaz e interceptar eventos antes o después de que ocurran. La chuleta bajo el walkthrough compara las cinco capas.
- 3
Comprueba tu versión de Claude Code
Los mods requieren Claude Code v2.1.287 o superior, donde vienen activados por defecto. Ejecuta claude --version para comprobarlo; si vas atrasado, sigue nuestra guía de actualización de Claude Code y vuelve. Algunos mods pueden pedir versiones aún más nuevas.
Las notas de la v2.1.287 cubren: Claude Mods, el plugin You Should Know, el filtrado de agent view y la gestión de tareas en segundo plano.Ver en 0:09
Instalar uno y verlo correr
- 4
Salta el flag de activación antiguo
Los walkthroughs antiguos te dicen de definir CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 — era la vista previa de acceso anticipado. Desde la 2.1.287 los mods vienen activos y la variable se ignora, así que puedes borrarla de tus ajustes. No hace falta nada más para activar los mods.
- 5
Instala un mod desde un marketplace
Dentro de una sesión: /plugin install mod-name@marketplace; desde tu terminal: claude plugin install mod-name@marketplace y luego /reload-plugins si ya había una sesión abierta. Antes de instalar código de terceros puedes revisarlo con claude plugin validate ./some-mod.
- 6
Lee qué es un mod en realidad
Un mod es un módulo de hooks: una entrada register(on) que suscribe funciones manejadoras a los eventos del motor. Cada manejador recibe la API de mods, el evento y una continuación next() — la forma de un middleware de Express, donde puedes observar, reescribir o responder al evento y luego pasarlo.
El register.tsx de un mod real: un manejador on('ui.render') que redibuja el componente AbovePrompt con una línea extra de texto.Ver en 2:35 - 7
Ejecuta la sesión y verifica
Arranca Claude Code y busca las pruebas: los comandos con barra propios del mod aparecen en la lista de ayuda, y /plugin muestra una línea como "1 mod active" bajo las pestañas. Si no aparece nada, relee las instrucciones del mod — los mods con dibujo solo funcionan en la terminal y en la pestaña Code de la app de escritorio.
El comando /hello en la lista de ayuda viene de un mod instalado — los mods pueden registrar comandos propios de ejecución instantánea sin consumir un turno de Claude.Ver en 2:32
Los mods integrados
- 8
Conoce los mods integrados
Abre /plugin y mira la sección Built-in: cc-plugin-agents-md carga AGENTS.md, cc-plugin-diff alimenta el panel de /diff, cc-plugin-plugin-authoring es la skill de autoría de plugins, cc-plugin-sec-default custodia la política de la organización y cc-plugin-telemetry lleva la analítica. Su código fuente vive en el directorio de mods del repositorio de Claude Code.
- 9
Activa el mod You Should Know
You Should Know es el agente lateral integrado de Claude Code: una vez activado, vigila tu sesión y señala cosas que quizá se te escaparon. Viene desactivado por defecto — actívalo una vez con /plugin enable cc-plugin-you-should-know@builtin y queda activo para las sesiones siguientes.
La tarjeta oficial de you-should-know: un agente lateral que monitoriza tu sesión, activado con /plugin enable cc-plugin-you-should-know@builtin.Ver en 0:48 - 10
Conoce los tres interruptores de apagado
Desactiva un mod concreto en la pestaña Installed de /plugin. Arranca claude --safe-mode para una única sesión sin mods. O pon "disableAllHooks": true en ~/.claude/settings.json para mantener todos los mods instalados apagados hasta que lo reviertas. Los mods integrados siguen corriendo en los tres casos — es a propósito.
Mantén el control
- 11
Respeta el modelo de seguridad
Los mods corren con tus permisos y sin sandbox: pueden leer variables de entorno y secretos, reescribir prompts, preaprobar llamadas a herramientas y gastar tu uso. Instala solo mods que ejecutarías como código plano en tu máquina, y audita con /plugin qué cargó realmente cada sesión.
- 12
Sabe dónde pueden dibujar los mods
La UI de los mods — paneles junto a la transcripción, bandas sobre el prompt, pestañas propias — se renderiza en la terminal y en la pestaña Code de la app de escritorio. No dibuja en sesiones WSL, en el panel de chat de VS Code, en ejecuciones claude -p, en el Agent SDK ni en sesiones cloud, y puede restilar la UI de Claude Code pero jamás el prompt de permisos.
Mods vs plugins vs skills vs MCP vs hooks
Claude Code tiene ahora cinco capas de extensión y los nombres se difuminan rápido. La versión corta — dónde corre el código y qué puede tocar:
- 1Skills son paquetes de instrucciones en markdown que dirigen el comportamiento del modelo al invocarlos — sin ejecutar código propio.
- 2Los servidores MCP conectan herramientas y fuentes de datos externas vía Model Context Protocol — fuera del proceso, expuestos como herramientas.
- 3Los shell hooks son comandos de tus archivos de ajustes que corren en eventos del ciclo de vida, como antes o después de una llamada a herramienta.
- 4Los plugins empaquetan todo lo anterior — comandos, agentes, servidores MCP, hooks — en un paquete instalable.
- 5Los mods son plugins cuyo módulo de hooks corre en el proceso: funciones de TypeScript que pueden redibujar la UI, interceptar eventos en pleno vuelo y guardar estado entre eventos.
Regla práctica: las instrucciones van en skills, las integraciones en MCP, la automatización en shell hooks, el empaquetado en plugins — y cuando necesites cambiar cómo se ve Claude Code en sí o cómo se resuelve un evento, eso es un mod.