Primeros pasos con Modyard

#Qué es un mod

Un mod de Claude Code es un plugin que usa hooks de función: un módulo pequeño en TypeScript que Claude Code carga y llama cuando pasa algo, como una llamada a una herramienta, un prompt enviado o el inicio de una sesión. Con eso un mod puede enseñar una línea de estado, frenar un comando peligroso, reescribir la entrada de una herramienta o añadir un comando propio. Los hooks de función necesitan Claude Code 2.1.287 o posterior, así que mira tu versión antes de empezar:

claude --version

Modyard es donde los publicadores comparten esos mods. Los buscas en la página de mods, lees su código allí mismo y los instalas desde Claude Code. Para instalar no necesitas cuenta; solo para publicar.

#Encuentra un mod

Entra en la página de mods y busca por nombre o descripción. En la ficha de cada mod tienes:

• el publicador al que pertenece, que es también el marketplace desde el que lo instalas;
• sus versiones, de la más reciente a la más antigua;
• qué puede tocar: categorías como ficheros, red o procesos, sacadas de su código;
• todos sus ficheros, para leerlos sin salir de la página.

En esta guía vamos a usar un mod de ejemplo, bash-logger, del publicador ana. Lo que hace es enseñar en la línea de estado el principio de cada comando Bash que lanza Claude.

#Instálalo en dos comandos

En Modyard cada publicador es su propio marketplace de Claude Code. Primero añades el de ana. Este comando se escribe dentro de Claude Code, en el prompt:

/plugin marketplace add https://mods.gonzaloverdugo.com/publishers/ana/marketplace.json

Después instalas el mod desde la terminal. Lo que va detrás de la @ es el nombre del marketplace, que siempre coincide con el slug del publicador:

claude plugin install bash-logger@ana --scope user

Con --scope user el mod queda disponible en todos tus proyectos. Si lo quieres solo en el repositorio en el que estás, usa --scope project y viajará con la configuración del proyecto.

Y ya está: la siguiente sesión lo carga. Claude Code descarga de Modyard el archivo de esa versión y comprueba su sha256 con el que figura en el marketplace antes de instalar nada, así que recibes exactamente los ficheros que el marketplace describe.

#Qué mirar antes de instalar

Un mod se ejecuta dentro de Claude Code con tus permisos. Puede hacer lo mismo que tú en tu máquina, así que trata cada instalación como si añadieras una dependencia a un proyecto. Antes, revisa tres cosas:

1. Qué puede tocar. Si bash-logger dice que toca display y tool calls, encaja con lo que promete. Si además apareciera network o processes, querrías saber por qué antes de seguir. Esa lista te ayuda a leer, pero no garantiza nada: en qué puede tocar un mod tienes cómo se calcula y dónde se queda corta.
2. El código. Abre los ficheros en la ficha del mod. Lo normal es un register.tsx de unas decenas de líneas. Fíjate en qué hooks registra y qué hace cada uno con el evento.
3. El publicador. Importa más quién es el dueño del marketplace que cómo se llama el mod. Cuando añades el marketplace de ana, las actualizaciones te llegan de ana. En marketplaces por publicador te contamos por qué cada publicador va por separado y qué supone eso para la confianza.

Si algo no te cuadra, no lo instales. En Modyard nadie revisa la seguridad de los mods por ti.

#Mantenlo al día

Las versiones nuevas te llegan cuando refrescas el marketplace del publicador, otra vez dentro de Claude Code:

/plugin marketplace update ana

En Modyard las versiones no se pueden modificar: una vez existe bash-logger 0.1.0, sus ficheros no cambian nunca. Cualquier arreglo sale como una versión nueva y mayor, de modo que el código que leíste para la 0.1.0 es el que se ejecuta con la 0.1.0. Cuando llegue una actualización, échale un vistazo a lo que ha cambiado antes de aceptarla.

#Pruébalo sin instalarlo

Si tienes la carpeta del mod en local (por ejemplo, porque la has descargado para leerla), puedes cargarla en una sola sesión sin instalar nada:

claude --plugin-dir ./bash-logger

Es también lo que usan los publicadores para probar sus mods mientras los escriben.

#Desinstálalo

Igual que lo instalaste:

claude plugin uninstall bash-logger@ana

El marketplace de ana se queda añadido, por si quieres instalar otros mods suyos. Para quitarlo también, entra en el menú /plugin de Claude Code.

#Siguientes pasos

• Lee qué puede tocar un mod antes de instalar algo que no entiendas del todo.
• ¿Quieres compartir uno tuyo? En escribe tu primer mod construyes bash-logger desde una carpeta vacía, y en publica un mod lo subes a Modyard.
• Si trabajas con un agente, en usa Modyard desde un agente ves cómo Claude puede buscar y leer mods por ti.