Claude Code ya se puede modificar desde dentro: cómo escribir tu primer mod en TypeScript, y por qué corre con todos tus permisos

De personalizar la herramienta a reescribirla desde dentro

Hasta el 1 de octubre de 2026, personalizar Claude Code significaba ajustar su configuración, escribir instrucciones persistentes en un archivo CLAUDE.md, conectar servidores MCP o definir hooks que se disparan en momentos concretos. Todo eso seguía dejando el comportamiento central del agente intacto: se le podía dar más contexto o engancharle acciones puntuales, pero no se podía cambiar cómo decide qué hacer en cada paso. Los mods, introducidos con la versión 2.1.287 de Claude Code, cambian esa relación: son funciones de JavaScript o TypeScript que se insertan directamente en el flujo de ejecución del agente y pueden interceptar llamadas a herramientas, reescribir instrucciones sobre la marcha y dibujar su propia interfaz, en lugar de limitarse a observar desde fuera.

Cómo funcionan por dentro: todo es un evento

El mecanismo es sencillo de describir aunque profundo en sus implicaciones: cada vez que Claude Code hace algo —lee un archivo, llama a una herramienta, genera una respuesta—, emite un evento, y un mod es una función que se registra para reaccionar a esos eventos. Varios mods de autores distintos pueden apilarse sobre los mismos eventos sin pisarse entre sí, lo que permite combinar extensiones de orígenes diferentes en una misma sesión. La forma más directa de empezar no requiere ni siquiera escribir el código a mano: se puede pedirle al propio Claude Code que construya un mod a partir de una descripción de lo que se quiere conseguir, y revisarlo después como se revisaría cualquier otro fragmento de código generado por el modelo.

Dónde funcionan de verdad, y dónde solo a medias

Un matiz técnico importante antes de construir algo que dependa de una interfaz visual propia: la parte de un mod que dibuja elementos en pantalla solo se renderiza en la terminal y en la pestaña «Code» de la aplicación de escritorio, que son los dos entornos donde ese tipo de interfaz tiene sentido. La parte lógica de un mod —los hooks que reaccionan a eventos— sí sigue activa en la extensión de VS Code, en el modo no interactivo claude -p, en el Agent SDK y en las sesiones en la nube, pero sin ningún componente visual en esos entornos. Para compartir un mod con otras personas, el canal es el mismo que para cualquier otro plugin: se empaqueta como plugin y se publica en el directorio de Claude, o se instala directamente con el comando /plugin en la CLI apuntando a un repositorio propio.

Anthropic ya ha convertido varias funciones propias de Claude Code en mods, en lugar de dejarlas como parte del núcleo fijo de la herramienta —entre ellas el panel de diferencias /diff, un conjunto de configuraciones de seguridad por defecto y el sistema de telemetría—, y ha dicho abiertamente que planea trasladar más funciones integradas a este mismo mecanismo con el tiempo, con la idea de reducir Claude Code a un núcleo pequeño al que cada persona añade solo lo que necesita.

El riesgo que conviene no pasar por alto

Aquí está el matiz de seguridad que cualquier guía rápida sobre esta función debería mencionar con la misma claridad que sus posibilidades creativas. Los mods se ejecutan con exactamente el mismo nivel de acceso a la máquina que tiene el propio Claude Code: pueden leer archivos, ejecutar comandos y actuar sobre el sistema igual que lo haría una sesión normal del agente. Están activados por defecto desde la versión 2.1.287, sin ninguna bandera adicional que haya que activar a propósito, y no existe un proceso de revisión de código para los mods que se publican en el directorio: cualquiera puede escribir uno y compartirlo. El único límite que Anthropic ha impuesto de forma explícita es que un mod no puede modificar el propio aviso de permisos que pide confirmación antes de una acción sensible; fuera de ese límite concreto, el resto del comportamiento del agente queda abierto a modificación.

En las primeras horas tras el lanzamiento, la comunidad ya había publicado mods que van desde utilidades serias —un panel que resume información clave que podría pasar desapercibida en la salida del modelo— hasta experimentos puramente lúdicos, como un reproductor de vídeo en ASCII dentro de la propia terminal o un juego multijugador pensado para esperar mientras Claude Code termina una tarea larga. Esa misma variedad demuestra, de paso, hasta dónde llega el acceso real que tiene un mod: no es una capa decorativa, es código que corre con plenos permisos sobre la máquina de quien lo instala.

Cómo empezar sin asumir un riesgo innecesario

La recomendación más sensata para una primera toma de contacto es revisar y probar uno de los mods oficiales ya incluidos en el repositorio público de Claude Code antes de instalar cualquier mod de un tercero desde el directorio comunitario. Igual que con cualquier otro código que se vaya a ejecutar con permisos amplios sobre el propio equipo, conviene leer lo que hace un mod —o pedirle a Claude que lo explique si no es evidente a simple vista— antes de activarlo, en lugar de asumir que viene con alguna garantía de seguridad implícita por estar listado en el directorio oficial.

Por qué importa hoy

Para cualquier persona que ya use Claude Code a diario y sienta que sus flujos de trabajo chocan con límites del comportamiento por defecto de la herramienta, los mods abren una vía real para resolver ese problema sin esperar a que Anthropic publique una función equivalente. El primer paso razonable, antes de escribir un mod propio desde cero, es explorar los que Anthropic ya ha publicado como ejemplo en su repositorio, entender cómo enganchan los eventos del agente, y a partir de ahí decidir si merece la pena construir uno propio o pedirle directamente a Claude Code que lo haga.