Los 5 chequeos antes de instalar un mod de Claude Code
Recurso 22 de 26, guía gratis
ALVEX / RecursosQué es un mod, cómo se consigue uno y los cinco chequeos para revisar el de otra persona antes de instalarlo.
Claude Code ya se puede modificar. Anthropic lo anunció el 1 de octubre de 2026 con los mods: funciones pequeñas de TypeScript que cambian cómo se ve y cómo se comporta.
Esta página tiene tres partes. Qué es un mod, cómo se consigue uno y los cinco chequeos antes de instalar el de otra persona.
Antes de seguir, tres cosas honestas:
- Todo sale del blog y la documentación oficial de Anthropic, leídos el 12 de octubre de 2026. Cada dato lleva su fuente al final.
- Yo no he creado ni instalado ningún mod. Esta página no cuenta una prueba mía. Cuenta lo que dice la documentación y cómo revisarlo.
- Estas funciones son nuevas y cambian. Si la documentación dice hoy algo distinto, manda la documentación.
1. Qué es un mod, en simple
Un mod es un plugin que cambia cómo se ve y cómo se comporta Claude Code. Por dentro son funciones de JavaScript o TypeScript que Claude Code llama cuando pasa algo: una llamada a una herramienta, un mensaje que envías, una parte de la pantalla que se dibuja. La función puede mirar lo que pasa, cambiarlo o encargarse ella misma.
Según la documentación, un mod puede:
- dibujar un panel al lado de la conversación o una franja encima de donde escribes
- redibujar partes de la interfaz que Claude Code dibuja solo, como el indicador de carga
- meterse en una llamada a una herramienta, por ejemplo frenarla para hacerte una pregunta
- agregar un comando propio que corre al instante
Un ejemplo de la propia documentación es un mod que cuenta las llamadas a herramientas que hace Claude y muestra el número al lado del indicador de carga.
Dónde funciona: en la terminal (CLI) y en la pestaña Code de la app de escritorio. En una sesión de WSL dentro de la app de escritorio no hay mods. En la extensión de VS Code las funciones corren pero lo que dibujan no se ve.
Versión mínima: CLI desde la 2.1.287. App de escritorio desde la 2.1.286. Para ver la tuya: claude --version en la terminal.
2. Cómo se consigue un mod
Hay tres caminos, según la documentación:
| Camino | Qué haces | Qué tener en cuenta |
|---|---|---|
| Pedírselo a Claude | Describes lo que quieres en una sesión de Claude Code, por ejemplo "haz un mod que muestre la rama de git encima de donde escribo". Claude lo escribe con una skill propia que se llama plugin-authoring | En los modos default y acceptEdits, Claude Code te pide permiso antes de crear cada archivo del mod. Al guardar el primero pregunta si activas la recarga en caliente para esa sesión. Un mod que escribe Claude solo carga en la sesión donde lo hizo |
| Instalar uno de un marketplace | /plugin install nombre@marketplace dentro de una sesión, o claude plugin install nombre@marketplace en la terminal | Un mod se instala como un plugin. Si lo instalas desde la terminal con una sesión abierta, corre /reload-plugins en esa sesión |
| Probar uno de ejemplo | Anthropic comparte tres mods de muestra en el repositorio claude-code-playground y dice que los comparte "como están", sin soporte. Los cargas para una sola sesión con claude --plugin-dir ruta | Un mod de muestra también corre con tus permisos |
El blog dice que también se pueden conseguir plugins desde el directorio de Claude o con /plugin en la terminal.
3. Lo que casi nadie dice: un mod no está aislado
La documentación de Anthropic lo dice sin rodeos:
"A mod is code that runs with your permissions. It can read and write your files, start processes, and make network requests."
Y el blog: "Mods run with the same access to your machine as Claude Code itself". Los mods no están aislados (no hay sandbox para ellos).
La lista de lo que un mod puede alcanzar una vez que carga:
| Puede | Qué significa en la práctica |
|---|---|
| Actuar en tu computador como tú | Leer y escribir archivos donde tu usuario pueda, abrir programas, conectarse a internet |
| Leer tus secretos | Variables de entorno y archivos de configuración, incluida una clave de API si la guardas ahí |
| Ver tu sesión | Cada mensaje que envías y cada llamada a una herramienta que hace Claude |
| Cambiar tu sesión | Reescribir un mensaje o una llamada, enviar un mensaje como si lo hubieras escrito tú, o mandar un mensaje a otra de tus sesiones |
| Actuar sin preguntarte | Aprobar una llamada a una herramienta antes de que te la pregunten |
| Gastar tu uso | Llamar a un modelo con tu plan o tu clave de API |
Dos detalles que la documentación aclara y que importan:
- El sandbox de Claude Code no cubre a un mod. Si activas el sandbox, aísla los comandos de Bash que corre Claude. Un proceso que lanza un mod corre afuera de él.
- Un mod no puede cambiar lo que muestra el aviso de permisos. Pero sí puede aprobar o negar una llamada antes de que el aviso aparezca.
Por eso Anthropic pide instalar mods solo de autores y marketplaces en los que confías.
4. Los 5 chequeos
Cada chequeo es una pregunta, con la forma de comprobarla y qué hacer con la respuesta.
Chequeo 1. ¿Quién lo publicó y de dónde viene?
| Cómo lo compruebo | Qué hago con la respuesta |
|---|---|
Mira el nombre del plugin y el marketplace. Se instala como nombre@marketplace, así que el marketplace queda escrito en el comando | Si no conoces al autor ni al marketplace, no sigas. La documentación pide instalar "solo de autores y marketplaces en los que confías" |
Chequeo 2. ¿Qué eventos engancha y qué le pide hacer a Claude Code?
Hay un comando que lo lista sin correr el mod. Primero consigues los archivos del plugin, por ejemplo clonando su repositorio. Después, en la terminal:
claude plugin validate ./nombre-del-mod
| Cómo lo compruebo | Qué hago con la respuesta |
|---|---|
En la salida busca dos líneas. hooks: lista los eventos que el mod recibe. calls: lista lo que le pide hacer a Claude Code | Si el comando no puede leer cómo el mod usa su API, Claude Code se niega a cargarlo. Eso ya es una señal |
Dos eventos para mirar con ojo en hooks:: tool.call y prompt.submit significan que el mod ve cada llamada a una herramienta y cada mensaje, y puede cambiarlos. tool.check significa que puede aprobar o negar una llamada antes de que aparezca el aviso de permisos.
Chequeo 3. ¿Toca archivos, procesos, internet o variables de entorno?
Esto se lee en la línea calls: de la salida del chequeo 2.
| Si ves | Significa |
|---|---|
$.fs.read, $.fs.write | Lee o escribe archivos donde tu usuario pueda |
$.process.run, $.process.spawn | Abre programas como tú |
$.http.fetch | Hace llamadas por internet |
$.env.get, $.settings.read | Lee variables de entorno y configuración, que pueden tener claves. Una línea env reads: nombra cada variable |
$.env.set | Cambia una variable de entorno para Claude Code y para todo lo que este abra después |
$.model.complete | Gasta tu plan o tu clave en llamadas a un modelo |
$.prompt.submit | Envía un mensaje que puede pasar por tuyo |
$.session.send | Manda un mensaje que lee otra sesión o un subproceso de Claude |
Pregunta de control: ¿esto tiene sentido para lo que dice que hace el mod? Un mod que solo dibuja un número al lado del indicador de carga no tiene por qué pedir $.http.fetch. La lista dice qué llama, no por qué lo llama. Esa parte la juzgas tú, o alguien de confianza.
Chequeo 4. ¿Lo probé para una sola sesión antes de instalarlo?
| Cómo lo compruebo | Qué hago con la respuesta |
|---|---|
claude --plugin-dir ./nombre-del-mod carga el mod solo para esa sesión, sin instalarlo | Es la forma de verlo sin dejarlo instalado. Después de cerrar la sesión, no queda cargado |
Aviso importante: --plugin-dir no es una caja aislada. El mod cargado así sigue corriendo con tus permisos. Lo que te da es que no se quede instalado. No lo abras en una carpeta con cosas que no quieres exponer, y no lo cargues con claves guardadas en variables de entorno que no quieras que lea.
Chequeo 5. ¿Sé cómo apagarlo?
| Si quiero | Hago |
|---|---|
| Ver qué mods tiene una sesión | /plugin. Una línea tenue bajo las pestañas da el conteo y los nombres, por ejemplo "1 mod active" |
| Apagar uno | Desactivarlo o desinstalarlo en /plugin, pestaña Installed |
| Apagar todos en una sesión | Empezar Claude Code con claude --safe-mode. Apaga también otras personalizaciones |
| Apagar todos en todas las sesiones | Poner "disableAllHooks": true en ~/.claude/settings.json. Frena también tus hooks de configuración y tu línea de estado |
Los mods que vienen con Claude Code (por ejemplo el de /diff) no se apagan con --safe-mode ni con disableAllHooks. Cada uno tiene su propio interruptor en /plugin.
5. Si el mod lo escribe Claude por ti
El camino de "descríbeselo y Claude lo escribe" es real, según Anthropic. Los chequeos cambian un poco:
- Mira los archivos antes de aprobar el siguiente. Claude Code te pide permiso por archivo en los modos
defaultyacceptEdits. - Corre
claude plugin validatesobre lo que escribió y leehooks:ycalls:, igual que con el de otra persona. - La recarga en caliente corre el mod ya en esa sesión. Si dices "Not now", no carga nada hasta que la sesión empiece de nuevo.
Un mod que escribe Claude no carga si nadie puede aprobarlo (por ejemplo en claude -p o en modo dontAsk), si el espacio de trabajo no es de confianza, o si los mods están apagados.
6. Qué cubre esta lista y qué no
- Cubre revisar un mod de forma estática y sin correrlo, y saber cómo apagarlo.
- No cubre garantizar que un mod sea seguro. Ninguna lista lo hace. La documentación pide confianza en la fuente, y esa confianza la pones tú.
- No cubre mods de una organización. Si usas Claude Code en una empresa, un administrador puede limitar cuáles cargan con ajustes gestionados. Eso es otra página de la documentación.
Fuentes (leídas el 12 de octubre de 2026)
- Blog de Anthropic, publicado el 1 de octubre de 2026: claude.com/blog/claude-code-mods
- Mods, resumen (qué es, instalar, qué alcanza, listar antes de instalar, apagar): code.claude.com/docs/en/plugins/mods/overview
- Crear un mod (pedírselo a Claude, permiso por archivo,
--plugin-dir): code.claude.com/docs/en/plugins/mods/create - Administrar mods (qué llamadas mirar en la salida de
claude plugin validate): code.claude.com/docs/en/plugins/mods/admin