promptgarten 🌱

Referencia de comandos · Claude Code

/debug

Activa el debug logging para la sesión actual y ayuda en la búsqueda de errores mediante el session debug log.

/debug [descripción] es un skill integrado que activa el registro de depuración para la sesión actual y luego ayuda a analizar el log de depuración de la sesión para encontrar la causa de un problema. El registro de depuración está desactivado de forma predeterminada, salvo que la sesión se haya iniciado con claude --debug; si /debug se invoca a mitad de la sesión, los registros se recogen solo a partir de ese momento — los eventos anteriores faltan en el log. Opcionalmente se puede añadir una descripción del problema para enfocar el análisis posterior, por ejemplo en un servidor MCP concreto, una única llamada a herramienta o un problema de hook. /debug se diferencia de otros comandos de diagnóstico relacionados: /doctor revisa de forma integral la instalación, la configuración y la puesta a punto, y puede corregir por sí mismo algunos de los problemas encontrados; /heapdump escribe, en caso de alto consumo de memoria, una instantánea del heap de JavaScript junto con un desglose de memoria en ~/Desktop. /debug, en cambio, está pensado específicamente para rastrear problemas de tiempo de ejecución dentro de una sesión en curso, como desconexiones con servidores MCP o un comportamiento inesperado de una herramienta que de otro modo sería difícil de reproducir.

¿CUÁNDO USARLO?

Registrar desde ya un problema reproducible

/debug MCP server keeps disconnecting — justo antes de volver a provocar el problema.

Activar el registro de forma sistemática antes de una búsqueda de errores difícil de rastrear

Ejecutar /debug para registrar las llamadas a herramientas y los errores en el log de depuración de la sesión, antes de probar el siguiente paso.

¿CUÁNDO MEJOR NO?

El error ya ocurrió antes

/debug registra los logs solo a partir del momento de activación; los eventos anteriores faltan en el log.

Mejor: Reiniciar la sesión con claude --debug para registrar desde el principio.

Diagnosticar problemas de instalación o errores de configuración

/debug se ocupa del comportamiento en tiempo de ejecución de la sesión actual, no de la instalación, problemas de PATH o archivos de configuración defectuosos.

Mejor: Usar /doctor, que realiza una revisión de la configuración y corrige algunos problemas automáticamente.

FUENTES

MÁS COMANDOS · Claude Code

/deep-research/design-login/design-sync/desktop/diff/doctor/effort/exit/export/fast/feedback/fewer-permission-prompts

Todos los comandos · Claude Code

Compartir:𝕏in💬