Inicio/Volumen II/Cuando algo se rompe

🛟 Cuando algo se rompe: depurar y proteger tu trabajo

Tarde o temprano algo fallará: un error al arrancar, una instalación que se atasca, Claude Code que hace algo distinto. No es un drama: es parte de construir. Este capítulo te da un método sereno para resolverlo y, sobre todo, para no perder nunca tu trabajo ni exponer tus datos.

🎯 Objetivos de aprendizaje

Leer un error sin asustarte y resolverlo con Claude Code.
Un método de depuración paso a paso que sirve para todo.
Proteger tus claves, tus datos personales y tus copias de seguridad.

Los errores son mensajes, no castigos

🧠 En cristiano: qué es un “error” en la terminal. Cuando algo va mal, el ordenador escribe un texto largo (a veces en rojo) que parece amenazante. En realidad es una pista: te dice qué esperaba y qué encontró. No tienes que entenderlo tú: tu trabajo es copiarlo entero y pasárselo a Claude Code.

💡 Idea clave. La frase más útil del libro: “Me sale este error, ¿qué significa y cómo lo arreglo?” seguida del error pegado tal cual. Depurar es una de las cosas que mejor hace Claude Code.

Método de depuración en cinco pasos

Cuando algo no funcione, ve en orden. No saltes pasos:

Lee el mensaje. La última línea suele decir lo esencial.
Aísla qué cambió. ¿Funcionaba antes? ¿Qué hiciste justo antes de que fallara?
Comprueba lo básico. ¿Está Ollama en marcha? ¿Hiciste npm install? ¿Estás en la carpeta correcta (pwd)?
Pásaselo a Claude Code con el error completo y qué estabas haciendo.
Un cambio cada vez. Aplica una solución, prueba, y solo si no va, prueba la siguiente.

⚠️ Cuidado. Evita el “cambiarlo todo a la vez” con la esperanza de que algo funcione. Si tocas cinco cosas y arregla, no sabrás cuál era y volverá a pasar. Un cambio, una prueba.

La red de seguridad: Git y copias

Si tienes miedo de “romper algo”, la solución es poder volver atrás. Ya lo viste en el capítulo de proyectos, pero aquí es donde de verdad te salva:

⌨️ Terminal

Algo se ha estropeado y no sé qué. Vuelve al último commit que funcionaba y explícame qué has revertido.

💡 Idea clave. Haz un commit cada vez que algo funcione. Así, ante cualquier destrozo, siempre hay un punto seguro al que regresar. Es la diferencia entre un susto y un desastre.

Protege tus datos y tus claves

Cuando tus proyectos manejan información real —facturas, documentos de clientes, claves de API— la seguridad deja de ser opcional.

Claves y contraseñas nunca en el código. Van en un archivo .env que no se sube a internet. Pídeselo a Claude Code: “asegúrate de que mis claves están en .env y de que .env está en el .gitignore”.
No subas datos personales a GitHub. Antes de publicar, revisa que no haya documentos de clientes ni bases de datos reales dentro.
Cuidado al construir con datos sensibles. La app corre en local, pero Claude Code razona en la nube. No pegues datos confidenciales reales en el chat mientras construyes; usa ejemplos ficticios.
Copias de seguridad de verdad. Una copia que nunca has probado a restaurar no es una copia. Comprueba de vez en cuando que puedes recuperar tus datos.

🧠 En cristiano: el archivo .gitignore. Es una lista de cosas que Git debe ignorar y nunca subir: claves, datos, archivos temporales. Es tu primera línea de defensa contra publicar sin querer algo privado.

✅ Comprueba que funciona. Antes de publicar cualquier proyecto en internet, hazte tres preguntas: ¿hay alguna clave en el código? ¿hay datos personales reales en las carpetas? ¿está el .env en el .gitignore? Si las tres respuestas son correctas, adelante.

💾 Guardar y reabrir el proyecto.

Rutina de seguridad que vale para todos tus proyectos:

Commit de Git cuando algo funcione.
Claves en .env, nunca en el código ni en GitHub.
Copia de la carpeta (y de la base de datos) fuera del ordenador cada cierto tiempo.
Prueba de vez en cuando que sabes restaurar esa copia.

Reto para practicar

Provoca un error a propósito en un proyecto de prueba (por ejemplo, borra una línea del código), observa el mensaje, pégaselo a Claude Code y arréglalo. Perder el miedo a los errores es lo que te convierte en autónomo de verdad.

← IA local Un chatbot que cita la ley →