Descripción general de mods

​

Qué puede hacer un mod

• Dibujar una interfaz que pueda usar: un panel junto a la transcripción o una banda encima del mensaje, con pestañas, botones, y campos de texto. Vea Dibujar en la interfaz.
• Redibujar la propia interfaz de Claude Code: reemplazar o cambiar el estilo de partes que Claude Code dibuja a sí mismo, como la fila de una llamada de herramienta, el spinner, o el diálogo en el que Claude hace preguntas. Vea Cambiar lo que Claude Code ya dibuja.
• Intervenir en una llamada de herramienta o una solicitud: por ejemplo, mantener una llamada de herramienta mientras hace una pregunta al usuario, responderla sin ejecutar la herramienta, o enviar una solicitud a un modelo diferente. Vea Proteger o cambiar una llamada de herramienta y Seguir un turno.
• Ejecutar su propio código en un comando: un /command que ejecuta su función de inmediato, sin un turno de Claude, incluso mientras Claude está trabajando. Vea Agregar un comando o una herramienta.
• Compartir datos entre hooks: los hooks de un mod comparten las variables en su archivo, por lo que lo que un hook registra, otro puede mostrar. Por ejemplo, un hook puede contar llamadas de herramientas mientras otro muestra el conteo junto al spinner, o uno puede leer el uso de tokens de cada solicitud mientras otro lo grafica en un panel. Vea Reaccionar a eventos.

​

Obtener un mod

• Usar uno que ya tiene: algunas de las propias características de Claude Code son mods, como /diff. Vea Mods integrados en Claude Code.
• Hacer uno: describa lo que desea en una sesión de Claude Code, y Claude escribe el mod. Vea Pedir a Claude un mod. Para aprender cómo funciona el código de un mod, escriba uno usted mismo.
• Instalar uno: vea Instalar o actualizar un mod

​

Instalar o actualizar un mod

• En una sesión de Claude Code, ejecute /plugin install token-chart@your-org.
• En su shell, ejecute claude plugin install token-chart@your-org.

​

Decidir si confiar en un mod

​

A qué puede acceder un mod

• Actuar en su máquina como usted: leer y escribir archivos en cualquier lugar donde su cuenta de usuario pueda, iniciar programas, y hacer solicitudes de red
• Leer sus secretos: variables de entorno y archivos de configuración, incluida una clave API que mantenga en cualquiera de ellos
• Ver su sesión: cada mensaje que envía y cada llamada de herramienta que Claude hace
• Cambiar su sesión: reescribir un mensaje o una llamada de herramienta, enviar un mensaje como si lo hubiera escrito, o enviar un mensaje a otra de sus sesiones
• Actuar sin pedirle: aprobar una llamada de herramienta antes de que se le pregunte
• Gastar su uso: llamar a un modelo en su plan o clave API

​

Enumerar lo que hace un mod antes de instalarlo

claude plugin validate ./some-mod

​

Activar o desactivar mods

• Un mod: deshabilite o desinstale su plugin desde la pestaña Installed en /plugin
• Cada mod instalado, para una sesión: inicie Claude Code con --safe-mode, que también deja fuera sus otras personalizaciones
• Cada mod que instaló, en cada sesión: establezca "disableAllHooks": true en ~/.claude/settings.json. Sus settings hooks y línea de estado personalizada también se detienen. Lo que su organización administra sigue ejecutándose.

​

Ver qué mods cargó una sesión

​

Cómo funciona un mod

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

• plugin.json: el manifiesto del plugin
• hooks.json: apunta a su archivo de código
• register.js: su código, llamado el módulo de hooks. Le dice a Claude Code en qué eventos ejecutar sus funciones.

// The count, shared by the two hooks below
let calls = 0

// Claude Code calls this once when the mod loads
export function register(on) {
  // Runs each time Claude is about to use a tool
  on('tool.call', async ($, e, next) => {
    calls += 1
    // Ask Claude Code to draw the interface again, so the new count shows
    $.ui.invalidate('ui.render')
    // Let the tool run as usual
    return next(e)
  })

  // Runs each time Claude Code draws the spinner
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    // Keep Claude Code's spinner, with the count added after its word
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

• El hook tool.call se ejecuta cada vez que Claude está a punto de usar una herramienta. Suma uno a calls, le pide a Claude Code que dibuje la interfaz de nuevo, y deja que la herramienta se ejecute como de costumbre.
• El hook ui.render se ejecuta cada vez que Claude Code dibuja el spinner. Mantiene el propio spinner de Claude Code y agrega el conteo después de la palabra.

​

Qué puede hacer un hook con un evento

• Observar: notar qué está sucediendo y dejar que continúe sin cambios, como lo hace el hook tool.call en el ejemplo
• Reescribir: cambiar el evento antes de que continúe, como lo hace el hook ui.render cuando agrega el conteo al spinner
• Responder: manejar el evento a sí mismo, por lo que el comportamiento habitual no se ejecuta, como rechazar un comando

​

Dónde se ejecutan los mods

​

Controlar mods para su organización

​

Comparar mods, settings hooks, skills, y servidores MCP

​

Mods integrados en Claude Code

​

Leer la fuente de los mods integrados

• diff: el panel /diff, con botones vinculados a acciones de teclado y desplazamiento que el mod maneja a sí mismo
• agents-md: carga AGENTS.md como instrucciones del proyecto, con una opción userConfig
• sec-default: el guardia descrito en Saber qué sucede de forma predeterminada, un modelo para un mod que aplica política
• telemetry: agrega métodos que otros mods pueden llamar, y envía sus tipos

​

Próximos pasos

• Crear un mod: construya uno que cuente llamadas de herramientas, muestre el conteo junto al spinner, y agregue un comando, y aprenda el bucle de edición y recarga
• Dibujar en la interfaz: paneles, la banda encima del mensaje, botones, campos de texto, y estado
• Reaccionar a eventos: llamadas de herramientas, mensajes, turnos, y el orden en que se ejecutan los mods
• Usar la API de mods: comandos, herramientas, llamadas de modelo, temporizadores, y archivos
• Probar un mod: pruebas automatizadas que se ejecutan sin una sesión
• Solucionar problemas de un mod: las razones por las que un mod no hace nada, y el registro de depuración
• Administrar mods para su organización: valores predeterminados, configuración administrada, revisión de un mod, y mods de política
• Referencia de mods: cada evento, método, elemento, y límite