Programación y agentes de IA

[Claude Code #10] Guía de diagnóstico de /doctor, /context y /usage

Hemos recopilado seis comandos de diagnóstico de Claude Code: visualización del contexto con /context, uso con /usage, información de sesión con /status, comprobación de configuración con /doctor, seguimiento de registros con /debug e informes de patrones de uso con /insights.

4 min de lectura
Imagen de portada de [Claude Code #10] Guía de diagnóstico de /doctor, /context y /usage

Después de usar un agente de IA durante un tiempo, surgen preguntas inevitables: ¿cuánto contexto se ha llenado?, ¿cuánto he usado hoy?, ¿se habrá desconfigurado algo?

Claude Code incluye comandos de diagnóstico que responden a estas preguntas una por una. En esta entrega reuniremos los seis.

Si Claude Code, parte 9 trataba sobre cómo ponerlo a trabajar, esta vez trata sobre cómo mirar el panel de control.

/context: ¿cuánto contexto se ha llenado?

/context visualiza el uso actual del contexto mediante una cuadrícula de colores.

Según Documentación oficial de comandos, indica qué herramientas consumen más contexto. También muestra si la memoria ha crecido demasiado y si ha aparecido una advertencia de capacidad. Añade all para desplegar los detalles de cada elemento.

También sirve para comprobar si CLAUDE.md se ha cargado correctamente. Si no aparece en la lista Memory files, Claude no puede leer ese archivo.

/usage: ¿cuánto he usado hoy?

/usage muestra el uso de tokens, los costes y el estado del límite del plan según Documentación oficial de costes. Si escribes /cost, aparece la misma pantalla.

En un plan de suscripción, sirve para estimar cuánto del límite has consumido; con facturación por API, para saber cuánto cuesta la sesión. También muestra la proporción de uso por skill y servidor MCP, lo que facilita encontrar qué está consumiendo el límite.

/status: identifica la sesión actual

Al introducir /status se abre la pestaña Status de la pantalla de configuración. Puedes comprobar en un solo lugar la versión, el modelo, la cuenta de inicio de sesión y el estado de conexión.

Es la respuesta más rápida cuando te preguntas: «¿Con qué cuenta y qué modelo estoy trabajando ahora?». Se ejecuta al instante sin interrumpir una respuesta en curso.

Diagrama guía para elegir entre los seis comandos de diagnóstico de Claude Code según su uso
Si partes de la pregunta, el comando adecuado aparece enseguida

/doctor: revisión de salud de la configuración

/doctor es una revisión integral de toda la instalación y configuración (alias: /checkup). Incluso puede corregir los problemas que encuentre.

El alcance de la comprobación es bastante amplio.

  • Instalaciones duplicadas, problemas de PATH y archivos de configuración dañados
  • Skills, servidores MCP y plugins sin usar, junto con su coste de contexto
  • Hooks lentos y disponibilidad de nuevas versiones
  • Sugerencias para acortar un CLAUDE.md demasiado largo (v2.1.206 o posterior)

Primero informa de los hallazgos y solicita confirmación antes de corregirlos. Fuera de una sesión, al introducir claude doctor solo muestra diagnósticos de solo lectura. Conviene ejecutarlo aproximadamente una vez al mes.

/debug: cuando surge un problema

Si algo funciona de forma extraña, introduce /debug. A partir de ese momento activa los registros de depuración y los lee para rastrear el problema.

Añadir una explicación como «La conexión MCP se corta continuamente» ayuda a enfocar el análisis.

/insights: revisa tus patrones de uso

/insights crea un informe HTML que analiza las sesiones recientes de este ordenador.

Señala cómo lo usas en cada proyecto, dónde sueles quedarte bloqueado y qué funciones merece la pena probar. Es útil abrirlo de vez en cuando si quieres revisar tus propios hábitos de uso de herramientas.

Ilustración de un médico robot examinando un portátil con el texto MONTHLY CHECKUP
Ejecuta /doctor una vez al mes, como una revisión periódica

Resumen

Si agrupamos los seis por situación, quedan así.

  • Si te preocupa el espacio, usa /context; si te preocupa el dinero, /usage
  • Si te preocupa la identidad, /status; si te preocupa la salud, /doctor
  • Si hay un problema, /debug; si quieres revisar tus hábitos, /insights

En la próxima entrega trataremos los hooks que conectan automáticamente scripts antes y después de ejecutar comandos. Es el primer paso de los diagnósticos hacia la automatización.

Fuentes y criterios de verificación

Seguir leyendo

Serie de Claude Code

Temas relacionados