Mods de Claude Code · cómo se crean y cómo se instalan

Claude Code ahora se deja cambiar por dentro

Hasta hace poco, todo lo que le agregabas a Claude Code trabajaba desde afuera. Una skill le da instrucciones. Un servidor MCP le da herramientas. Un hook de configuración corre un script cuando pasa algo. Ninguno puede tocar lo que ves en la pantalla.

Los mods sí. Un mod es código que corre dentro de Claude Code. Puede dibujar un panel al lado de la conversación, poner una franja arriba de donde escribes, cambiar cómo se ve el spinner o frenar un comando peligroso antes de que corra.

Todo lo que sigue sale de la documentación oficial de Claude Code, en la sección de mods. La revisé el 7 de octubre de 2026.

Qué es un mod

Un mod es un plugin de Claude Code que trae funciones escritas en JavaScript o TypeScript. Cada función está pendiente de un evento: Claude va a usar una herramienta, envías un prompt, se dibuja una parte de la pantalla. Cuando el evento pasa, Claude Code llama la función y ella decide qué hacer.

Tiene tres caminos:

Qué puede hacer un mod

La documentación lista estas capacidades:

• Dibujar una interfaz propia. Un panel al lado de la conversación o una franja arriba del prompt, con pestañas, botones y campos de texto.
• Rehacer partes de Claude Code. La fila de una herramienta, el spinner, los mensajes o el diálogo donde Claude te hace preguntas.
• Meterse en una herramienta o en una petición. Frenarla para preguntarte algo, responderla sin correr la herramienta o mandar esa petición a otro modelo.
• Crear comandos propios. Un /comando que corre tu código al instante, sin turno de Claude, incluso mientras Claude está trabajando.
• Compartir datos entre sus partes. Una función cuenta y otra muestra el conteo en pantalla.
• Llamar otro modelo. Mandarle una tarea a un modelo distinto, por fuera de la conversación.
• Mandar mensajes a otra sesión. A otra de tus sesiones de Claude Code o a un subagente.
• Trabajar en segundo plano y guardar datos entre una sesión y otra.

Tres usos que se entienden rápido

Dónde funciona

Un mod corre en todas las sesiones que cargan el plugin. Lo que dibuja se ve en menos lugares.

• Terminal (claude), también en la terminal del editor y en el plugin de JetBrains: corre y se ve todo.
• Pestaña Code de Claude Desktop: corre y se ve, salvo algunos elementos que son solo para la terminal.
• Extensión de VS Code, claude -p y el Agent SDK: corre, pero no se dibuja nada.
• Remote Control desde claude.ai o el celular: corre en tu máquina y se ve en la terminal de tu máquina.
• Sesiones en la nube: corre si el plugin llega a esa sesión, pero no se dibuja nada.

Cómo se crea un mod

Hay dos caminos. El primero no te pide saber programar.

Camino 1 · Se lo pides a Claude

Claude Code trae una skill integrada que se llama plugin-authoring. Le dice a Claude dónde escribir el mod, qué eventos tiene tu versión y cómo se carga. Claude la usa sola cuando le pides un mod, o la cargas tú con /plugin-authoring.

Camino 2 · Lo escribes tú: tres archivos

Este es el ejemplo de la documentación. El mod se llama first-mod, cuenta las herramientas que usa Claude, muestra el conteo al lado del spinner y crea el comando /tally. No necesitas Node.js ni compilar nada: Claude Code lee los archivos .js y .ts directo.

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

{
  "name": "first-mod",
  "version": "0.1.0",
  "description": "Counts Claude's tool calls, shows the count beside the spinner, and adds a /tally command",
  "author": { "name": "Your Name" }
}

{
  "description": "The first-mod hooks module",
  "modules": ["./register.js"]
}

let calls = 0

export function register(on) {
  on('session.start', async ($, e, next) => {
    await $.command.register({
      name: 'tally',
      description: 'Show how many tool calls Claude has made',
    })
    return next(e)
  })

  on('tool.call', async ($, e, next) => {
    calls += 1
    $.ui.invalidate('ui.render')
    return next(e)
  })

  on('command.run', { command: 'tally' }, async () => {
    return { text: 'Claude has made ' + calls + ' tool calls since this mod loaded' }
  })

  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

Cada función recibe tres cosas. $ es la caja de herramientas del mod: con ella dibuja, crea comandos o llama un modelo. e es el evento que acaba de pasar. next deja que el evento siga hacia los demás mods y hacia Claude Code.

$ claude --plugin-dir ./first-mod

> /tally
first-mod: Claude has made 2 tool calls since this mod loaded

Mientras lo cargues con --plugin-dir, Claude Code vigila la carpeta y recarga el mod cada vez que cambias un archivo. Al recargar, el conteo vuelve a cero.

Revisarlo antes de usarlo

Cómo se instala un mod hecho por otro

Un mod se instala como cualquier plugin: desde un marketplace, con el nombre del plugin, una @ y el nombre del marketplace.

# Dentro de una sesión de Claude Code
> /plugin install token-chart@your-org

# Desde la terminal
$ claude plugin install token-chart@your-org

# Si la sesión ya estaba abierta, para que lo cargue
> /reload-plugins

Si lo instalas desde la terminal con una sesión abierta, corres /reload-plugins en esa sesión. Si no, carga la próxima vez que abras Claude Code.

Los que ya vienen con Claude Code

Algunas funciones de Claude Code ya son mods. Los ves en /plugin, pestaña Installed, bajo Built-in:

• /diff: te muestra en un panel los cambios que aún no tienen commit.
• agents-md: carga el archivo AGENTS.md como instrucciones del proyecto.
• plugin-authoring: la skill con la que Claude te escribe mods.
• you-should-know: un agente lateral que, en tareas largas, te avisa arriba del prompt lo que se te puede pasar. Viene apagado y se prende con /plugin enable cc-plugin-you-should-know@builtin.
• sec-default y telemetry: la seguridad de tu organización y la analítica de Claude Code.

El código de diff, agents-md, sec-default y telemetry es público en el repositorio de Claude Code, en la carpeta mods. Si quieres ver cómo está hecho un mod real, de ahí puedes partir.

Antes de instalar, la parte de seguridad

Por eso la regla es simple. Instala mods solo de personas y marketplaces que conoces, y antes de instalarlo corre claude plugin validate sobre su carpeta para ver qué pide.

Cómo apagarlos

• Un solo mod: lo desactivas o lo desinstalas en /plugin, pestaña Installed.
• Todos, solo por esta sesión: abres Claude Code con --safe-mode.
• Todos, siempre: pones "disableAllHooks": true en ~/.claude/settings.json. Ojo, eso también apaga tus hooks de configuración y tu línea de estado.

Los mods que vienen con Claude Code no se apagan con estas opciones. Si usas Claude Code en una organización, el administrador también decide cuáles cargan.

Lo que tienes que recordar

• Un mod es código que corre dentro de Claude Code. Observa, reescribe o responde eventos, y puede dibujar en la pantalla.
• Necesitas la versión 2.1.287 o una posterior.
• La forma más fácil de crearlo: pídeselo a Claude con tus palabras y aprueba cada archivo.
• A mano son tres archivos: plugin.json, hooks.json con la llave modules y register.js.
• Si te gustó uno hecho en la sesión, cópialo a una carpeta tuya y cárgalo con --plugin-dir.
• Se instala como un plugin: /plugin install nombre@marketplace.
• Corre con tus permisos. Revisa con claude plugin validate antes de instalar.

¿Quieres un mod para tu forma de trabajar?

Si te quedó alguna duda concreta: comenta MODS en el Reel o escríbeme por DM en @santaia.lab.