Inicio

Cuando algo falla

1. 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.

2. 02Deshacer y recuperar una modificación9 min

   Para deshacer la última modificación de Claude Code en la sesión en curso, abre el menú de puntos de reanudación con /rewind en lugar de pasar primero por Git. Git sigue siendo la herramienta para lo que esos puntos ignoran: las modificaciones de un comando bash, las ediciones de un subagente en segundo plano y los archivos enlazados.

3. 03Errores de API y limite de tasa9 min

   Un error de API lleva un código de estado que distingue causas muy diferentes: una solicitud mal formada debe corregirse antes de reintentar, mientras que un límite temporal se resuelve respetando Retry-After. Un límite de gasto alcanzado no lleva esa cabecera, y esperar no sirve de nada: hay que elevar el límite mismo.

4. 04Un comando bloqueado7 min

   Ante un comando de shell congelado, pulsa Ctrl+C, que intenta interrumpir la operación; si no basta, relanza con claude --resume. No añadas a mano un prefijo timeout, porque la herramienta Bash ya lleva un parámetro de plazo que Claude decide por sí mismo, y la mayoría de los comandos que alcanzan su plazo pasan a segundo plano sin detenerse.

5. 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.

6. 06La solicitud puede partir de una premisa falsa9 min

   Una solicitud de corrección mezcla un síntoma observado con una causa supuesta: el síntoma puede ser exacto mientras la causa es falsa. Ejecutarla al pie de la letra no repara nada. Mide el estado real, enuncia la discrepancia al inicio de la respuesta y corrige después la causa real.

7. 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.