Mods de Claude Code: qué son y cómo crear el primero
· 5 min de lectura
Los Mods de Claude Code son plugins hechos de funciones en JavaScript o TypeScript que corren dentro de Claude Code y cambian cómo se ve y cómo se comporta. Salieron el 1 de octubre de 2026 en la versión 2.1.287. Se crean describiéndolos a Claude en una sesión, sin Node ni compilación, y no tienen sandbox.
Qué es un mod de Claude Code
Un mod es un plugin que registra funciones (la documentación los llama hooks) en JavaScript o TypeScript, y esas funciones corren dentro de Claude Code. Esa es la diferencia con lo que ya existía: los hooks de configuración, las skills, la status line y los servidores MCP trabajan desde fuera. Por eso el mod es el único que puede dibujar en la interfaz.
Salieron en la versión 2.1.287, publicada el 1 de octubre de 2026. En la terminal necesitas esa versión o una posterior; en la pestaña Code de la app de escritorio funcionan desde la 2.1.286. Vienen activados por defecto.
Qué puede hacer un mod
La documentación muestra tres familias de usos:
Dibujar en la interfaz. Un panel lateral a la derecha, una banda encima del prompt, una línea de estado debajo, avisos tipo toast y líneas en el historial. También puede redibujar partes de Claude Code, como los mensajes o el spinner.
Hablar con otras sesiones. Con `$.session.send({ to, text })` un mod manda un mensaje de texto a otra de tus sesiones, igual que la herramienta SendMessage.
Llamar a otro modelo. `$.model.complete` manda un solo prompt, sin historial, con las credenciales de tu sesión. El ejemplo oficial usa `model: 'haiku'` para un trabajo pequeño, como clasificar o resumir un texto.
Cómo crear tu primer mod
Actualiza Claude Code a la 2.1.287 o posterior.
En una sesión interactiva, descríbele a Claude el mod que quieres. Por ejemplo: «un contador de herramientas usadas junto al spinner». Claude usa la skill integrada `plugin-authoring` (también la puedes cargar con `/plugin-authoring`).
Claude lo escribe en `~/.claude/dev-mods/` y te pregunta si activas la recarga en caliente. Desde ahí, el mod se recarga al final de cada turno que lo cambia.
Si te gusta, guárdalo: un mod escrito así vive solo en esa sesión. Cópialo a una carpeta y cárgalo con `claude --plugin-dir`, o publícalo en un marketplace e instálalo con `/plugin install`.
No necesitas Node, ni bundler, ni compilar: Claude Code carga los archivos `.js` y `.ts` directamente.
Qué puede salir mal
Este es el apartado que casi nadie lee y el más importante:
No tienen sandbox. Un mod corre con tus permisos: lee y escribe tus archivos, arranca procesos y hace peticiones de red.
Puede aprobar herramientas que una regla de «preguntar» te habría consultado.
Puede gastar tu uso, porque las llamadas a modelos van contra tu plan o tu API key.
Fuera de la terminal y de la app de escritorio no dibuja. En `claude -p`, en la extensión de VS Code y en el Agent SDK los hooks corren, pero no se ve nada. Un mod que te escribió Claude ni siquiera carga sin alguien delante.
La API puede cambiar entre versiones.
Antes de instalar un mod ajeno, `claude plugin validate ./el-mod` te muestra qué eventos escucha y qué funciones llama sin ejecutarlo. Si algo se porta raro, `--safe-mode` apaga los mods en la sesión y `"disableAllHooks": true` apaga los que instalaste en todas las sesiones. Lo que un mod no puede cambiar es lo que muestra el aviso de permisos.
Preguntas frecuentes
¿Necesito saber programar para crear un mod de Claude Code?
No. La documentación oficial indica que basta con describir el mod en una sesión interactiva de Claude Code y Claude lo escribe usando la skill integrada plugin-authoring. No hace falta Node, bundler ni compilación, porque Claude Code carga los archivos .js y .ts directamente.
¿Desde qué versión de Claude Code funcionan los Mods?
Los Mods llegaron en la versión 2.1.287 de Claude Code, publicada el 1 de octubre de 2026. En la terminal hace falta esa versión o una posterior, y en la pestaña Code de la app de escritorio funcionan desde la 2.1.286. Vienen activados por defecto.
¿Es seguro instalar mods de otras personas?
Hay que tener cuidado: los Mods no tienen sandbox y corren con tus permisos, así que pueden leer y escribir archivos, arrancar procesos, hacer peticiones de red y gastar tu uso del plan. Antes de instalar uno ajeno conviene revisarlo con claude plugin validate, que muestra qué eventos escucha y qué funciones llama sin ejecutarlo.
¿Los Mods funcionan en claude -p o en VS Code?
Solo a medias. En claude -p, en la extensión de VS Code y en el Agent SDK los hooks de un mod corren, pero no se dibuja nada en pantalla. Además, un mod que Claude escribió en una sesión no carga sin una persona delante, como en claude -p o en modo dontAsk.