Desde que Anthropic anunció los Claude Code Mods, el 1 de octubre de 2026, el agente de terminal dejó de ser una caja cerrada: con unas líneas de TypeScript puedes cambiar cómo se ve y, más importante, qué hace antes y después de cada herramienta. En cuatro días el catálogo awesome-claude-code-mods ya tenía 1.740 mods. Esa velocidad dice dos cosas: la gente tenía ganas de meterle mano, y casi nadie estaba revisando lo que instalaba.
Qué es un mod y en qué se diferencia de un hook
Técnicamente, un mod es un plugin de Claude Code con un archivo extra: el módulo de hooks. Ahí escribes funciones en JavaScript o TypeScript, y Claude Code las llama cada vez que pasa algo dentro de la sesión: una herramienta está por ejecutarse, un prompt se va a enviar, una respuesta terminó. Tu función se entera, puede mirar los datos y puede intervenir.
La mejor prueba de que no es un juguete es que Anthropic convirtió tres funciones propias en mods al momento del lanzamiento: el panel de diferencias, el cargador de agents.md y la telemetría. O sea, lo que tú puedes escribir corre al mismo nivel que lo que trae la herramienta de fábrica.
Si venías usando hooks sueltos de shell, la diferencia práctica es el lenguaje y el alcance: un hook clásico dispara un comando, un mod corre código con contexto de la sesión y además puede tocar la interfaz. Por eso aparecieron tantos paneles en vivo, líneas de estado y controles de agente en los primeros días.
Lo mínimo para tener uno andando
Necesitas Claude Code v2.1.287 o posterior. Después, el mod más pequeño que existe son tres archivos:
- ▸.claude-plugin/plugin.json — el nombre y la metadata del plugin.
- ▸hooks/hooks.json — qué eventos te interesan.
- ▸hooks/register.js — las funciones que se ejecutan cuando esos eventos ocurren.
No hay Node aparte, ni bundler, ni paso de build: Claude Code carga los archivos .js y .ts directamente. Eso baja el costo de intentarlo a casi cero, y explica por qué tanta gente escribió el suyo la primera semana.
Para instalar uno ajeno: agregas el marketplace con /plugin marketplace add owner/repo, luego /plugin install nombre@marketplace dentro de la sesión (o claude plugin install nombre@marketplace desde la terminal) y corres /reload-plugins después de instalar o actualizar desde la shell.
Tu primer mod útil: el que te ahorra plata
El error típico es arrancar por el tema de colores. Entretenido, cero impacto. Los mods que de verdad cambian tu día son los que se meten en el evento de "herramienta por ejecutarse", porque ahí está el riesgo y ahí está el gasto. Tres ideas que puedes escribir en una tarde:
- Un guardrail: si el comando que va a correr toca una carpeta sensible o un archivo .env, lo frenas y pides confirmación explícita.
- Un contador: registras tokens y duración por tarea en un archivo local. En una semana sabes qué tipo de pedido te cuesta caro, que es justo lo que después vas a querer optimizar.
- Un inyector de contexto: antes de cada prompt, agregas las convenciones de tu repo o la rama en la que estás, para dejar de repetirlo a mano.
Y hay un atajo que da algo de vértigo pero funciona: describirle a Claude lo que quieres que haga el mod y dejar que escriba los tres archivos. Es el único caso donde el agente se modifica a sí mismo. Léelo antes de aceptar, porque va a correr en tu máquina.
La parte incómoda: estás ejecutando código ajeno
Un mod corre localmente con el mismo acceso que tiene Claude Code a tu computadora. Anthropic lo dice sin rodeos: revisa el código antes de instalar y quédate con editores en los que confíes. Suena obvio hasta que ves catálogos con miles de mods, sin curaduría, y a gente instalando cinco de golpe porque un hilo los recomendó.
Mi regla: si un mod tiene menos de 200 líneas, lo leo entero; si tiene más y no lo escribí yo, no entra en la máquina donde están las credenciales del trabajo.
Este año ya vimos extensiones troyanizadas apuntando a entornos de desarrollo con IA. Un mod es un vector perfecto: corre con tus permisos, ve tus prompts y nadie lo audita. No es razón para no usarlos, es razón para leerlos.
Dónde encaja esto en algo más grande
Escribir mods te obliga a pensar en el agente como un sistema con eventos, permisos y presupuesto, no como un chat que responde bonito. Esa es la misma cabeza que necesitas cuando llevas un agente a producción: interceptar herramientas, decidir qué se bloquea, medir cuánto cuesta cada paso. Si quieres llegar ahí, la ruta de AI Agentic Engineer arma justamente ese criterio, y el curso de agentes con LangGraph te da el equivalente en código: nodos, estado y control del bucle.
Si todavía estás ordenando el uso diario de la herramienta (permisos, subagentes, revisión de cambios), conviene primero el curso de Claude Code y, para entender el ecosistema completo de modelos y planes, la guía de Claude Code y la de Claude que mantenemos actualizadas.
Qué haría yo esta semana
Escribe el contador de tokens. Es el mod más aburrido de todos y el que más te va a servir: en siete días vas a tener datos reales de en qué se te va el presupuesto, y con eso puedes decidir si necesitas cambiar de modelo, recortar contexto o partir tareas. Todo lo demás (temas, paneles, animaciones) se puede esperar.
Si prefieres hacerlo acompañado, en la Comunidad AI Builders armamos este tipo de cosas en los talleres en vivo de cada semana, desde 19 USD al mes. Llevas tu terminal y sales con el mod funcionando.
¿Y si mañana Anthropic cambia la API de hooks? Probable. Por eso vale la pena que tu primer mod sea corto y tuyo: migrar 50 líneas que entiendes toma minutos, migrar un plugin de 2.000 líneas que instalaste a ciegas toma una tarde que no tienes. Mira el catálogo de cursos si quieres el camino completo.



