Clase 06 · Módulo 04
Revisar lo que Claude escribe
Revisar lo que Claude escribe
Qué logras en esta clase
Tienes un método para revisar cada cambio de Claude y para sacar provecho de cada error.
- Lees un diff y un mensaje de error.
- Haces preguntas que entregan respuestas útiles.
- Decides con criterio si aceptar, pedir ajustes o deshacer.
02
Quién responde por la app
Claude escribe rápido. Quien decide si el cambio entra eres tú.
03
Qué es un diff
Un diff muestra la diferencia entre el antes y el después de un archivo.
function calcularTotal(neto) {
- return neto * 1.19;
+ const IVA = 0.19;
+ return Math.round(neto * (1 + IVA));
}- Línea con
-(en rojo): se eliminó. - Línea con
+(en verde): se agregó. - Línea sin signo: contexto, no cambió.
Una línea modificada aparece como una borrada y una agregada.
04
Dónde ves el diff
- En Claude Code, cuando propone editar un archivo. Según el modo de permisos, te pide aprobar o aplica directo.
- En VS Code, en el panel de control de código fuente: lista lo cambiado desde el último commit.
- En la terminal, con
git diff.
05
Leer un diff en orden
- Qué archivos cambiaron. ¿Son los que esperabas para lo que pediste?
- Cuánto cambió. Un pedido chico con un diff enorme merece una pregunta.
- Lo rojo. ¿Se borró algo que funcionaba y no tenía relación?
- Lo verde. ¿Hace lo que pediste, con los nombres y textos correctos?
- Lo que sobra. ¿Hay cambios que no pediste?
06
El ciclo de un cambio
Cada paso atrapa algo distinto: el plan evita trabajo mal encaminado, el diff muestra lo que realmente se tocó y la prueba confirma que funciona.
Saltarse uno ahorra un minuto y puede costar una tarde.
07
Modo plan: revisar antes de que toque nada
En modo plan, Claude Code lee archivos y propone qué hará, sin editar hasta que apruebes.
- En la sesión, presiona
Shift+Tabhasta que la barra de estado indique que el modo plan está activo. - Describe el cambio.
- Lee el plan: qué archivos tocará y en qué orden.
- Aprueba o corrige.
También puedes partir con claude --permission-mode plan.
08
Señales de alerta en un diff
- Archivos sin relación con el pedido, o bloques grandes borrados sin explicación.
any,aso@ts-ignorenuevos (clase 5).- Un
catchvacío o un efecto sin limpieza (clases 2 y 4). - Pruebas eliminadas o desactivadas «para que pase».
- Una clave o contraseña escrita directamente en el código.
09
Archivos que piden más cuidado
| Archivo | Por qué mirar dos veces |
|---|---|
package.json | Aparece una librería nueva |
app.json | Cambia la configuración nativa |
.env | Puede contener secretos |
| Carpeta de migraciones | Cambia la base de datos |
Si se instala una librería con código nativo o cambia app.json, necesitas un development build nuevo (módulo 3).
10
Dónde aparecen los errores
| Lugar | Qué muestra |
|---|---|
| Subrayado en el editor | Errores de tipos, antes de ejecutar |
| Pantalla roja en el teléfono | Un error que detuvo la app |
| Aviso amarillo en el teléfono | Una advertencia: algo por corregir |
Terminal de npx expo start | Los registros y el detalle completo |
La pantalla roja y el aviso amarillo los genera LogBox, la herramienta de React Native. Solo existen en desarrollo.
11
Anatomía de un mensaje de error
TypeError: Cannot read property 'total' of undefined
at TarjetaPedido (components/TarjetaPedido.tsx:12:24)
at PantallaPedidos (app/pedidos.tsx:31:9)
at renderWithHooks (node_modules/react/...)- Primera línea: el tipo de error y qué pasó. Aquí se intentó leer
totalde algo que no existe. - Lo demás: el stack trace, la lista de llamadas que llevó hasta el error, con archivo, línea y columna.
12
Leer un stack trace
- Lee la primera línea completa. Tradúcela si hace falta.
- Baja hasta la primera ruta que sea de tu proyecto, no de
node_modules. - Anota archivo y número de línea.
- Abre esa línea y relaciónala con el mensaje.
En el ejemplo: línea 12 de TarjetaPedido.tsx. Algún pedido llegó como undefined. La línea siguiente dice quién se lo pasó.
13
Antes de pegar el error
Un error bien leído ya trae archivo, línea y causa probable. Léelo primero; después pídele ayuda a Claude.
14
Tres tipos de error
| Tipo | Cómo se nota | Quién lo detecta |
|---|---|---|
| De tipos | Subrayado en el editor | TypeScript |
| De ejecución | Pantalla roja o cierre | El teléfono, al usar la app |
| De lógica | Sin mensaje: el resultado es incorrecto | Solo tú |
El tercero es el caro. Un total mal sumado no lanza ningún error. Por eso se prueba con datos cuyo resultado ya conoces.
15
Pasarle un error a Claude
Incluye siempre:
- El mensaje completo, con su stack trace.
- Qué hiciste justo antes: los pasos para repetirlo.
- Si pasa siempre o solo a veces.
- En qué teléfono o emulador.
Puedes pegar una captura de la pantalla roja, o pedirle que ejecute él mismo el comando que falla para ver la salida.
16
Un pedido vago y uno útil
Pedir primero la causa separa el diagnóstico del arreglo. Si la explicación no te convence, no se ha tocado nada.
17
Preguntas que sí sirven
- «Explícame este diff como a alguien que no programa».
- «¿Qué archivos tocaste que yo no pedí y por qué?».
- «¿Qué puede fallar con este cambio y cómo lo pruebo?».
- «¿Había una forma más simple?».
Para apuntar a un archivo exacto, escribe @ seguido de su ruta.
18
Cuándo aceptar
Acepta cuando se cumplen las cuatro:
- El diff toca lo que pediste y entiendes cada parte, al menos en general.
- No quedan errores de tipos.
- Lo probaste en el teléfono, incluido el caso en que algo falla.
- Puedes explicar el cambio en una frase.
Esa frase es tu mensaje de commit.
19
Aceptar, ajustar o deshacer
| Situación | Qué hacer |
|---|---|
| Hace lo pedido y pasó la prueba | Aceptar y hacer commit |
| Funciona, pero trae cambios que no pediste | Pedir que los quite |
| Funciona a medias | Pedir el ajuste puntual |
| Dos intentos de arreglo y sigue fallando | Deshacer y replantear |
20
Deshacer con /rewind
Claude Code guarda un punto de control cada vez que envías un mensaje.
- Escribe
/rewind, o presionaEscdos veces con el campo de texto vacío. - Elige el mensaje al que quieres volver.
- Elige qué restaurar: el código, la conversación o ambos.
21
Git, la red de seguridad real
Lo visto en el módulo 3 se usa aquí todos los días.
- Haz commit antes de cada pedido grande: así el diff muestra solo ese cambio.
- Un cambio, un commit. Mezclar tres impide deshacer solo uno.
- Lo experimental va en una rama.
Con un commit limpio de partida, ningún experimento te deja peor de lo que estabas.
22
Lo bueno y lo malo de revisar así
A favor: sabes qué hay en tu app, los errores se atrapan temprano y aprendes con cada diff.
En contra: toma tiempo, y al principio vas a entender solo una parte.
No necesitas entender el 100 %. Necesitas entender qué cambió, por qué, y haberlo visto funcionar.
23
Lo que te llevas
- Un diff se lee en orden: archivos, tamaño, lo rojo, lo verde, lo que sobra.
- La primera línea de un error dice qué pasó; el stack trace, dónde.
- Pide la causa antes del arreglo.
- Aceptas solo lo que entiendes, sin errores de tipos y probado.
- Tras dos arreglos fallidos, se deshace y se replantea.
24
Hazlo ahora
Quince minutos.
- Haz un commit del estado actual de tu proyecto.
- Activa el modo plan y pide un cambio chico: por ejemplo, otro texto en una pantalla.
- Lee el plan, apruébalo y revisa el diff con los cinco pasos.
- Pruébalo en el teléfono.
- Escribe en una frase qué cambió y úsala como mensaje de commit.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026