Mods de Claude Code: qué son, cómo instalarlos y cómo crear el tuyo (explicado para todos)

Los mods de Claude Code son la forma más directa que existe hoy de cambiar cómo se ve y cómo se comporta el agente de programación de Anthropic. Piensa en los mods de un videojuego: el juego es el mismo, pero alguien le agrega un mapa nuevo, cambia la interfaz o inventa una regla. Con Claude Code pasa lo mismo. Puedes sumarle un panel, un comando propio o una regla que frene una acción peligrosa antes de que ocurra. Te explico qué son, qué pueden hacer, cómo instalarlos o crearlos y, sobre todo, qué riesgos revisar antes.

Si no programas, lee hasta la sección de seguridad y salta a las preguntas frecuentes: ahí está todo lo que necesitas para decidir si tu equipo debería usarlos. Si eres developer, la parte de crear tu propio mod trae el código completo.

Qué son los mods de Claude Code, explicado sin tecnicismos

Primero, el contexto. Claude Code es un agente de IA para programar: trabaja en la terminal y en la pestaña Code de la app de escritorio de Claude, lee tu proyecto, edita archivos y ejecuta comandos. Si nunca lo has usado, aquí explico los beneficios de Claude Code en el desarrollo.

Un mod es un tipo de plugin que vive dentro de Claude Code. Según la documentación oficial, está hecho de funciones en JavaScript o TypeScript que Claude Code llama cuando ocurre un evento: Claude va a usar una herramienta, tú envías un mensaje o la app dibuja una parte de la pantalla. Una forma sencilla de imaginarlo es un portero. Cada vez que algo pasa por la puerta, el portero puede mirarlo y dejarlo seguir, modificarlo o resolverlo él mismo sin que llegue a destino.

Esas son exactamente las tres opciones que tiene un mod frente a cada evento:

• Observar: anota lo que pasa y deja que siga igual. Por ejemplo, contar cuántas herramientas usó Claude.
• Reescribir: cambia el evento antes de que continúe, como agregar un dato al indicador de carga.
• Responder: se encarga del evento y el comportamiento normal no se ejecuta. Por ejemplo, rechazar un comando.

Los mods requieren Claude Code v2.1.287 o posterior y vienen activados por defecto. Para saber qué versión tienes, corre claude --version en tu terminal.

Qué puede hacer un mod que antes no se podía

Claude Code ya tenía hooks de configuración, skills, líneas de estado y servidores MCP. Todos esos funcionan desde afuera: corren un script o le dan a Claude texto o herramientas. El mod corre adentro, y eso le abre cinco capacidades nuevas:

1. Dibujar una interfaz propia: un panel al lado de la conversación o una franja sobre el cuadro de texto, con pestañas, botones y campos.
2. Redibujar la interfaz de Claude Code: cambiar el estilo de partes que la app dibuja sola, como la fila de una llamada a herramienta, el spinner o el diálogo donde Claude te hace preguntas.
3. Meterse en una llamada a herramienta o en un pedido al modelo: pausar una acción mientras te pregunta algo, responderla sin ejecutar la herramienta o enviar un pedido concreto a otro modelo.
4. Crear comandos que corren al instante: un /comando que ejecuta tu función sin gastar un turno de Claude, incluso mientras Claude está trabajando.
5. Compartir datos entre hooks: uno registra el uso de tokens de cada pedido y otro lo grafica en un panel, por ejemplo.

El punto 3 es el que más me interesa para equipos. Enviar las tareas simples a un modelo más barato es la misma lógica que explico en niveles de esfuerzo en Claude, ChatGPT y Gemini, pero automatizada.

Mods de Claude Code vs hooks, skills y MCP: cuál usar

Se parecen y se solapan, así que la pregunta correcta no es si los mods son mejores, sino cuál resuelve tu problema con menos riesgo. Esta tabla resume la comparación de la documentación de Anthropic:

	Mod	Hook de configuración	Skill	Servidor MCP
Qué es	Funciones dentro del proceso de Claude Code	Un comando, petición HTTP o prompt que corre en un evento	Un archivo SKILL.md con instrucciones	Un proceso externo que le da herramientas a Claude
Puede dibujar en la interfaz	✓ Sí	✗ No	✗ No	✗ No
Qué escribes	JavaScript o TypeScript	Un script y una entrada en settings.json	Markdown	Un servidor en cualquier lenguaje
Elígelo cuando	Quieres un panel, un comando propio o reescribir un evento	Quieres bloquear, permitir o registrar un evento con un script que ya tienes	Siempre pegas las mismas instrucciones en el chat	Claude necesita conectarse a un sistema externo

Un mismo plugin puede traer las cuatro cosas juntas. Si el concepto de MCP todavía no te queda claro, tengo una guía sobre qué es Model Context Protocol.

Mods que ya estás usando sin saberlo

Varias funciones de Claude Code ya son mods. Los ves corriendo /plugin y entrando a la pestaña Installed, en la sección Built-in:

• cc-plugin-agents-md: carga el archivo AGENTS.md como instrucciones del proyecto.
• cc-plugin-diff: se encarga del comando /diff y dibuja su panel.
• cc-plugin-plugin-authoring: le da a Claude la skill para escribir mods por ti.
• cc-plugin-sec-default: protege lo que administra tu organización frente a los mods que instala un usuario. Este no se puede apagar.
• cc-plugin-telemetry: envía los registros de analítica. Se desactiva en /plugin o apagando la telemetría.

Que Anthropic construya sus propias funciones como mods dice mucho: no es un experimento lateral, es la arquitectura sobre la que va a crecer la herramienta.

Cómo instalar mods de Claude Code paso a paso

1. Confirma que tienes la versión 2.1.287 o posterior con claude --version. Si no, actualiza Claude Code.
2. Los mods se instalan como cualquier plugin, desde un marketplace (un catálogo de plugins). Dentro de una sesión escribe /plugin install nombre@marketplace. Desde la terminal, claude plugin install nombre@marketplace.
3. Si lo instalaste desde la terminal con una sesión abierta, corre /reload-plugins en esa sesión. Si no, se carga la próxima vez que abras Claude Code.
4. Corre /plugin y mira la línea gris bajo las pestañas. Debe decir algo como “1 mod active” con el nombre del mod.

Estos son los comandos que vas a usar con más frecuencia:

# Ver tu versión (necesitas la 2.1.287 o posterior)
claude --version

# Instalar un mod desde la terminal
claude plugin install token-chart@your-org

# Revisar qué hace un mod ANTES de instalarlo, sin ejecutarlo
claude plugin validate ./some-mod

# Probar un mod tuyo en una sola sesión, sin instalarlo
claude --plugin-dir ~/mods/git-branch

Cómo crear tus propios mods de Claude Code

Opción 1: pídele a Claude que lo escriba (sin programar)

Esta es la parte que vuelve los mods accesibles para cualquiera. Describes lo que quieres en una sesión de Claude Code y Claude escribe el mod. Para hacerlo usa una skill integrada llamada plugin-authoring, que le indica dónde guardarlo, qué eventos tiene tu versión y cómo se carga. Puedes activarla tú mismo con /plugin-authoring.

Un pedido realista sería: “Quiero un mod que muestre en un panel cuántos tokens consume cada pedido y que me pregunte antes de ejecutar cualquier comando que contenga la palabra deploy”. Claude guarda el resultado en ~/.claude/dev-mods/ seguido del ID de la sesión, así que no ensucia tu proyecto. Ese mod solo se carga en esa sesión y después de que lo apruebes; si quieres conservarlo, copia su carpeta a un lugar tuyo y cárgala con --plugin-dir.

Opción 2: escríbelo tú

Un mod pequeño tiene tres archivos: el manifiesto del plugin, un hooks.json que apunta a tu código y el archivo con tu código, llamado módulo de hooks.

mi-primer-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

Este es el ejemplo de la documentación oficial, con los comentarios traducidos. Cuenta cuántas herramientas usa Claude y muestra el número junto al spinner mientras trabaja:

// Contador compartido por los dos hooks
let calls = 0

// Claude Code llama a esta función una vez, al cargar el mod
export function register(on) {
  // Se ejecuta cada vez que Claude va a usar una herramienta
  on('tool.call', async ($, e, next) => {
    calls += 1
    // Pide redibujar la interfaz para que se vea el nuevo número
    $.ui.invalidate('ui.render')
    // Deja que la herramienta corra normal
    return next(e)
  })

  // Se ejecuta cada vez que Claude Code dibuja el spinner
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

El hook tool.call suma uno cada vez que Claude va a usar una herramienta y deja que siga normal. El hook ui.render conserva el spinner original y le agrega el contador al final. Los dos comparten la variable calls, que es justamente lo que un hook de configuración no puede hacer. Para probarlo sin instalarlo, inicia Claude Code con --plugin-dir apuntando a la carpeta del mod.

Seguridad de los mods de Claude Code: qué pueden hacer en tu equipo

Esta es la sección más importante del artículo. Un mod no corre en una caja aislada: corre con tus permisos. La documentación es clara sobre lo que puede hacer una vez cargado:

• Leer y escribir archivos en cualquier lugar al que tu usuario tenga acceso, iniciar programas y hacer peticiones de red.
• Leer tus secretos, como variables de entorno y archivos de configuración, incluida una clave de API que guardes ahí.
• Ver cada mensaje que envías y cada herramienta que Claude usa.
• Reescribir un mensaje o una acción, o enviar un mensaje como si lo hubieras escrito tú.
• Aprobar una acción antes de que te pregunten.
• Gastar tu cuota llamando a un modelo con tu plan o tu clave de API.

Hay un límite que vale la pena conocer: un mod puede cambiar casi toda la interfaz, pero no el aviso de permisos. No puede alterar lo que ese aviso te muestra.

Mi regla es tratar un mod igual que un paquete de npm de un desconocido: no lo instalo sin revisar qué hace. Para eso existe claude plugin validate, que lista los eventos que el mod escucha y lo que le pide a Claude Code (leer archivos, hacer peticiones de red) sin ejecutarlo. Y si algo se comporta raro, tienes tres formas de apagarlos:

• Un solo mod: desactívalo o desinstálalo desde la pestaña Installed de /plugin.
• Todos, por una sesión: inicia Claude Code con --safe-mode.
• Todos, siempre: agrega "disableAllHooks": true en ~/.claude/settings.json. Esto también detiene tus hooks de configuración y tu línea de estado personalizada.

Ninguna de esas opciones apaga los mods integrados. En empresas, un administrador puede limitar qué mods se cargan mediante la configuración administrada, e incluso permitir solo los de la organización.

Dónde funcionan los mods de Claude Code

Los hooks de un mod corren en casi todos lados, pero lo que dibuja solo aparece en la terminal y en la app de escritorio:

Dónde usas Claude Code	Los hooks corren	Se ve lo que dibuja
Terminal (incluida la integrada de tu editor y el plugin de JetBrains)	✓ Sí	✓ Sí
Pestaña Code de la app de escritorio	✓ Sí	✓ Sí, salvo elementos exclusivos de terminal
Panel de chat de la extensión de VS Code	✓ Sí	✗ No
claude -p y Agent SDK	✓ Sí	✗ No
Sesión en la nube	✓ Sí, si el plugin llega a esa sesión	✗ No

Mi postura: cuándo vale la pena un mod

Los mods son potentes y por eso mismo no son el primer recurso. Si lo que necesitas es que Claude siga siempre las mismas reglas, una skill alcanza. Si quieres bloquear un comando con un script que ya tienes, un hook de configuración lo resuelve con menos superficie de riesgo. Yo usaría un mod cuando necesito ver algo que hoy no se ve (consumo de contexto, costos por pedido, el estado de un despliegue) o cuando quiero una barrera inteligente que pause una acción y me pregunte antes de tocar producción.

Para alguien que no programa, el valor real está en la opción de pedirle el mod a Claude. Un líder de proyecto puede pedir un panel con el uso de tokens del equipo sin escribir una línea. Eso sí, que alguien técnico revise el resultado con claude plugin validate antes de compartirlo.

Fuentes y documentación oficial

• Descripción general de los mods de Claude Code: qué son, qué pueden hacer, dónde corren y los mods integrados.
• Crear un mod (documentación en español): cómo pedirle un mod a Claude y cómo escribir uno desde cero.
• Administrar mods en una organización: configuración administrada, revisión de mods y políticas para empresas.

Preguntas frecuentes

¿Qué es un mod de Claude Code en palabras simples?

Es un complemento que cambia cómo se ve y cómo se comporta Claude Code, igual que un mod en un videojuego. Puede agregar paneles y comandos, cambiar partes de la interfaz o intervenir antes de que Claude ejecute una acción.

¿Necesito saber programar para usar mods?

Para instalarlos, no: basta con un comando. Para crear uno tampoco es obligatorio, porque puedes describirle a Claude lo que quieres y él lo escribe. Lo recomendable es que alguien con conocimientos técnicos revise el mod antes de usarlo en un equipo.

¿Los mods de Claude Code son seguros?

Son tan seguros como su autor. Un mod corre con tus permisos y puede leer archivos, secretos y todo lo que haces en la sesión. Instala solo mods de fuentes confiables y revisa cada uno con claude plugin validate antes.

¿Los mods funcionan en VS Code?

En parte. En el panel de chat de la extensión de VS Code los hooks del mod sí corren, pero no se ve lo que dibuja. Si usas Claude Code en la terminal integrada de VS Code, funciona completo.