Si te atoras
Algo va a fallar, y no quiere decir que lo hiciste mal. Pasa en todos los proyectos. Lo que distingue a quien termina su app es que sabe qué hacer cuando falla: esta hoja.
Cuando sale un error
Tres pasos: lee el mensaje, cuéntaselo bien a Claude y, si el arreglo empeora las cosas, deshazlo.
1. Lee el mensaje
Un mensaje de error asusta porque es largo y en inglés. No tienes que leerlo todo: busca la línea con la palabra «Error» y lo que sigue. Casi siempre dice qué pasó:
- not found
- No encuentra algo: un programa, un archivo. Como «node: command not found».
- permission denied o EACCES
- No tiene permiso para tocar ese archivo o esa carpeta.
- EBUSY o resource busy
- El archivo está ocupado: otro programa lo tiene abierto, como la sincronización con la nube.
- ETIMEDOUT o network
- Se cortó o tardó la conexión a internet.
De la lección 4.6 «Cuando algo falla»
2. Cuéntaselo a Claude
«No sirve, arréglalo» hace que Claude adivine, y a veces cambia lo que no debía. Descríbelo como a un técnico por teléfono: qué hiciste, qué esperabas, qué pasó y el mensaje tal cual, copiado y pegado. Y pídele que investigue la causa y te la explique antes de cambiar nada. Un arreglo a la vez: si el primero no sirve, lo deshaces y prueba otro camino.
Prompt para cuando algo falla
Algo falló. Lo que hice: [qué hice]. Lo que esperaba: [qué esperaba]. Lo que pasó: [qué pasó]. El mensaje dice, tal cual: [pego el mensaje]. Investiga la causa y explícamela antes de cambiar nada; luego propón un solo arreglo.
De la lección 4.6 «Cuando algo falla»
3. Si empeoró, deshazlo
Antes de cambiar un archivo, Claude guarda una copia de cómo estaba. Si un arreglo empeoró las cosas, pídele: «Deshaz tu último cambio». Esa copia cubre solo los archivos de tu carpeta: lo que pasa fuera, como un cambio en un servicio de internet, no tiene vuelta así. Por eso ahí apruebas con más cuidado. En el nivel 5 sumas un historial que te deja regresar a cualquier paso guardado.
De la lección 4.6 «Cuando algo falla»
En el chat: un cambio a la vez
Va a pasar, y no es culpa tuya. Lo que ayuda es describirle a Claude lo que pasa, como se lo contarías a un técnico por teléfono:
- Di lo que ves: «el botón ya no hace nada».
- Di qué esperabas que pasara.
- Si aparece un mensaje de error, busca junto a él el botón para que Claude lo intente arreglar.
- Si no se arregla, edita tu mensaje anterior y pídelo de otra forma: la plática sigue desde ahí y no pierdes lo de antes.
De la lección 2.2 «Artifacts: crea y cambia»
Continuar donde te quedaste
Si se cortó tu sesión
A veces no falla nada: se acaba tu uso, cierras la app o se apaga la computadora a la mitad de una parte. No pierdes tu trabajo. Así lo retomas:
- 1Abre la misma sesiónEstá en la barra de la izquierda, con su conversación.
- 2Si se acabó tu usoEspera a que se reinicie; lo ves en el círculo junto al modelo.
- 3Pega el prompt de continuarClaude lee tu bitácora y te dice en qué iban.
- 4Revisa y sigueSolo con la parte que quedó a medias.
Prompt para continuar
Continúa donde te quedaste. Lee CLAUDE.md, docs/plan-mvp.md y docs/avance.md, dime en dos frases en qué íbamos y qué falta de la parte actual, y sigue solo con esa parte.
De la lección 4.6 «Cuando algo falla»
Cuándo pedir ayuda
El botón «¿Te atoraste?»
Pídela cuando ya probaste un arreglo a la vez y sigues igual, o cuando no entiendes qué te pide Claude. En cada lección, abajo a la derecha, está el botón «¿Te atoraste?»: te da un prompt para tu Claude que primero te pregunta qué intentaste y qué pasó, y luego te guía paso a paso. Así se ve:
Prompt de ayuda
Estoy tomando la lección «[nombre de la lección]» del nivel [número] de Buildpace y me atoré. Antes de explicarme, pregúntame qué intenté y qué pasó. Luego guíame paso a paso, sin darme todo resuelto.
¿Lo que falla es el curso, tu acceso o tu pago? Escríbenos a andres@twentytechworks.com.
Plan B si falla la instalación
Si Claude no encuentra Node.js o npm, o una instalación se detiene con error, ve en este orden:
- 1Reinicia la appCiérrala por completo y ábrela.
- 2Pide la revisiónQue Claude corra «node -v» y «npm -v»: solo leen.
- 3ReinstalaNode.js LTS desde nodejs.org, y reinicia la computadora.
- 4Revisa tu carpetaSi dice permisos u ocupado, que esté fuera de OneDrive o iCloud.
- 5¿Computadora del trabajo?Puede tener bloqueos para instalar: usa una tuya.
- 6Pide ayudaEn «¿Te atoraste?», con el mensaje exacto.
De la lección 4.6 «Cuando algo falla»
Cuando tu app ya está en línea
Tarde o temprano, una clienta te va a escribir «no me deja pagar». No es un fracaso: pasa en todas las apps. Para saber qué pasó, tu app anota sus errores en los registros (logs) de Netlify. Netlify los guarda al menos 24 horas, así que revísalos el mismo día. Copia el error, revisa que no lleve datos de tus clientes y pégaselo a Claude para que investigue antes de cambiar nada.
Piénsalo asíEs como la caja negra de un avión: cuenta qué pasó justo antes de la falla.
De la lección 7.10 «Antes de abrir la puerta»