Depurar con Claude
Cuando algo se rompe, Claude es tu compañero de debugging
⏱ Estim. ~7 min
01 · Leer
Las cosas se rompen. Eso no es un fracaso: es parte normal de construir software. La diferencia entre un principiante y un ingeniero con experiencia no es que los experimentados nunca tengan errores. Es que saben cómo describir el problema con claridad y encontrar arreglos de forma efectiva.
Claude Code es un excelente compañero de debugging. Pero solo te puede ayudar si le dices qué salió mal. Descripciones vagas como "no funciona" le dan a Claude muy pocas pistas. Descripciones específicas como "el formulario se envía pero el mensaje de éxito nunca aparece" apuntan directo al problema.
El patrón clave para reportar bugs: esperaba X, obtuve Y, intenté esto.
02 · Plantilla de prompt
Cuando veas un error en la terminal, copia y pega el mensaje exacto a Claude. No lo parafrasees: el texto exacto tiene pistas importantes como nombres de archivos, números de línea y códigos de error.
Al ejecutar el servidor me apareció este error: {{error_message}}03 · Plantilla de prompt
No todos los bugs tienen un mensaje de error. A veces solo se ve raro en el navegador. Para bugs visuales, describe lo que ves vs. lo que esperabas.
{{element}} ahora está {{problem}}, pero debería estar {{expected}}04 · Quiz
Cuando reportas un bug a Claude, ¿qué deberías incluir siempre?
- Tu sistema operativo
- El nombre de tu editor
- El mensaje de error exacto
- La hora actual
05 · Completar
Al describir un bug, usa el patrón: "esperaba _____, pero obtuve Y".
06 · Leer
Describir problemas con claridad es la verdadera habilidad: te hace mejor colaborando tanto con IA como con compañeros humanos.
Puntos clave
- Describir el problema con claridad es la habilidad de debugging más importante
- Patrón mágico: "esperaba X, obtuve Y, intenté esto"
- Copia el mensaje de error exacto: no lo parafrasees
- Para bugs visuales, describe lo que ves vs. lo que esperabas
- Incluye contexto: ¿qué estabas haciendo cuando se rompió?
07 · Quiz
En tu página web hay un botón que debería mostrar un mensaje de éxito al hacer clic, pero no pasa nada. ¿Qué reporte de bug ayuda a Claude a arreglarlo más rápido?
- El botón no funciona
- Hay un problema con mi página, ¿puedes arreglarlo?
- Por favor arregla el JavaScript
- El botón de enviar en index.html no responde al hacer clic. Esperaba que apareciera un mensaje de éxito debajo del formulario, pero no aparece nada. La consola no muestra errores.
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.