Qué cambian los mods
La publicación de producto de Anthropic, con fecha del 1 de octubre de 2026, presenta los mods como funciones pequeñas de TypeScript que cambian cómo funciona Claude Code en la CLI y en la aplicación de escritorio. El texto dice que los desarrolladores habían pedido más control sin esperar a que Anthropic publicara una función. Los hooks ya ofrecían parte de ese control. Anthropic dice que los hooks no pueden reescribir eventos, dibujar una interfaz nueva ni sustituir funciones, y que los mods sí pueden. La publicación dice que el diseño se compartió en GitHub antes del lanzamiento para recibir comentarios, y no nombra ningún enlace a esa conversación. Un mod puede reescribir un prompt, añadir interfaz, sustituir una función integrada o añadir un comportamiento nuevo. Se distribuye dentro de un plugin, el paquete que Claude Code ya usa para instalar y compartir extensiones. ClaudeDevs publicó el mismo día que escribes unas líneas de TypeScript o dejas que Claude construya el mod, y luego lo instalas con /plugin en la CLI o en la aplicación de escritorio. Esa publicación termina en la línea «A few examples:». Un seguimiento de ClaudeDevs dice que el equipo usó mods para /diff y para la compatibilidad con AGENTS.md, y que se están añadiendo mods de ejemplo ya hechos al repositorio Claude Code Playground.
La publicación de producto dice que cada cosa que hace Claude Code emite un evento. Sus ejemplos son una llamada a una herramienta, una solicitud de permiso y el dibujo de una parte de la pantalla. Un mod engancha ese evento antes, después, en su lugar, o envolviéndolo para que el código corra antes y después. Una sola función puede reescribir un prompt antes de que llegue al modelo, bloquear, reescribir o reintentar una llamada a una herramienta, aprobar o denegar una solicitud de permiso, o ocultar los secretos de la salida de una herramienta antes de que Claude la lea. Los eventos de la guía de inicio también incluyen el prompt enviado, el comienzo y el fin de un turno, el comienzo y el fin de una sesión, los comandos con barra, y ui.render a medida que se dibuja cada pieza de la interfaz. En esa guía, los hooks forman una cadena, como un middleware. Un hook observa llamando a next y leyendo lo que vuelve, reescribe llamando a next con un evento cambiado, o responde sin llamar a next, por ejemplo devolviendo un deny. Un mod puede dirigirse a la terminal, a la aplicación de escritorio o a ambas. Cuando varios mods enganchan el mismo evento, se ejecutan en el orden de carga. El primero que se cargó ve el evento antes que los demás y ve el resultado después de que ellos hayan corrido. Así se apilan mods de autores distintos.
La formulación de la guía de inicio sobre el aislamiento es que el módulo corre en un sandbox propio, sin DOM y sin Node, de modo que todo lo de fuera pasa por la API de host $. La frase de la publicación de producto de que los mods no están aislados en un sandbox significa el mismo acceso a tu máquina que Claude Code, alcanzado a través de esa API. Instala solo desde una fuente de confianza. La guía dice que el módulo es JavaScript o TypeScript y permanece cargado durante la sesión. Un hook de settings ejecuta un comando de shell por cada evento y pasa JSON por stdin y stdout. Un mod se carga una vez, puede guardar estado, puede dibujar una interfaz que se actualiza y puede volver a llamar a Claude Code.
Quién puede usarlos y con qué controles
La guía de inicio exige Claude Code 2.1.287 o posterior. Los mods están activados de forma predeterminada, y la API puede cambiar entre versiones. Cada carga escribe las declaraciones de tipos de esa compilación en .claude-plugin/types/, que la guía llama la autoridad para tu versión. El changelog de Claude Code registra la incorporación en una línea: «Added Claude Mods: plugins may now modify deeper behavior.» El mínimo de 2.1.287 sale de la guía de inicio. La publicación de producto, la guía y el changelog no indican un precio para los mods. La publicación de producto nombra la CLI y la aplicación de escritorio.
Los controles de permitir y bloquear del marketplace de plugins siguen vigentes. Un propietario de Team o Enterprise los fija en la consola de administración. En los planes de Claude API y de API de terceros, los administradores envían managed settings a las máquinas de los usuarios. En los planes Team y Enterprise, y en cualquier máquina con managed settings, un mod integrado llamado sec-default («security default») se carga primero. Impide que los mods instalados por el usuario hagan acciones de riesgo, como anular las reglas de denegación de permisos. La publicación de producto dice que puedes ver el código fuente de lo que restringe, y deja esa lista en el código fuente. Los administradores pueden cargar primero sus propios mods y se les indica que mantengan sec-default en la lista. El /diff integrado ahora se distribuye como un mod que puedes apagar en /plugin o sustituir. La guía dice que la compatibilidad con AGENTS.md y el panel de /diff son mods, con el código y las pruebas en el repositorio público anthropics/claude-code, bajo mods/. Anthropic planea pasar más funciones integradas a mods con el tiempo. Los ejemplos para equipos en la publicación de producto son un panel de estado de CI/CD, una confirmación antes de que un comando toque la configuración de producción, y un registro de auditoría de un mod que se carga primero. Esa confirmación de producción es un boceto. El ejemplo Blast Radius de la guía es la comprobación de comandos ya elaborada, y ahí una coincidencia de texto es una red de seguridad, con las reglas de permisos como el bloqueo firme.
Cómo probar uno
La publicación de producto dice que los mods están disponibles hoy. Instala un plugin que los incluya desde el directorio de Claude, o ejecuta /plugin en la CLI. Pide a Claude que cree un mod y puede escribir el TypeScript, instalarlo y recargarlo en caliente en la sesión. La guía dice que ese atajo se carga solo en la sesión actual y que la carpeta se limpia más tarde. Para conservarlo, copia la carpeta fuera e instálala como plugin. La guía también dice que no se instala nada hasta que ejecutas el comando de instalación, y que debes leer antes el repositorio de quien lo publica, porque el mod es código escrito por quien lo publica, con el acceso de Claude Code.
Dentro de una sesión, la secuencia de la guía es /plugin marketplace add, /plugin install y /reload-plugins. Desde la shell, la guía documenta claude plugin marketplace add, claude plugin install, claude plugin validate y claude plugin test. Confirma la compilación con claude --version. El primer ejemplo elaborado de la guía, Token Weather, tiene unas 80 líneas. Llama a $.session.usage() después del inicio de la sesión y después de los turnos del main-loop, lee las mismas cifras que la línea de estado y dibuja un pronóstico de una línea encima del prompt. La guía dice que esa llamada es gratuita salvo que pidas un desglose del recuento de tokens. También dice que guardes las lecturas en $.state, porque una recarga en caliente reinicia las variables del módulo. Sus fotogramas de demostración muestran la banda al 18%, luego al 67% y luego al 81% de una ventana de 200k.
La guía recorre después dos mods más grandes. Blast Radius retiene una llamada de Bash que clasifica como rm -rf, git reset --hard, git clean, un force push o una migración de base de datos, y luego ofrece Proceed y Cancel. En la ilustración de la guía retiene rm -rf build y lista 9 archivos (1.1 MB). La guía lo llama una red de seguridad que lee el texto del comando, así que la sustitución de comandos, los alias y los scripts que llaman a rm la atraviesan. Las reglas de permisos son las que dan un bloqueo firme. La guía dice que un hook dispone de 10 segundos de su propio tiempo por despacho, y que el tiempo de espera dentro de una llamada a $ no cuenta. Blast Radius usa esa regla para esperar en llamadas cortas a sleep hasta que el usuario elige. Replay Theater registra Edit y Write durante un turno del main-loop, lee el archivo antiguo con $.fs.read antes de que un Write se aplique, y no bloquea ni cambia la edición. Una pista ofrece entonces r o /replay para recorrer los diff de ese turno. La ilustración de la guía es un renombrado de cinco ediciones en tres archivos.
| Contexto usado | Pronóstico |
|---|---|
| Menos del 25% | Clear |
| 25–49% | Cloudy |
| 50–74% | Showers |
| 75–89% | Storm |
| 90% o más | Compact soon |
Qué dejan abierto las dos páginas oficiales
Compartir se describe de dos maneras. La publicación de producto dice que empaquetes el mod en un plugin y lo envíes al directorio de Claude. La guía de inicio dice que el envío en claude.ai/directory/manage estará disponible cuando el directorio de Claude acepte plugins que incluyan mods. Ninguna de las dos fuentes fecha ese cambio. ClaudeDevs dice que se están añadiendo mods de ejemplo al repositorio Claude Code Playground. La publicación de producto y la guía de inicio no nombran ese repositorio.
Fuente
También de
Fuentes y criterio editorial
Este artículo se apoya en el anuncio de ClaudeDevs y en el seguimiento sobre mods de ejemplo, ambos publicados el 1 de octubre de 2026, en la publicación de producto de Anthropic Customize Claude Code with mods (fechada el 1 de octubre de 2026), en la guía de claude.dev Getting started with Claude Code mods y en el changelog de Claude Code, a fecha de 1 de octubre de 2026. Los ejemplos de llamada a herramienta, solicitud de permiso y dibujo de pantalla proceden de la publicación de producto. La llamada $.session.usage() y el presupuesto de 10 segundos del hook proceden de la guía de inicio. La línea del changelog sobre Claude Mods no nombra una versión. La guía nombra 2.1.287 como mínimo. Una referencia aparte de la API de mods y el repositorio Claude Code Playground no se tratan aquí. La publicación de producto, la guía y el changelog no indican un precio para los mods.