Personaliza Claude Code con mods

Hoy presentamos mods, pequeñas funciones de TypeScript que cambian la forma en que funciona Claude Code. Un mod puede reescribir un prompt, añadir una nueva interfaz de usuario, sustituir una función nativa o añadir una funcionalidad completamente nueva. Puedes escribir un mod tú mismo o pedirle a Claude Code que lo haga por ti. Los mods se incluyen dentro de los plugins, así que los instalas y compartes como cualquier plugin. Funcionan en la CLI de Claude Code y en la aplicación de escritorio.

Los mods se ejecutan con el mismo acceso a tu máquina que el propio Claude Code. No están en un entorno aislado y solo deberías instalar mods de fuentes de confianza, de la misma forma en que instalarías cualquier programación en tu ordenador.

Para ver lo que pueden hacer los mods, lee nuestra guía para crear tu primer mod.

Por qué creamos mods

Los desarrolladores nos han pedido más control sobre cómo funciona Claude Code, sin esperar a que lancemos una función. Los hooks ayudaron a dar a los usuarios parte de este control, pero los hooks no pueden volver a escribir eventos, dibujar nuevas interfaces de usuario ni sustituir funciones. Los mods pueden hacerlo.

Queremos que Claude Code se sienta como tuyo, para que puedas adaptarlo a tu forma de trabajar. Compartimos el diseño de los mods en GitHub antes del lanzamiento para obtener comentarios de los desarrolladores. Gracias a todos los que dieron su opinión.

Cómo funcionan los mods

Cada vez que Claude Code hace algo, emite un evento. Por ejemplo, llamar a una herramienta, pedir permiso y dibujar parte de la pantalla. Un mod es una función que se vincula a uno de estos eventos. Un mod puede ejecutarse antes, después o en lugar de un evento. También puede finalizar el evento, ejecutando código antes y después. Con una función, un mod puede:

• Reescribe un prompt antes de que llegue al modelo.
• Bloquea, reescribe o vuelve a intentar una llamada a una herramienta.
• Aprueba o deniega una solicitud de permiso.
• Redacta los secretos de los resultados de la herramienta antes de que Claude los lea.

Un mod también puede cambiar lo que ves. Puede editar o sustituir parte de la interfaz que Claude Code dibuja, como el resultado de una herramienta o una pregunta de Claude. Puede añadir botones y entradas, y otros mods pueden responder cuando los pulses. Hoy en día, un mod puede dirigirse al terminal, a la aplicación de escritorio o a ambos.

Cuando varios mods se conectan al mismo evento, se ejecutan en el orden en que se cargan. El primer mod que se carga ve el evento primero y el resultado por último. Esto te permite apilar mods de diferentes autores.

También puedes usar Claude Code para modear Claude Code. Pide a Claude que cree un mod y podrá escribir el TypeScript, instalarlo y recargarlo en directo en tu sesión.

Cambia las funciones integradas por las tuyas

Algunas funciones nativas de Claude Code ahora se incluyen como mods. Por ejemplo, la función nativa /diff es ahora un mod, así que puedes desactivarla (en /plugin) o reemplazarla por tu propia versión. Tenemos previsto trasladar más funciones nativas a mods con el tiempo, para que puedas reducir Claude Code a un núcleo pequeño y añadir solo lo que quieras.

Mods para equipos y empresas

Los mods se incluyen dentro de plugins, por lo que se aplican tus controles de plugin existentes. Los administradores pueden permitir o bloquear los mercados de plugins. En los planes Team y Enterprise, el propietario configura esto en la consola de administración. En los planes de Claude API y de API de terceros, los administradores envían la configuración gestionada a los equipos de los usuarios.

En los planes Team y Enterprise, y en cualquier máquina con configuración administrada, se carga primero un mod integrado llamado sec-default («seguridad por defecto»). Evita que los mods que los usuarios instalan hagan cosas arriesgadas, como anular tus reglas de denegación de permiso. Puedes ver el código fuente para ver qué restringe. En su lugar, los administradores pueden cargar primero sus propios mods. Si lo haces, añade sec-default a tu lista para mantener sus restricciones.

Los equipos también pueden usar mods para crear sus propios controles y funciones. Por ejemplo:

• Estado de CI/CD: un mod puede mostrar el estado de tu canalización en un panel al lado de la conversación y actualizarla a medida que las compilaciones se aprueban o fallan.
• Salvaguardas de producción: un mod puede requerir confirmación antes de que cualquier comando afecte a la configuración de producción.
• Registro de auditoría: un mod que se carga primero puede registrar cada llamada que haga cualquier otro mod.

Primeros pasos

Los mods están disponibles hoy en la CLI de Claude Code y en la aplicación de escritorio. Instala plugins que incluyan mods desde el directorio de Claude o ejecutando /plugin en la CLI. Para compartir un mod, empaquétalo en un plugin y envíalo al directorio.

Para crear tus propios mods, lee nuestra guía de introducción o consulta la documentación.