Saltar al contenido
claudemods

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

Los mods de herramientas personalizadas para Claude Code registran herramientas nuevas que Claude puede llamar, escritas en JavaScript, sin un servidor MCP.

Diff funcionando en Claude CodeDestacado

Diff

Un panel /diff para Claude Code: cambios sin confirmar, archivo por archivo con sus hunks, siempre al día.

  • panel
  • Lee archivos
  • Ejecuta comandos
  • Intercepta llamadas a herramientas
  • Lee tus prompts
  • Modifica la interfaz
  • Añade comandos/herramientas
  • Guarda datos

probado con v2.1.310

Human in the loop funcionando en Claude CodeDestacado

Human in the loop

Claude te asigna las tareas que solo tú puedes hacer. Esperan en My tasks, contadas bajo el prompt.

  • panel
  • estado
  • aviso
  • transcripción
  • Intercepta llamadas a herramientas
  • Lee tus prompts
  • Modifica la interfaz
  • Añade comandos/herramientas
  • Guarda datos

probado con v2.1.310

Secret Redactor funcionando en Claude CodeDestacado

Secret Redactor

Cambia claves, correos e IP públicas por marcadores antes de que Claude los vea y los restaura en las herramientas.

  • aviso
  • Intercepta llamadas a herramientas
  • Lee tus prompts
  • Modifica la interfaz

probado con v2.1.291

>_ terminal-browser

terminal-browser

Abre un navegador web real en un panel de Claude Code con /browser, dibujado con el protocolo de gráficos de kitty.

  • panel
  • Lee archivos
  • Ejecuta comandos
  • Red
  • Intercepta llamadas a herramientas
  • Modifica la interfaz
  • Añade comandos/herramientas

probado con v2.1.310

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.

Preguntas frecuentes

¿Debería crear un mod de herramienta o un servidor MCP?
Usa un servidor MCP cuando la herramienta tenga que funcionar con otros clientes o se ejecute como un servicio aparte. Un mod de herramienta es más sencillo cuando la herramienta solo necesita Claude Code y unas pocas líneas de JavaScript.
¿Las herramientas personalizadas consumen más tokens?
La descripción de cada herramienta se envía a Claude, así que cada una añade un poco al contexto. Los mods pueden marcar una herramienta como diferida mediante tool.describe para que su descripción solo se cargue cuando haga falta.
¿Puede un mod de herramienta ver mis otras llamadas a herramientas?
Solo si también se engancha a tool.call. Registrar una herramienta con $.tool.register no permite por sí solo que un mod observe otras herramientas; las insignias de permisos indican si intercepta llamadas a herramientas.