Referencia de comandos · Claude Code
/hooks
Muestra las configuraciones de hooks para eventos de herramientas.
/hooks abre un navegador de solo lectura para todos los hooks configurados actualmente: comandos de shell automatizados, llamadas HTTP, prompts, agentes o llamadas a herramientas MCP que se activan en momentos determinados del flujo de Claude Code, por ejemplo antes o después de una llamada a una herramienta. El menú lista cada evento de hook con el número de hooks configurados, permite desplegar matchers individuales y muestra para cada hook todos los detalles: evento, matcher, tipo y el comando, texto de prompt o URL exactos.
Cada entrada está además marcada con su origen: User (desde ~/.claude/settings.json), Project (.claude/settings.json), Local (.claude/settings.local.json), Plugin (desde un plugin instalado), Session (registrado solo para la sesión en curso) o Built-in (interno de Claude Code).
El comando no admite ningún argumento y no modifica nada - sirve exclusivamente para obtener una visión general, por ejemplo para comprobar por qué se bloqueó o modificó una llamada a una herramienta.
✅ ¿CUÁNDO USARLO?
Comprobar la configuración existente antes de añadir un nuevo hook
Ejecutar /hooks para ver si ya existe un matcher para PreToolUse que actúe sobre comandos Bash
Averiguar de qué archivo de configuración proviene un hook
Abrir /hooks y comprobar la marca de origen (User/Project/Local/Plugin) cuando un hook proviene de un plugin instalado
⛔ ¿CUÁNDO MEJOR NO?
Editar o reconfigurar reglas de hooks
según la documentación, /hooks es solo un navegador de lectura, no una interfaz de edición
Mejor: ajustar la configuración directamente en settings.json (o pedir que se ajuste), o usar el skill update-config
Averiguar por qué un hook configurado falla en tiempo de ejecución
/hooks solo muestra la configuración (evento, matcher, comando), no los errores en tiempo de ejecución - según la documentación, esos quedan registrados en el log de depuración
Mejor: usar /debug para consultar el log de depuración de la sesión con los mensajes de error de los hooks
FUENTES
- documentación de Claude Code (oficial) ↗ code.claude.com
MÁS COMANDOS · Claude Code