Auditoría de prompts en Claude Code: tutorial de /doctor prompt-audit
Cómo auditar tu configuración de Claude Code en busca de prompts escritos para modelos anteriores: actualiza a 2.1.283, ejecuta /doctor prompt-audit en un proyecto real, lee el informe de nueve comprobaciones y aprueba solo las correcciones que quieras.
La auditoría de prompts en cuatro líneas
- La auditoría de prompts es un subcomando del chequeo de configuración /doctor: ejecuta /doctor prompt-audit (o /checkup prompt-audit) dentro de una sesión de Claude Code.
- Revisa tus archivos CLAUDE.md, skills, agentes y comandos en busca de patrones de prompting escritos para modelos anteriores, y pone al frente las rutas obsoletas, los comandos obsoletos y los archivos de instrucciones contradictorios.
- Llegó en Claude Code 2.1.283, así que actualiza primero: una versión anterior responde a /doctor con un error de subcomando desconocido en lugar de un informe.
- El chequeo informa primero y pregunta antes de cambiar nada; si solo quieres una pasada de lectura, ejecuta claude doctor en una terminal.
Anthropic just dropped the new Checkup command (/doctor)
Canal:Software Engineer Meets AI2:18
Claude Code 2.1.283 — Prompt Audits & Windows Fix
Canal:Claude Code Updates1:02
Claude Code v2.1.283 — Advanced Model Control and Auditing
Canal:Claude Code Changelog2:10
Claude Code changelog — 2.1.283 adds /doctor prompt-audit
Docs:github.com/anthropics/claude-codeChangelog
Claude Code commands reference — /doctor, /checkup and /claude-api
Docs:code.claude.comDocs
Las capturas provienen de tres grabaciones. Software Engineer Meets AI grabó un chequeo /doctor completo en la v2.1.205; el subcomando prompt-audit y su alcance se anunciaron en la v2.1.283 y comparten esa misma interfaz de chequeo. Claude Code Updates y Claude Code Changelog aportaron los fotogramas del lanzamiento 2.1.283. Cada fotograma se revisó a mano; los dos fotogramas de diapositiva se recortaron para quitar las marcas de agua de los canales.
Las capturas siguen siendo propiedad de los canales citados arriba y se usan para ilustrar nuestras propias instrucciones escritas, con cada paso enlazado a su minuto exacto.
Ejecutar la auditoría de prompts de Claude Code, paso a paso
Antes de ejecutarla
- 1
Actualiza Claude Code a 2.1.283 o superior
Ejecuta /doctor prompt-audit solo en una versión que lo incluya. Comprueba la versión en tu terminal con claude --version y actualiza con claude update si es anterior a 2.1.283 — la versión que añadió la auditoría. Dentro de una sesión, la comprobación de versión de /doctor (comprobación 6) contrasta la versión instalada con tu canal de lanzamiento.
«Prompt Audit» aparece en primer lugar en el lanzamiento 2.1.283, así que una versión sin él no puede responder al comando.Ver en 0:08 - 2
Entiende por qué los patrones antiguos necesitan auditoría
Las instrucciones escritas para un modelo anterior se acumulan en archivos de memoria, skills, agentes y comandos, y siguen dando forma a cada sesión mucho después de que el modelo para el que se ajustaron haya desaparecido. La auditoría existe para sacar a la luz esos patrones obsoletos y que sepas exactamente qué reescribir en lugar de adivinar.
La tarjeta explica cómo se acumulan esas instrucciones: archivos de memoria, skills, agentes y comandos.Ver en 0:12 - 3
Aprende el comando exacto y su alcance de revisión
El comando es /doctor prompt-audit, y /checkup prompt-audit es lo mismo porque /checkup es un alias de /doctor. Su alcance es tu configuración de Claude Code: archivos CLAUDE.md, skills, agentes y comandos. Es un subcomando del chequeo de configuración, no un plugin aparte ni una instalación desde un marketplace.
La diapositiva del lanzamiento muestra un solo argumento en un comando que ya existe: no hay nada que instalar.Ver en 1:02
Ejecutar la auditoría en una sesión activa
- 4
Abre Claude Code en el proyecto que quieres auditar
Inicia la sesión en la raíz del proyecto. La auditoría lee la configuración que ese proyecto carga de verdad, así que una sesión abierta en una carpeta superior auditará los archivos CLAUDE.md equivocados. La línea de cabecera confirma el directorio y el modelo antes de que escribas nada.
El directorio de trabajo de la cabecera de la sesión marca el alcance de la auditoría.Ver en 1:00 - 5
Escribe el comando y déjalo trabajar en solo lectura
Escribe /doctor prompt-audit en el prompt. El chequeo declara su método antes de empezar: primero ejecuta el chequeo de salud en solo lectura y presenta un informe antes de cambiar nada. Cuenta con varios turnos de lectura de archivos y comandos de shell mientras reúne pruebas — es normal, no está colgado.
La promesa de solo lectura llega antes de cualquier propuesta: no se escribe nada mientras investiga.Ver en 0:30 - 6
Míralo reunir datos para cada comprobación
La transcripción muestra a qué comprobación alimenta cada comando: la última versión para la comprobación 6, directorios de skills y configuración de hooks para las comprobaciones de extensiones, archivos CLAUDE.md pequeños para las comprobaciones 2 y 3, y transcripciones de sesiones recientes para las comprobaciones 1, 4 y 8. Si un hook bloquea un comando, el chequeo reformula los datos que necesita y lo reintenta en lugar de fallar.
Cada comando que ejecuta está asociado a una comprobación numerada.Ver en 0:36
Leer el informe
- 7
Conoce las nueve comprobaciones que puede cubrir el informe
La comprobación 0 es la salud de la instalación, la 1 las extensiones sin usar, la 2 la limpieza de duplicados en la memoria LOCAL, la 3 la migración del contenido que siempre se carga, la 4 los hooks lentos, la 5 las extensiones que consumen mucho contexto, la 6 la versión, la 7 el modo auto como modo de permisos por defecto y la 8 los comandos de solo lectura que se deniegan con frecuencia. Para una auditoría de prompts, las comprobaciones de archivos de instrucciones son las que más importan: la 2 encuentra notas personales que duplican o contradicen las guías del equipo versionadas en el repositorio, y la 3 saca del contexto siempre activo las guías que casi nunca se necesitan.
Las comprobaciones 2, 3 y 5 son las que tocan CLAUDE.md y otros archivos de instrucciones.Ver en 1:16 - 8
Lee primero la sección «Proposed actions»
«Proposed actions» es la parte del informe que cambiaría archivos, y cada entrada nombra el archivo que edita y si el cambio es reversible. Una comprobación sana se marca y se cierra con «No action», así que ves de un vistazo cuáles de las nueve encontraron algo y cuáles no.
Lee la ruta del archivo en cada propuesta antes de decidir: ahí es donde cae la edición.Ver en 0:40 - 9
Lee los avisos y las dos preguntas de confirmación
Debajo de las propuestas hay un bloque «Warnings (no action)» para lo que la auditoría midió pero no va a cambiar — hooks lentos y extensiones que consumen mucho contexto, con las cifras medidas para que las juzgues tú. El informe termina planteándote sus preguntas de confirmación en lugar de dar por sentada una respuesta.
Los avisos son mediciones, no ediciones: traen números, no propuestas.Ver en 0:56
Aprobar y repetir
- 10
Aprueba, elige o rechaza antes de que se escriba nada
El chequeo termina con un menú: «Clean up everything» (recomendado), «Let me pick», «No, keep everything», «Type something» y «Chat about this». La opción recomendada aplica todas las propuestas, «Let me pick» recorre la lista punto por punto y «No, keep everything» deja cada archivo intacto. Nada se aplica solo con el informe.
El valor por defecto es una pregunta, no una edición: ese es todo el modelo de seguridad.Ver en 0:52 - 11
Pon la auditoría en un recordatorio mensual
La auditoría es lo bastante barata para repetirla, pero nada en Claude Code la ejecutará por ti según un calendario: /schedule crea una tarea en la nube y /loop solo corre mientras la sesión sigue viva. La respuesta práctica es un evento recurrente en tu calendario que te recuerde volver a ejecutarla: cada mes, o después de una actualización de modelo que deje obsoletos tus patrones antiguos.
Un recordatorio mensual es el único planificador que sobrevive a los reinicios.Ver en 2:08
Los cinco fallos con los que sí te vas a topar
La mayoría de los reportes de una auditoría de prompts rota son uno de estos casos. Revísalos en orden antes de dar por hecho que falta el comando.
- 1Comando desconocido o ninguna entrada prompt-audit: tu versión es anterior a 2.1.283. Ejecuta claude --version, actualiza con claude update y luego abre una sesión nueva para que cargue la versión nueva.
- 2/checkup prompt-audit o /doctor prompt-audit: son el mismo comando. /checkup está documentado como alias de /doctor, así que cualquiera de los dos prefijos llega a la misma skill de chequeo.
- 3/claude-api prompt-audit es otro subcomando con otro objetivo. Audita los prompts, las skills y las descripciones de herramientas de tu propio código de aplicación con Claude API y propone correcciones como diff; necesita Claude Code 2.1.221 o posterior, no 2.1.283, y no va a mirar tus archivos CLAUDE.md.
- 4La auditoría no dice nada de tus archivos de instrucciones: o de verdad son ligeros, o nunca se cargaron. Ejecuta /context para ver qué archivos de memoria y qué skills están realmente en el contexto, y confirma que iniciaste la sesión en la raíz del proyecto.
- 5Quieres una pasada de solo lectura sin ninguna sesión: ejecuta claude doctor en tu terminal. Imprime diagnósticos de instalación y ajustes sin iniciar una sesión, mientras que el /doctor dentro de la sesión es la versión que puede proponer y aplicar correcciones.