Crear plugin de Claude Code: comandos, hooks y mi primer mod
Crear plugin de Claude Code propio: manifiesto, un comando personalizado, un hook y después un mod. Lo primero que quiero hacer es un panel de entrega.

Crear plugin de Claude Code, uno tuyo, no instalar el de otro: de eso van estas notas. Si solo buscas cosas hechas para instalar, eso lo tengo en los mejores Claude Code mods que de verdad instalaría. Aquí es al revés, lo escribes tú. Un plugin puede ser tan pequeño como un solo comando personalizado. Puede llevar hooks. Y desde octubre puede llevar un mod, que es JavaScript corriendo dentro de Claude Code y que hasta dibuja paneles. Eso último fue lo que me animó, la verdad: Claude Code ya puede escribirse la extensión a sí mismo y cargarla en la sesión que tienes abierta.
Trabajar con IA suele incluir repetir las mismas instrucciones: “deja las fuentes”, “corre las pruebas cuando termines”, “dime qué falta”. Ahora podemos incorporar algunas de esas exigencias a la herramienta. Lo que más me interesa es no tener que estar tan encima de la IA.
En el anuncio del 1 de octubre de 2026, Anthropic resumió la idea en una frase:
“You can also use Claude Code to mod Claude Code.”
Anthropic · Customize Claude Code with mods
Cómo Claude Mods cambia Claude Code
Es decir, usar Claude Code para modificar el propio Claude Code. Suena a una IA que se mejora a sí misma, pero lo que se abre es la capa de software de Claude Code. El modelo no cambia por instalar un mod. Lo que puedes modificar son las herramientas que lo rodean, el flujo de trabajo y partes de la interfaz.
El mecanismo tampoco tiene mucho misterio. Enviar un prompt, llamar a una herramienta o dibujar la interfaz genera eventos. Un mod registra funciones en JavaScript o TypeScript para observar, modificar o tomar el control de esos eventos. Puede evaluar una llamada antes de ejecutarla, ordenar el resultado después y mostrar aparte la información que te importa. Las extensiones forman parte de plugins normales: se pueden instalar, compartir y escribir con ayuda de Claude. Los detalles están en la documentación oficial.
Skills, MCP y los hooks de Claude Code ya permitían darle instrucciones a la IA, conectarle herramientas y ejecutar scripts. Mods abre más partes de Claude Code, sobre todo la interfaz y la interacción. Puedes convertir tu forma de revisar el trabajo en un panel o un conjunto de botones que funcione dentro de la sesión. La comparación oficial de capacidades explica dónde encaja cada opción. Si estás viendo cómo crear plugin de Claude Code, aclara esto primero: un mod es un tipo de plugin, no otra cosa, y un mismo plugin puede llevar skills, hooks y un mod a la vez.
Si prefieres empezar con plugins ya hechos, el paquete oficial de skills de Anthropic y las recomendaciones de la comunidad están en nuestra lista de los mejores Claude Code mods.
Crear plugin de Claude Code: lo mínimo que funciona
Antes de tocar nada me leí la documentación oficial de plugins, y el plugin más pequeño es más pequeño de lo que pensaba. Es una carpeta. Dentro va .claude-plugin/plugin.json con un name (sin espacios, porque se convierte en el prefijo de todo lo que añade el plugin) y, si quieres, una descripción y una versión. Ese es el manifiesto. Todas las demás carpetas van al lado de .claude-plugin/, no dentro. La documentación lo repite varias veces, así que supongo que mucha gente se equivoca ahí.
Lo primero que metería es un comando personalizado. Los comandos personalizados de Claude Code se fusionaron con los skills, así que ahora creas skills/handoff/SKILL.md: unas líneas de YAML arriba (una description y, si solo quieres lanzarlo tú, disable-model-invocation: true) e instrucciones normales debajo. Dentro de un plugin aparece con su espacio de nombres, como /my-plugin:handoff. La carpeta antigua commands/ con archivos Markdown sueltos sigue funcionando, solo que es la forma vieja. El mío diría las tres frases que pego siempre, que al final es lo que son casi todos los comandos personalizados de Claude Code. Guarda las fuentes. Ejecuta las comprobaciones. Dime qué falta.
Los hooks de Claude Code son para reglas que tienen que cumplirse siempre, no cuando a Claude se le ocurra. En un plugin van en hooks/hooks.json, con la misma forma que el bloque hooks de un archivo de configuración. El ejemplo de la propia documentación es un hook PostToolUse con el matcher Write|Edit que pasa un linter después de cada edición. Ese lo copiaría casi tal cual: para empezar con los hooks de Claude Code no se me ocurre un ejemplo mejor.
Y luego el mod. Un mod es un plugin que además tiene un módulo de hooks: un hooks/register.js que exporta register(on) y escucha eventos como tool.call o ui.render. El ejemplo de Anthropic cuenta las llamadas a herramientas y pone el número junto al spinner, unas veinte líneas. En la terminal hace falta Claude Code v2.1.287 o posterior.
my-plugin/
├── .claude-plugin/plugin.json
├── skills/handoff/SKILL.md
└── hooks/
├── hooks.json
└── register.js
Mientras lo pruebas no necesitas ningún marketplace. claude plugin validate ./my-plugin revisa el manifiesto y el frontmatter, claude --plugin-dir ./my-plugin lo carga para una sola sesión y /reload-plugins recoge tus cambios sin reiniciar. O te ahorras teclear y describes lo que quieres, porque Claude Code trae un skill integrado, plugin-authoring, para escribir mods. Yo igual leería cada línea que escriba (al final explico por qué). Para crear plugin de Claude Code, eso es básicamente todo. Lo difícil es decidir qué merece ir dentro.
Si me piden resumir cómo crear plugin de Claude Code en pocas palabras, son cuatro pasos: escribir el manifiesto, añadir un skill para tu comando, meter los hooks de Claude Code en hooks/hooks.json para lo que tiene que pasar siempre y, solo si de verdad necesitas interfaz, escribir un mod. Cárgalo con --plugin-dir después de cada paso y siempre sabrás qué pieza falló.
3 ejemplos útiles de Claude Mods
Los tres ejemplos oficiales ayudan a aterrizarlo. Token Weather muestra el uso del contexto para que sepas cuándo conviene organizar la información. Blast Radius muestra el impacto previsto de ciertos comandos peligrosos antes de ejecutarlos y te deja continuar o cancelar. Replay Theater recorre, uno por uno, los cambios de la ronda anterior. Así es más fácil ver qué cambió exactamente.
Una lista de funciones no alcanza a explicar el valor de estos detalles. Hay quien necesita vigilar el contexto, quien revisa cada cambio y quien quiere leer las fuentes mientras arma sus conclusiones. Es difícil que un producto cubra los hábitos de todos. Ahora cada usuario puede completar esa parte alrededor de su trabajo y, si la extensión le funciona bien, compartirla. Los tres ejemplos sirven además como curso rápido para crear plugin de Claude Code, porque cada README cuenta cómo se hizo.
Claude Mods y DeepSeek Harness: las diferencias
DeepSeek ya venía explorando esa dirección. En el código de Harness de agosto de 2026, el adaptador del modelo, el registro de herramientas, el registro de sesiones y el ciclo de ejecución del agente ya estaban organizados como plugins. Una herramienta de plugins dinámicos de esa misma versión también permitía que la IA inspeccionara y ampliara el entorno en ejecución, incluida la interfaz web. En la presentación actual de DeepSeek, el modo Creator reúne la inspección del entorno, la experimentación y la creación de extensiones en un mismo flujo de uso.
El alcance de ambas propuestas es distinto. Claude Mods permite personalizar un Claude Code existente; DeepSeek Harness deja más componentes centrales en manos de una combinación de plugins. La cronología demuestra que DeepSeek tenía implementaciones relacionadas antes. Por sí sola, no demuestra quién tomó ideas de quién. El punto común que me interesa es que los usuarios ya pueden modificar también el entorno en el que trabaja la IA.
Qué dice la investigación sobre el trabajo con IA
Las herramientas y la forma de devolver los resultados influyen en lo que la IA consigue terminar. El estudio de SWE-agent ofrece un ejemplo concreto. Este trabajo de NeurIPS 2024 evaluó el mismo GPT-4 Turbo en las 300 tareas de SWE-bench Lite. En un entorno limitado al shell, con ejemplos, resolvió el 11% de las tareas. Con una interfaz diseñada para la interacción entre agente y computadora —una Agent-computer interface—, llegó al 18%: 7 puntos porcentuales más. El mismo trabajo comparó interfaces de edición: al incorporar comprobaciones de código, la tasa de resolución pasó del 15% al 18%. Los datos están en las tablas 1 y 3 del artículo.
Son resultados de un modelo anterior y de una evaluación específica. No sirven para ponerle una cifra de productividad a Mods hoy. Sí muestran que la organización de las herramientas y la información que recibe el agente cuando falla pueden cambiar cuánto logra resolver. Vale la pena diseñar bien ese ciclo: darle un resultado útil de la comprobación y dejarlo seguir corrigiendo.

Después hay que ver qué trabajo le ahorra a la persona. Una encuesta publicada por METR en mayo de 2026 incluyó a 349 trabajadores de áreas técnicas. La mediana del aumento de velocidad que reportaron fue de 3 veces; al preguntar de tres formas distintas por el “valor del trabajo”, las medianas reportadas quedaron entre 1.4 y 2 veces. Son estimaciones de los participantes, y la muestra tiene sesgo de selección. No son beneficios medidos con un cronómetro. La encuesta original explica el método. Para mí, estos datos recuerdan que trabajar más rápido, producir más y entregar algo más valioso son cosas que conviene evaluar por separado.
Mi criterio para Claude Mods es bastante simple: después de instalar una extensión, ¿necesito menos preguntas de seguimiento, reviso menos pantallas de registros o me ahorro una ronda de correcciones? Si la IA produce mucho en cada turno, pero yo paso más tiempo arreglando lo que deja pendiente, esa extensión no me interesa demasiado. Cuando evalúo un agente, también cuento el trabajo que me deja después de la entrega. Si genera código en segundos y luego me deja una hora de limpieza, esa hora entra en la cuenta.
El primer plugin que quiero escribir: un panel de entrega
Aquí es donde crear plugin de Claude Code deja de ser teoría para mí. Lo primero que me gustaría construir es un “panel de entrega”. No necesita ser espectacular. Basta con dejar claras tres cosas:
- Qué cambió: los archivos, las páginas donde se puede revisar y las diferencias reales.
- Qué verificó: las comprobaciones que ejecutó, sus resultados originales y las que fallaron.
- Qué falta: lo que no revisó y las decisiones que necesito tomar yo.

Si le pido a la IA que arregle el cambio de idioma en Binmage, quiero saber si probó los tres idiomas, si revisó la versión móvil y si reprodujo el problema de la carga inicial. Quiero abrir el resultado y comprobarlo. Si algo no se probó, debe decirlo. Así recibo una entrega que puedo revisar paso a paso, sin tener que adivinar el estado del trabajo entre una larga lista de “optimizado”, “corregido” y “completado”.
Qué revisar antes de instalar Claude Mods
Ahí hace falta otra comprobación: la información que resume el panel debe tener una fuente verificable. La documentación oficial explica que Mods puede reescribir los resultados de las herramientas e incluso modificar entradas del registro de sesión antes de que se guarden. Para una publicación o un despliegue importante, seguiría dejando las verificaciones a un sistema de integración continua (CI) con permisos separados o a un programa de comprobación protegido. El panel me mostraría los resultados. No me daría confianza que el reporte de “trabajo terminado” y la aprobación dependieran del mismo registro que se puede reescribir. No es una preocupación teórica: en InnovationEval, un informe de investigación hecho por IA no coincidía con sus propias notas de trabajo.
Instalar una extensión también significa instalar código. Saber crear plugin de Claude Code tú mismo no lo vuelve seguro solo porque sea tuyo. Mods utiliza los permisos de tu cuenta para leer y escribir archivos, iniciar procesos y conectarse a la red. Anthropic dice explícitamente que no tiene un entorno aislado de seguridad. El código escrito con ayuda de la IA también necesita revisión. Un panel bonito no significa que el código que hay detrás sea seguro.
Este panel de entrega sigue siendo una idea mía, y lo que cuento sobre crear plugin de Claude Code sale de la documentación, no de un repositorio mío. Cuando lo construya, lo probaré con cambios reales en el sitio: si necesito menos preguntas de seguimiento, si detecto antes lo que quedó sin terminar y si es fácil volver a ejecutar las comprobaciones. Si me deja supervisar menos sin que se me escapen problemas, tendrá un lugar en mi flujo de trabajo.
Si te animas a probarlo, empieza más pequeño de lo que crees: un skill, un hook, --plugin-dir y listo. Así es como yo empezaría a crear plugin de Claude Code: primero haz que funcione lo básico y después añade el mod.
Actualización del 24 de octubre de 2026: geckobox lleva tu plugin de Claude Code a varias máquinas
Cuando ya sabes crear plugin de Claude Code, lo siguiente suele ser querer que el agente trabaje en otra máquina además de tu portátil. geckobox (su CLI se llama openspaces) es una herramienta nueva de código abierto para eso, con licencia MIT. Según su README, ejecuta Claude Code y otros agentes de programación en tu propio equipo, en cualquier máquina a la que llegues por SSH o dentro de un contenedor Docker, y un solo comando reparte la misma tarea entre varias máquinas a la vez. El README también dice que no pide cuenta ni usa relay: se conecta directamente a tus máquinas (para equipos detrás de NAT sugiere Tailscale).
Se instala con un solo comando de npm (necesita Node 20 o superior). openspaces ui abre un panel local en 127.0.0.1, y lo mismo se puede hacer desde la terminal:
npm install -g github:migasrias2/geckobox
openspaces ui
# o desde la línea de comandos
openspaces computers add mini ssh:[email protected]
openspaces run --on local,mini,docker:ci "ejecuta los tests y resume los fallos"
Conviene ajustar las expectativas a lo nuevo que es: versión 0.1.0, y el repositorio se creó el 20 de octubre de 2026. Según el README, solo los adaptadores claude-code y shell se han probado en vivo; los de Codex, Gemini y OpenCode, no. Yo tampoco lo he probado todavía en mis máquinas.
Para quién es: para quien ya tiene un Mac mini libre, un VPS o un servidor con Docker y quiere mandar la misma tarea (pasar los tests, revisar un despliegue, liberar disco) a todos a la vez sin darse de alta en un servicio alojado. Si trabajas con un solo portátil, no lo necesitas.
El riesgo merece párrafo propio. --auto-approve le da al agente permisos completos: en el código de geckobox equivale a --dangerously-skip-permissions de Claude Code (y a --dangerously-bypass-approvals-and-sandbox de Codex). Súmale el reparto entre máquinas y una instrucción mal escrita, o una web que le cuele órdenes al agente, puede ejecutar comandos arbitrarios en varias máquinas a la vez. Según el README, por defecto solo se saltan las confirmaciones en destinos docker: y cua:, mientras que local y ssh: usan el modo acceptEdits de Claude Code. Al principio, déjalo así: pruébalo en Docker o en una máquina de pruebas y no lo acerques a equipos con claves de producción o datos de clientes.
El README lo presenta como una alternativa independiente, sin relación con Cua, al servicio de pago Cua Spaces. La diferencia que se puede comprobar: en la página de precios de Cua, el plan gratuito incluye 2 sesiones en vivo y 20 horas remotas al mes a través de su relay alojado, y Pro cuesta 15 dólares al mes con pago anual (18 mensual) por 5 sesiones y 200 horas, aunque los espacios a los que llegas desde tu propia red no pasan por el relay ni cuentan; geckobox, según su README, no tiene relay, así que no hay nada que medir.
El repositorio:
Fuentes verificadas el 3 de octubre de 2026; documentación de plugins, skills y hooks revisada de nuevo el 20 de octubre de 2026. Este artículo se basa en documentación oficial, versiones históricas del código y estudios originales. Todavía no he probado Mods ni Creator de forma independiente; el panel de entrega es una propuesta del autor.
Sigue leyendo: más guías de Claude, más guías de DeepSeek y comparativa de precios de suscripciones de IA.