Clase 07 · Módulo 05
Revisar y depurar lo que Claude construye
Revisar y depurar lo que Claude construye
Qué logras en esta clase
Dejas de depender de que Claude acierte a la primera.
- Revisas un cambio antes de aceptarlo.
- Sabes dónde aparece cada tipo de error y cómo leerlo.
- Entregas reportes que se corrigen en un intento.
- Reconoces cuándo conviene volver atrás en vez de insistir.
02
Claude escribe; tú respondes por el resultado
Que el código exista no significa que funcione. Lo que no comprobaste, no está hecho.
03
Dos trabajos distintos
| Trabajo | Cuándo | Pregunta |
|---|---|---|
| Revisar | Antes de aceptar un cambio | ¿Hizo lo que pedí y nada más? |
| Depurar | Cuando algo falla | ¿Qué falla exactamente y dónde? |
Revisar bien reduce cuánto tienes que depurar. Depurar es encontrar la causa de un error; corregir viene después.
04
Qué mirar en un diff
No necesitas entender cada línea. Con /diff, o en la vista de cambios de VS Code, busca cuatro cosas:
- Archivos tocados: ¿corresponden al pedido o hay alguno inesperado?
- Archivos nuevos: ¿se parecen a alguno que ya existía?
- Líneas borradas: ¿eliminó algo que servía?
- Textos: ¿hay contenido que tú no escribiste?
Si algo no cuadra, pregunta antes de aceptar. Claude explica sus cambios cuando se lo pides.
05
La rutina después de cada cambio
El commit va al final, cuando todo lo anterior pasó. Así cada commit es un punto al que se puede volver con confianza.
06
Dónde aparecen los errores
| Lugar | Qué muestra |
|---|---|
Terminal donde corre npm run dev | Errores al generar las páginas |
| Aviso sobre la página en el navegador | El mismo error, con archivo y línea |
| Pestaña Console del navegador | Errores del JavaScript que corre en la página |
| Pestaña Network del navegador | Archivos que no cargan |
Salida de npm run build | Lo que el modo desarrollo dejó pasar |
Saber en cuál de estos lugares apareció el error ya es la mitad del diagnóstico.
07
Cómo se lee un error
Un mensaje de error casi siempre trae tres partes:
- Qué pasó: una frase, normalmente en inglés.
- Dónde: el archivo y el número de línea.
- El rastro: una lista larga de llamadas internas.
Las dos primeras son las que importan. El rastro asusta, pero rara vez necesitas leerlo.
08
El error está en el primer mensaje
Cuando aparecen muchos errores juntos, lee el primero. Los siguientes suelen ser consecuencia de ese.
09
Dos lugares para un mismo console.log
console.log es la instrucción que imprime un valor para inspeccionarlo. En Astro, dónde aparece depende de dónde se escribió:
| Dónde está escrito | Dónde se imprime |
|---|---|
En el bloque superior de un .astro | En la terminal |
| En una etiqueta de script de la página | En la consola del navegador |
El bloque superior corre en tu computador al generar la página. Si buscas el mensaje en el lugar equivocado, parece que el código no se ejecutó.
10
Las herramientas del navegador
Se abren con F12 o con clic derecho y la opción de inspeccionar. Para depurar una web de contenido bastan tres pestañas:
- Elements: el HTML real de la página y los estilos que aplican a cada elemento.
- Console: errores y mensajes de JavaScript.
- Network: cada archivo que la página pidió y si llegó.
En Elements puedes cambiar una clase para probar. Ese cambio no se guarda: sirve para confirmar una sospecha.
11
Un buen reporte tiene cuatro datos
- Qué hiciste: la página y el paso exacto.
- Qué esperabas que ocurriera.
- Qué ocurrió en realidad.
- La evidencia: el error completo, copiado tal cual, o una captura.
Con esos cuatro datos Claude busca la causa. Sin ellos, adivina.
12
«Arréglalo» no es un reporte
No resumas el error con tus palabras: el texto exacto contiene el archivo y la línea, y tu resumen los pierde.
13
Errores frecuentes en Astro
| Síntoma | Causa habitual |
|---|---|
| Un componente no aparece | Ruta de importación, nombre o extensión mal escritos |
| Un componente de React no reacciona | Le falta una directiva client |
document is not defined | Código de navegador ejecutado al generar la página |
Cannot find package | Falta instalar una dependencia |
| Estilos o metadatos duplicados | Más de un head en la página |
Todos están descritos en la guía de solución de problemas de Astro.
14
El build es la prueba que cuenta
- Ejecuta
npm run build. Si falla, el sitio no se puede publicar. - Ejecuta
npm run previewy recorre el sitio construido. - Ejecuta
npx astro checkpara una revisión adicional de los archivos.astro. Si pide instalar un complemento, acepta.
15
Lo que Claude Code puede comprobar solo
| Comando | Qué hace |
|---|---|
/diff | Muestra los cambios en los archivos |
/code-review | Revisa el diff actual en busca de errores |
/verify y /run | Levantan la app y comprueban el cambio funcionando |
/chrome | Configura Claude en Chrome para depurar la web en vivo |
Son una segunda revisión, no un reemplazo de la tuya. Claude puede dar por bueno algo que a ti, mirándolo en el celular, no te sirve.
16
Corregir la causa, no el síntoma
Ante un error, la salida más corta es ocultarlo: envolver el código para que no se queje, esconder el desborde, borrar la validación que falla.
Antes de aceptar una corrección, pregunta dos cosas:
- ¿Cuál era la causa?
- ¿Por qué este cambio la resuelve?
17
Cuando Claude da vueltas
Si después de dos o tres intentos el error sigue, insistir empeora las cosas. Opciones, de menor a mayor:
/rewindpara deshacer las ediciones de esta sesión.git restorepara volver los archivos al último commit./cleary empezar una conversación limpia, con un reporte bien escrito.
Tras una sesión larga, el contexto lleno de intentos fallidos confunde más de lo que ayuda. Revísalo con /context.
18
Volver al último punto que funcionaba
Si algo se rompió y no sabes cuándo, tu historial de commits responde:
- Mira los commits recientes con
git log --oneline. - Identifica el último en que el sitio funcionaba.
- Pídele a Claude que compare ese commit con el estado actual y busque el cambio responsable.
Esto solo funciona si hiciste commits chicos y frecuentes. Por eso la rutina termina siempre en commit.
19
Lo que te llevas
- Revisar el diff antes de aceptar evita la mayoría de las depuraciones.
- Cada error aparece en un lugar: terminal, consola, red o build.
- De un error importan la frase y el archivo con su línea; se lee primero el primero.
- Un reporte lleva qué hiciste, qué esperabas, qué pasó y la evidencia textual.
- Si Claude no avanza, vuelve a un punto limpio en lugar de insistir.
20
Hazlo ahora
En 15 minutos:
- Borra una letra en la ruta de importación de un componente y guarda.
- Lee el error en la terminal y en el navegador: ubica la frase, el archivo y la línea.
- Escribe el reporte con los cuatro datos y entrégaselo a Claude.
- Pregúntale la causa antes de aceptar la corrección.
- Ejecuta
npm run buildynpm run preview, recorre el sitio y haz commit.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026