← Claude Code Hub
Oct 7, 2026 · 6 min de lectura ✦ Tip #221

Mods en Claude Code: dibuja tu propia interfaz dentro de Claude Code

Un mod es código JavaScript o TypeScript que corre dentro de Claude Code: dibuja una línea encima del prompt o un panel, y puede frenar una tool call. Claude te escribe uno a partir de una frase.

Un mod de Claude Code dibuja la barra de craft encima del prompt: tarea, fase, un cuadrado por slice y el agente que corre ahora

TL;DR Con la 2.1.287 o posterior, pide make a mod that shows the current git branch above the prompt, elige Turn them on (en los modos auto y bypass ni pregunta) y lo tienes al acabar el turno. Antes de instalar uno ajeno, claude plugin validate te dice qué toca.

Actualización, 10 de noviembre de 2026: La pregunta del paso 3 dice ahora Turn on the mods Claude writes in this session?, con Turn them on y Not now. Desde la v2.1.321, en los modos auto y bypassPermissions el mod se activa sin preguntar, y en dontAsk no se carga.

Un mod es un plugin de Claude Code escrito en JavaScript o TypeScript cuyas funciones corren dentro de Claude Code. Puede dibujar una línea encima del prompt o un panel junto a la conversación, añadir un comando que responde al momento sin gastar un turno de Claude, y frenar, reescribir o responder una tool call antes de que se ejecute. Funciona en el terminal desde la 2.1.287 y en la pestaña Code de Desktop desde la 2.1.286.

Para cualquiera con curiosidad que use Claude Code como harness, esto es un sueño: con TypeScript puedes añadir botones, paneles, vistas y animaciones, y capturar comandos y subagentes. La documentación es extensa y algo abstracta, y sus ejemplos son sencillos a propósito. Por eso lo he probado con algo real: una barra de estado para craft, mi plugin de desarrollo.

Dónde encaja un mod

Qué es Dónde corre
Hook de settings Un comando de shell, una petición HTTP o un prompt que se dispara en un evento Fuera de Claude Code
Skill Un markdown con instrucciones En lo que Claude lee
MCP Un servidor que le da herramientas a Claude Fuera, como proceso o servicio aparte
Mod Funciones que Claude Code llama en cada evento Dentro de Claude Code

Como vive dentro, cada hook de un mod decide qué pasa con su evento: lo observa y lo deja pasar, lo reescribe antes de que siga, o lo responde él y el comportamiento normal no llega a ejecutarse. Si dudas entre el resto de mecanismos, los 6 mecanismos de extensión los separa por la pregunta que responde cada uno.

Pídele un mod a Claude

1. Comprueba la versión

claude --version

2. Descríbelo en una frase

make a mod that shows the current git branch above the prompt

Claude trabaja con la skill integrada plugin-authoring (también la puedes cargar tú con /plugin-authoring) y escribe el mod en ~/.claude/dev-mods/<id-de-sesión>/. En los modos default y acceptEdits te pide aprobar cada archivo, porque ~/.claude es una ruta protegida.

3. Actívalo

Cuando Claude guarda el primer archivo, Claude Code pregunta Turn on the mods Claude writes in this session?. Elige Turn them on: el mod se carga al acabar el turno, se recarga cada vez que Claude lo cambia y la respuesta vale para toda la sesión, también si la retomas. Con Not now no se carga nada; los archivos se quedan y el mod se carga la próxima vez que arranque esa sesión. Lo ves en /plugin, pestaña Installed.

La pregunta depende del modo de permisos:

  • En auto y bypassPermissions no hay pregunta: desde la 2.1.321 el mod se activa solo al acabar el turno.
  • En dontAsk, y en un claude -p fuera de esos dos modos, no se carga, porque no hay nadie que lo apruebe.

4. Consérvalo

La carpeta de la sesión se borra con el tiempo. Copia el mod fuera y cárgalo donde quieras:

claude --plugin-dir ~/mods/git-branch

Este flujo es interactivo y no lo he capturado aquí: los pasos salen de la guía oficial y los textos de la pregunta, del propio binario de Claude Code.

Un caso real: la barra de craft

Craft lanza subagentes que construyen por fases y yo los dejo trabajando. Quería saber de un vistazo si algo se mueve, sin preguntarle a Claude y sin gastar un turno. El diseño es una línea encima del prompt con la tarea, su fase, un cuadrado por slice y el agente que corre ahora:

craft retry · implement · ■■■▣▣□ 3/6 · ⠋ draw 2:14 +1

Son cinco hooks en un solo archivo, hooks/register.ts, que hooks/hooks.json declara con { "modules": ["./register.ts"] }:

  • command.run con /^craft:/ apunta la fase cuando lanzo /craft:implement y deja que la skill siga como siempre.
  • agent.spawn con /^craft:/ añade el agente a la línea, y turn.complete con el mismo agentId lo quita y marca su slice como construida.
  • ui.render en AbovePrompt dibuja la línea con Box y Text, encima de lo que Claude Code ya pinta ahí.
  • /craft:bar off lo responde el propio mod, sin turno de Claude, y guarda la elección en $.store para todas las sesiones.
  • session.end vacía el estado al cerrar la sesión.
on('ui.render', { component: 'AbovePrompt' }, async ($, e, next) => {
  const line = pieces(state, await $.clock.now())
  if (e.props.hasSurvey || line.length === 0 || (await hidden($))) return next(e)
  const { Box, Text } = $.ui.resolve(e)
  const below = await next(e)
  const texts = line.map(piece => Text({ ...STYLES[piece.tone], children: piece.text }))
  return Box({ flexDirection: 'column', children: [Box({ key: BAR, children: Text({ children: texts }) }), below] })
})

El primer try real, en la 2.1.292, mostró esto mientras craft construía cuatro slices:

craft gamma · implement · □□□□ 0/4

Pasaron la tarea, la fase, los cuatro cuadrados, /craft:bar off y on, y que la barra no dibuje encima de la encuesta de Claude Code. Fallaron tres cosas: todos los agentes salían como build, porque el nombre de la slice va más abajo en su prompt; dos agentes lanzados en la misma décima de segundo se pisaban y no aparecía el +1; y los cuadrados nunca se ponían verdes, porque la primera versión los marcaba por el comando de su check y craft reescribe esos comandos. La lección: los eventos te dicen con certeza cuándo empieza y acaba un subagente; lo que va dentro de su prompt, no. La barra todavía vive en una rama de trabajo, no en la versión publicada de craft.

Antes de instalar uno ajeno

Un mod no tiene sandbox: corre con tus permisos, puede leer tus secretos, ver cada prompt y aprobar tool calls por ti. claude plugin validate lista qué eventos maneja y qué llamadas hace, sin ejecutarlo. Esta es la salida real sobre la barra de craft:

❯ ./register.ts hooks: command.run{command=/"^craft:"/}, agent.spawn{subagentType=/"^craft:"/}, turn.complete, session.end, ui.render{component=AbovePrompt}
❯ ./register.ts calls: $.clock.every (via tick), $.clock.now, $.fs.list (via folders), $.fs.read (via readSlices), $.session.root (via folders, readSlices), $.store.get (via hidden), $.store.set (via answerBar), $.ui.invalidate, $.ui.resolve

✔ Validation passed

Dos datos más: en el panel de chat de la extensión de VS Code y en claude -p los hooks corren, pero no se dibuja nada. Y /diff, que quizá ya usas, es un mod integrado: cc-plugin-diff. Otro, apagado por defecto, es You should know: un segundo agente que revisa tu sesión mientras Claude trabaja y te avisa de lo que se te puede escapar. Y easel dibuja gráficos en la terminal, cuando se lo pides o por su cuenta bajo tus MCP de métricas.

Documentación oficial: Mods overview

¿Te ha servido? Haz que wmedia.es te salga antes en Google.

Añadir wmedia.es como fuente preferida en Google
GUÍA GRATUITA

Aprueba menos, pero mejor.

A los diez minutos ya le das a «sí» sin leer. Eso no es revisar, es rezar. La guía de 10 páginas con las cinco palancas, en orden de riesgo.

  • 1. Reglas la primera que coincide gana
  • 2. Modo un dial, no un interruptor
  • 3. Auto mode un clasificador aprueba por ti
  • 4. Sandbox una valla del sistema operativo
  • 5. Bypass solo dentro de un contenedor
¿Eres desarrollador/a Web profesional?

Recibirás la guía por email · Cancela cuando quieras

de 10
#

Wmedia · 10 páginas
GUÍA GRATUITA · 10 páginas · 5 palancas

Aprueba menos, pero mejor.

A los diez minutos ya le das a «sí» sin leer. Eso no es revisar, es rezar. La guía de 10 páginas con las cinco palancas, en orden de riesgo.

¿Eres desarrollador/a Web profesional? · Cancela cuando quieras

¿Harto de aprobar permisos sin leer?