Cuando algo falla
- 01Bucles, contexto contaminado y reinicio10 min
La señal de un bucle es la repetición del mismo mensaje de error, un contexto saturado se trata con una compactación específica o con un borrado completo, y reiniciar con un resumen escrito a mano de las decisiones ya tomadas vale más que insistir en una conversación degradada.
- 02Deshacer y recuperar una modificación9 min
Para deshacer la última acción de Claude Code en la sesión en curso, el menú de puntos de reanudación abierto por /rewind precede ahora a Git, que sigue siendo necesario para todo lo que este sistema no sigue: una modificación hecha por un comando bash, la edición de un subagente en segundo plano, o un archivo enlazado por un enlace simbólico o físico.
- 03Errores de API y limite de tasa9 min
Una llamada a la API puede fallar de varias maneras distintas: un error 400 o 404 casi siempre señala una solicitud mal formada que debe corregirse antes de cualquier nuevo intento, salvo el caso particular de un 400 devuelto por haber alcanzado un límite de gasto, mientras que un error 429 solo se resuelve esperando si lleva una cabecera Retry-After, lo cual no es el caso de un límite de gasto alcanzado.
- 04Un comando bloqueado7 min
Un comando de shell que deja de responder se interrumpe con Ctrl+C sin cerrar la sesión, y el plazo que lo hace pasar a segundo plano ya lo fija el propio Claude, no un prefijo que se añade a mano.
- 05Varias sesiones mueren juntas, sospecha de la máquina9 min
Cuando varias sesiones mueren en el mismo instante sin ningún rastro en sus propios registros, la causa probable es el sistema operativo que mata procesos bajo presión de memoria, y el registro del sistema resuelve la duda más rápido que una caza de errores de la aplicación.
- 06La solicitud puede partir de una premisa falsa9 min
Una solicitud puede describir el síntoma con exactitud a la vez que se equivoca sobre la causa, y ejecutar esa solicitud al pie de la letra entonces no corrige nada o agrava la situación.
- 07Leer la función invocada, probar al culpable10 min
Una corrección cuya prueba unitaria pasa en verde puede quedar anulada, en la misma vuelta de ejecución, por la función invocada justo después, y la función ya corregida solo es un culpable probado una vez que una prueba ha aislado su efecto del de las funciones siguientes.