Qué es un mod
La documentación de Anthropic comienza con una definición: "Un mod es un plugin que cambia la apariencia y el comportamiento de Claude Code".
Un mod es código. "Está compuesto por manejadores de eventos (event handlers) en JavaScript o TypeScript: Claude Code llama a uno cuando ocurre un evento, como una llamada a una herramienta, un prompt enviado o una parte de la interfaz que se está dibujando, y el manejador puede observar el evento, cambiarlo o tomar el control".
La documentación llama a esos manejadores hooks, lo cual puede ser confuso, porque Claude Code ya tiene hooks que configuras en un archivo de ajustes. En las páginas de mods, Anthropic llama al tipo de archivo de configuración un settings hook. La diferencia es dónde se ejecutan: "Los manejadores de un mod son funciones que se ejecutan dentro de Claude Code en su lugar".
Un mod pequeño consta de tres archivos: un manifiesto del plugin, un hooks.json que apunta al código y un archivo de código que registra los manejadores.
Qué puede hacer un mod
Debido a que un mod se ejecuta dentro de Claude Code, Anthropic enumera cosas que puede hacer y que los settings hooks, skills, líneas de estado y servidores MCP no pueden:
- Dibujar una interfaz que puedas usar, como un panel al lado de la transcripción o una banda sobre el prompt, con pestañas, botones y campos de texto.
- Redibujar la propia interfaz de Claude Code, como la fila de una llamada a herramienta, el indicador de carga (spinner) o el diálogo donde Claude hace preguntas.
- Intervenir en una llamada a herramienta o una solicitud, por ejemplo, retener una llamada a herramienta mientras se te hace una pregunta, o enviar una solicitud a un modelo diferente.
- Ejecutar tu propio código en un comando, un
/commandque se ejecuta al instante, sin un turno de Claude, incluso mientras Claude está trabajando. - Compartir datos entre hooks, para que un hook pueda registrar algo y otro pueda mostrarlo.
Algunas de las propias funciones de Claude Code están construidas como mods. La lista integrada incluye /diff y un mod integrado que "carga AGENTS.md como instrucciones del proyecto". Puedes ver los mods integrados en la pestaña Installed de /plugin, pero "no puedes actualizar ni desinstalar un mod integrado".
Cómo se diferencian los mods de los settings hooks, skills, plugins y servidores MCP
Plugins. Un mod no es algo separado de un plugin. Se instala como un plugin, desde un marketplace, y un plugin puede contener un mod junto con skills, comandos, agentes y servidores MCP.
Settings hooks. Un settings hook es un comando de shell, una solicitud HTTP o un prompt que Claude Code ejecuta en un evento del ciclo de vida. Puede permitir, bloquear o cambiar una llamada a herramienta o un prompt, y añadir contexto para Claude, pero no puede dibujar nada. Cubrimos los settings hooks, y cuáles pueden añadir contexto, en nuestra guía sobre qué son los Claude Code hooks.
Skills. Una skill es un archivo SKILL.md con instrucciones que Claude lee. Cambia lo que Claude sabe y hace, no lo que hace Claude Code.
Servidores MCP. Un servidor MCP le da a Claude herramientas para conectarse a un sistema externo.
La comparación de Anthropic resume cuándo elegir un mod: cuando quieras un panel, una banda sobre el prompt, un comando personalizado o reescribir un evento. Si un settings hook, una skill o un servidor MCP ya hace lo que necesitas, la documentación sugiere compararlos antes de escribir un mod.
Instalar un mod y decidir si confiar en él
Instalas un mod de la misma manera que instalas cualquier plugin: ejecuta /plugin install con el nombre del plugin, una @ y el nombre del marketplace en una sesión. Si lo instalas desde tu shell mientras una sesión está abierta, ejecuta /reload-plugins para cargarlo.
Anthropic también comparte mods de ejemplo en un repositorio público, como uno que dibuja un pronóstico de tu ventana de contexto sobre el prompt y otro que retiene un comando de shell arriesgado y muestra qué cambiaría.
Antes de instalar, toma en serio la advertencia. "Un mod es código que se ejecuta con tus permisos". La documentación enumera a qué puede acceder un mod una vez que se carga, incluyendo tus archivos, tus variables de entorno y archivos de configuración, y tu sesión: "cada prompt que envías y cada llamada a herramienta que hace Claude".
Y: "Los mods no están en un sandbox". Si activas el sandboxing, este aísla los comandos de Bash que ejecuta Claude, pero un proceso que inicia un mod se ejecuta fuera de él.
Hay límites. "Un mod puede rediseñar gran parte de la interfaz de Claude Code, pero no el prompt de permisos". Y Anthropic describe una protección integrada que, al cargarse, por defecto impide que un mod de usuario apruebe llamadas a herramientas que tus reglas o hooks detendrían.
Para ver qué hace un mod antes de instalarlo, ejecuta claude plugin validate en su carpeta. La salida enumera los eventos que el mod maneja y lo que le pide hacer a Claude Code.
Dónde se ejecutan los mods
Los mods funcionan en la CLI de Claude Code, la pestaña Code de la aplicación Claude Desktop y la extensión de VS Code. La tabla de Anthropic añade los casos especiales:
claude -py el Agent SDK: los hooks se ejecutan, pero no se dibuja nada.- Control remoto: los hooks se ejecutan en la sesión de tu máquina, y los dibujos aparecen en la terminal allí.
- Sesiones en la nube: los hooks se ejecutan para un plugin que llega a la sesión en la nube, pero no se dibuja nada.
- Sesiones WSL en la aplicación Desktop: los mods no se ejecutan, porque los plugins no están disponibles allí.
Un mod que dibuja puede verificar dónde se está ejecutando y recurrir a una línea en la transcripción o a una respuesta de texto de un comando.
Qué mantiene un mod entre sesiones
Esta es la parte que vale la pena entender antes de confiar en un mod. La documentación de Anthropic dice: "El lugar donde un mod guarda un valor decide cuánto dura el valor: hasta que el módulo se recarga, hasta que termina la sesión o de una sesión a la siguiente".
Hay tres lugares:
Una variable a nivel de módulo. Dura hasta que el módulo se recarga, lo cual durante el desarrollo ocurre cada vez que guardas un archivo. Anthropic describe estos como valores que puedes perder.
$.state. Dura hasta que "la sesión termina, o el usuario ejecuta /clear, /resume o /branch". Está pensado para valores de los que depende un dibujo y que deben sobrevivir a una recarga del módulo. Por eso el panel del ejemplo inicial se quedó en blanco después de /clear.
$.store. Dura hasta que el mod elimina el valor, o hasta que ninguna sesión lee o escribe en el almacén durante el periodo cleanupPeriodDays. Anthropic lo describe como "Un almacén clave-valor que comparten todas las sesiones en la máquina". Se guarda como un archivo JSON propio del plugin bajo ~/.claude/plugins/store/, y la documentación enumera configuraciones, historial y "cualquier cosa que el usuario espere encontrar la próxima vez" como su propósito.
Así que el contador que recordaba el total de ayer estaba en $.store. El panel que se reinició estaba dibujando desde $.state.
Un mod bien construido hace de puente entre ambos. Anthropic señala que si un mod copia un valor guardado de $.store a $.state cuando comienza una sesión, tiene que copiarlo de nuevo después de /clear, /resume o /branch, porque esos comandos reinician $.state y el hook de inicio de sesión no se dispara de nuevo. Si la pantalla de un mod se reinicia cuando sus datos no deberían, ese es el lugar donde el autor debe mirar.
Se derivan dos puntos prácticos. El almacén de un mod está en tu máquina, compartido por las sesiones allí, por lo que no es lo mismo que algo que tus compañeros de equipo o otra computadora puedan ver. Y está sujeto al mismo periodo de retención que Claude Code usa en otros lugares, si nada lo toca.
Cómo desactivar los mods
"Los mods están activados por defecto". Para detenerlos, Anthropic enumera tres niveles:
- Un mod: desactiva o desinstala su plugin desde la pestaña Installed en
/plugin. - Todos los mods instalados, para una sesión: inicia Claude Code con
--safe-mode, lo que también desactiva tus otras personalizaciones. - Todos los mods que instalaste, en cada sesión: establece
disableAllHooksatrueen~/.claude/settings.json. Tus settings hooks y la línea de estado personalizada también se detendrán.
Los mods integrados son diferentes: "Los ajustes y flags que detienen los mods instalados, como disableAllHooks, --bare y --safe-mode, no detienen los mods integrados". Las organizaciones también pueden limitar qué mods se cargan a través de configuraciones gestionadas.
Lo que la gente intenta primero
Esperar que el panel de un mod sobreviva a /clear. $.state se reinicia con /clear, /resume y /branch.
Esperar los datos de un mod en otra máquina. $.store es compartido por las sesiones en la máquina donde se guarda.
Instalar sin verificar. Ejecuta claude plugin validate para ver qué hace un mod.
Asumir que el sandbox cubre los mods. Los mods no están en un sandbox.
Usar un mod para el conocimiento del proyecto. Un mod cambia cómo se comporta Claude Code; el conocimiento del proyecto pertenece a los archivos de instrucciones.
La solución: Usa mods para el comportamiento y mantén el contexto en otro lugar
Paso 1: Verifica qué hace un mod antes de instalarlo
Ejecuta claude plugin validate en su carpeta y lee los eventos y llamadas que enumera.
Paso 2: Conoce dónde vive cada valor
Si escribes un mod, pon los valores que deben sobrevivir a /clear en $.store, y recárgalos en $.state después de un reinicio.
Paso 3: Mantén el conocimiento del proyecto en archivos de instrucciones
Las convenciones y la estructura pertenecen a CLAUDE.md o AGENTS.md, que se cargan como instrucciones del proyecto.
Paso 4: Anota lo que aprendas en una sesión
El panel de un mod puede rastrear el progreso, pero las decisiones detrás de él deben registrarse en algún lugar que dure más que la sesión y la máquina.
Configurando esto en MemoryLake
Un mod es una buena manera de ver qué está sucediendo en una sesión. Las decisiones y lecciones de esa sesión, como qué enfoque funcionó o por qué un archivo está fuera de los límites, necesitan un hogar que no se reinicie con /clear y no esté atado a una sola máquina.
MemoryLake es una capa de memoria para ese tipo de contexto de proyecto, como decisiones, convenciones y lecciones aprendidas, mantenida en un solo lugar que tú controlas y disponible para los asistentes que conectes, como ChatGPT, Claude Code y Codex.
Tú mismo escribes las entradas, con tus propias palabras. No se lee, escribe ni borra nada de tus mods, su $.state o $.store, tus plugins, tus archivos de configuración, tus sesiones o el almacén de cualquier proveedor. Los mods y su estado funcionan de la manera que Anthropic describe.
Paso 1: Crea una clave de API
Inicia sesión y genera una clave desde el panel de control. Mantenla fuera del código de plugins y mods, como cualquier otra credencial.

Paso 2: Sube tus primeras memorias
Comienza con lo que escribiste en el Paso 4 de la solución: decisiones de sesiones recientes, convenciones en las que confías y lecciones que no quieres volver a aprender. Una decisión por entrada.

Paso 3: Conecta tu IA y agentes
Conecta Claude Code y los otros asistentes que uses. Una nueva sesión, u otra máquina, podrá recurrir a las mismas entradas.

Qué cambia esto en la práctica
La primera diferencia es que /clear deja de costarte contexto. La pantalla de un mod puede reiniciarse, y las decisiones siguen estando registradas.
La segunda es la portabilidad. Lo que aprendiste no está atado al almacén de una sola máquina.
La tercera es una división más limpia. Los mods manejan cómo se comporta Claude Code, y el contexto de tu proyecto vive en un solo lugar.
Mejores prácticas para Claude Code mods
Trata los mods como código. Se ejecutan con tus permisos y no están en un sandbox.
Valida antes de instalar. claude plugin validate enumera lo que hace un mod.
Recarga después de instalar desde el shell. Ejecuta /reload-plugins en una sesión abierta.
Conoce los tres tiempos de vida. Las variables, $.state y $.store duran cada uno un tiempo diferente.
Espera reinicios con /clear. $.state vuelve a sus valores por defecto.
Usa --safe-mode para solucionar problemas. Desactiva los mods instalados por una sesión.
Mantén el contexto fuera de los mods. Usa archivos de instrucciones y una memoria que tú mantengas.
Conclusión
Un mod de Claude Code es un plugin hecho de manejadores en JavaScript o TypeScript que se ejecutan dentro de Claude Code. Puede dibujar paneles y bandas, redibujar partes de la interfaz, intervenir en llamadas a herramientas y solicitudes, y añadir comandos, algo que los settings hooks, skills y servidores MCP no pueden. También se ejecuta con tus permisos y no está en un sandbox, así que valídalo antes de instalar.
Lo que un mod mantiene depende de dónde guarde un valor. Las variables de módulo duran hasta una recarga, $.state dura hasta que termina la sesión o ejecutas /clear, /resume o /branch, y $.store persiste a través de las sesiones en tu máquina hasta que el mod lo borra o deja de usarse durante el periodo de retención. Para el contexto que debe durar más que todo eso, regístralo en algún lugar que tú mantengas.