Tarea de Claude Code bloqueada: cuándo detener los reintentos y recuperar el estado
Protocolo práctico para recuperar una tarea atascada de Claude Code: clasifica el fallo, detén el bucle, guarda el estado y continúa con una verificación acotada.
Los reintentos sin límite son una causa habitual de consumo innecesario de tokens, deterioro del contexto y cambios de código dañados al trabajar con Claude Code. Cuando un agente vuelve a fallar en las mismas pruebas, no encuentra una variable de entorno o edita en círculo los mismos archivos, repetir sin una señal externa nueva no soluciona la causa. Solo lleva la sesión más hondo a un callejón sin salida.
La estrategia correcta es interrumpir el bucle pronto, clasificar el fallo tanto en la API como en el código, registrar el estado real del repositorio y recuperar la tarea mediante una comprobación determinista.
1. Clasificar los fallos: cuándo un reintento no sirve
No todos los errores se resuelven ejecutando de nuevo el comando. Sin una diagnosis clara, es fácil confundir un límite temporal de la API con un bucle lógico del agente:
Para no adivinar las causas ni gastar tokens a ciegas, separa los problemas de una API externa de los defectos de código. Con el flujo de trabajo BetterToken para Claude Code, el Dashboard permite consultar el estado HTTP, el modelo, el tiempo de respuesta y el consumo exacto de tokens de entrada, salida y caché. Un timeout de gateway o un 429 puede justificar un reintento limitado. Si la API devuelve 200 OK de forma consistente mientras el agente edita en círculos, finaliza la sesión de inmediato.
2. Protocolo de recuperación priorizado
Cuando el agente acumule 2 o 3 intentos improductivos seguidos, sigue este orden:
```mermaid
graph TD
A[El agente está en un bucle de errores] --> B[Paso 1: detener de inmediato con Ctrl+C]
B --> C[Paso 2: revisar estado y diff de Git]
C --> D[Paso 3: guardar una Recovery Card]
D --> E[Paso 4: iniciar una sesión limpia con una comprobación]
```
Acciones paso a paso:
- Paso 1: terminar la sesión. Interrumpe la ejecución con `Ctrl+C`. No permitas que el agente consuma más contexto generando explicaciones largas o salida innecesaria.
- Paso 2: inspeccionar y limpiar el estado. Revisa los archivos modificados con `git status --short`. Si el agente produjo código roto, revierte solo los archivos afectados: `git checkout -- <file>`.
- Paso 3: clasificar la causa raíz. Compara las métricas de API del Dashboard con los registros de ejecución del agente para separar un incidente de red de un error de lógica.
- Paso 4: guardar una Recovery Card estructurada.
3. La Recovery Card estructurada
Registra el estado exacto de la tarea antes de abrir una nueva sesión de recuperación:
```markdown
Recovery Card: fallo del servicio de importación
- Objetivo original: añadir validación de correo electrónico a `auth/service.ts`.
- Progreso real: se añadió la regex, pero falla la prueba unitaria `auth_test.go`.
- Causa raíz: el agente intentó simular un método privado en lugar de la interfaz pública.
- Estado de Git: rama `fix/auth-email`, se conserva el diff válido de `auth/service.ts`.
- Siguiente acción para una sesión limpia: refactorizar la prueba unitaria mediante la interfaz pública `AuthClient`.
```
[!IMPORTANT]
No guardes secretos: nunca incluyas claves API, tokens de acceso ni volcados de memoria sin procesar en una Recovery Card. Comprueba la configuración del endpoint y la gestión de claves en la documentación de BetterToken para Claude Code.
4. Recuperación reversible y verificación
Para reanudar el trabajo con seguridad:
- Inicia una nueva sesión de Claude Code con una ventana de contexto limpia.
- Entrega al agente solo el objetivo de la tarea y el campo «Siguiente acción» de la Recovery Card.
- Exige una comprobación limitada: `npm test -- tests/auth.test.ts`.
- Confirma que la prueba objetivo pasa (`Passed`) y revisa después el diff final con `git diff --check`.
Este protocolo convierte un bucle de agente descontrolado en un punto de control manejable y protege tanto el código como el presupuesto de tokens.
Pago y recarga de saldo
El pago y la recarga para el uso de la API se gestionan en tu propia cuenta BetterToken. BetterToken es un servicio de acceso a API de modelos con pago por uso; el saldo pagado y recargado no se elimina automáticamente cada mes. Los métodos de pago, importes mínimos, comisiones, tipos de cambio y plazos de procesamiento pueden cambiar, por lo que debes consultar la cuenta en el momento de pagar.
Precios y control de costes
La disponibilidad de modelos y los precios concretos son datos dinámicos. Antes de tomar una decisión de costes, consulta la página de precios de BetterToken en lugar de reutilizar cifras de un artículo antiguo. Tras una solicitud de prueba, el Dashboard permite contrastar el modelo, el estado y los tokens de entrada, salida y caché con el consumo correspondiente.