Mods de herramientas personalizadas para Claude Code: dale nuevas herramientas a Claude

Los mods de herramientas personalizadas para Claude Code le dan a Claude herramientas nuevas que puede llamar durante un turno, como una búsqueda específica de tu proyecto, una consulta a tu gestor de incidencias o una calculadora para algo que importa en tu código. La herramienta está escrita en JavaScript dentro del mod y se ejecuta en Claude Code, así que no hay ningún proceso de servidor aparte que arrancar.

¿Cómo añaden una herramienta los mods de herramientas personalizadas para Claude Code?#

Un mod llama a $.tool.register(...) con un nombre y una descripción que Claude lee, además de la entrada que acepta. Cuando Claude decide usar la herramienta, la llamada pasa por el evento tool.call como cualquier herramienta integrada, y el mod la responde devolviendo { result }. $.tool.list() muestra lo que hay disponible y $.tool.call() permite que un mod invoque una herramienta por sí mismo.

Aquí importan otros dos eventos. tool.describe se dispara cuando la descripción de una herramienta se envía a Claude por primera vez; un mod puede reescribir el texto o marcar la herramienta como diferida para que no ocupe contexto hasta que haga falta. agent.offer y $.agent.register hacen lo mismo con los tipos de subagente. La referencia de la API documenta los métodos $.tool y $.agent.

¿Qué deberías revisar antes de instalar uno?#

Un mod de herramienta muestra Añade comandos/herramientas. El resto de sus insignias te dicen a qué puede llegar la herramienta. Una herramienta que consulta una API web muestra Red; una que busca en archivos muestra Lee archivos; una que ejecuta un linter muestra Ejecuta comandos. Como es Claude quien decide cuándo llamar a la herramienta, esas capacidades pueden usarse en cualquier turno, no solo cuando tú lo pides, así que revísalas como si Claude tuviera acceso directo a ellas.

Comprueba también cómo informa de los errores. Una buena herramienta devuelve un mensaje de error claro como resultado en lugar de lanzar una excepción, para que Claude pueda recuperarse.

Mods de herramientas frente a servidores MCP#

Los servidores MCP son la forma estándar de dar herramientas a Claude y funcionan con muchos clientes. Un mod de herramienta es más limitado: solo funciona en Claude Code, pero no necesita ningún paso de instalación aparte del plugin, arranca con la sesión y puede compartir estado con el resto del mod, por ejemplo con una barra de estado que muestra cuántas veces se ha usado la herramienta.