¿Claude Code atascado o congelado? La guía de rescate completa

Atascado en «Compacting conversation…»

El auto-compact salta cuando la ventana de contexto se llena: Claude Code resume la conversación hasta el momento y la sustituye. En una sesión genuinamente enorme, esa pasada de resumen puede tardar minutos — y las versiones v2.1.282 y v2.1.284 corrigieron fallos reales: la compactación se rompía cuando se rechazaba la petición de resumen, o quedaba colgado un error «Prompt is too long» tras compactar. Si una sesión de tamaño normal se arrastra más de dos o tres minutos, está atascada, no trabajando.

1. 1Si la sesión es legítimamente gigantesca, dale primero un par de minutos — la v2.1.283 rehízo el spinner de compactación: su temporizador arranca cuando la compactación empieza de verdad.
2. 2Pasado eso, pulsa Esc y luego Ctrl+C para cancelar la compactación. La documentación oficial confirma que Ctrl+C cancela la operación en curso sin descartar tu sesión.
3. 3Compacta después a mano con un enfoque para que el resumen suelte la salida voluminosa de herramientas, por ejemplo: /compact keep only the plan and the diff.
4. 4Si el historial viejo es prescindible, ejecuta /clear y empieza limpio — y actualiza a v2.1.284 o superior para tener los reintentos de compactación corregidos.

/compact keep only the plan and the diff/clear

Atascado en «Almost done thinking…»

Contraintuitivo pero cierto: esa etiqueta del spinner no es un informe de progreso. Los mantenedores lo confirmaron en el issue #63387: las frases rotantes no se corresponden con el estado real de razonamiento del modelo. Por eso «almost done» puede quedarse en pantalla muchos minutos, y el issue #55328 documenta turnos en los que ni Esc ni Ctrl+C hacían nada mientras el extended thinking se alargaba.

1. 1Pulsa Esc una vez y espera unos segundos; si el spinner sigue girando, pulsa Ctrl+C.
2. 2Si la entrada sigue muerta, cierra la pestaña de la terminal, abre otra y ejecuta claude --resume en el mismo directorio para retomar la sesión.
3. 3Si cada turno largo se cuelga igual, actualiza Claude Code y sospecha de un servidor MCP o un hook atascado — desde fuera es idéntico a un pensamiento bloqueado, y /mcp muestra qué servidor va mal.

claude --resume

«Not responding — try stopping»

Ese banner naranja es el perro guardián de Claude Code: una llamada a herramienta — normalmente un comando bash largo — lleva lo bastante en silencio como para que la interfaz ofrezca un botón de parada. Es un aviso, no un veredicto: en las demos del propio Anthropic el proceso siguió trabajando normalmente por debajo, y Boris Cherny, responsable de Claude Code, ha pedido públicamente grabaciones de este estado — el equipo está al tanto e investiga.

1. 1Comprueba si el comando subyacente sigue produciendo salida — una compilación que trabaja en silencio no necesita interrupción.
2. 2Si de verdad está clavado, pulsa Esc o el botón naranja de parada para interrumpir el turno.
3. 3Dile a Claude que lo paraste tú — tras una parada manual el modelo puede creer erróneamente que la herramienta fue rechazada y ponerse a pedir perdón en lugar de continuar.
4. 4Vuelve a lanzar la operación larga en segundo plano o en trozos más pequeños para que el vigilante de primer plano no salte otra vez.

claude --resume

Filo conocido: en una demo de Anthropic con este mismo banner, el botón de parar apareció con el comando todavía sano — verifica antes de parar.

Atascado en «Resuming container…» (sesiones en la nube)

Las sesiones web y móviles de Claude Code corren en un contenedor en la nube. Reabrir una sesión antigua significa arrancar ese contenedor de nuevo y transmitir la transcripción — honestamente lento con historiales grandes. La v2.1.286 corrigió un bug por el que las sesiones con historiales muy grandes llegaban a no despertar nunca: el contenedor se paró mientras la transcripción seguía cargando.

1. 1Espera primero unos minutos — la reactivación en frío de un contenedor es más lenta que una sesión nueva, y no hay barra de progreso que diga que avanza.
2. 2Actualiza la CLI a la v2.1.286 o superior — claude update, o npm install -g @anthropic-ai/claude-code — esa versión corrige el bug de «nunca despierta» con historiales de nube muy grandes.
3. 3¿Sigue congelada tras actualizar? Recarga la sesión web; si persiste, abre una sesión nueva y continúa el trabajo ahí.

claude updatenpm install -g @anthropic-ai/claude-code

Solución de la comunidad, respuesta oficial pendiente: varios usuarios reportan el contenedor despertando en unos cinco minutos — no lo des por muerto hasta entonces.

Congelado al arrancar

Un congelamiento antes del prompt casi siempre es local: un servidor MCP, plugin o hook que revienta, un estado corrupto o un problema de la extensión. La v2.1.284 arregló las pestañas de VS Code que dejaban de responder tras Restart Extensions, y la v2.1.286 el spinner infinito «Teleporting session…» cuando la extensión deja de responder. Como el /doctor integrado necesita una sesión viva, se empieza desde la shell.

1. 1Ejecuta claude doctor desde tu terminal — es exactamente lo que recomienda la documentación para el caso de «no arranca»; revisa la instalación y propone correcciones.
2. 2Arranca con claude --safe-mode, que desactiva para esa sesión todos los plugins, servidores MCP y hooks — si arranca, el culpable es una de esas personalizaciones.
3. 3Reactiva tus personalizaciones una a una — o, ya dentro, pasa un /mcp — para dar con la culpable, y actualízala o quítala.
4. 4En VS Code, actualiza también la extensión — los dos arreglos 2.1.28x de arriba solo existen en versiones actuales.

claude doctorclaude --safe-mode

Congelado en la terminal

El clásico congelamiento total — entrada muerta, spinner parado, Ctrl+C ignorado — tiene un playbook documentado. La secuencia de la guía oficial: intentar cancelar, reiniciar la terminal si hace falta, reanudar; en ningún caso se pierde nada. Una salida garabateada o a medio dibujar en la terminal integrada del editor es otro problema — la aceleración GPU — con arreglo de un solo comando.

1. 1Pulsa Ctrl+C para intentar cancelar la operación en curso.
2. 2Si la ventana sigue sin responder, cierra la terminal por completo y abre una nueva.
3. 3En la terminal nueva, ejecuta claude --resume en el mismo directorio del proyecto — la documentación promete que la conversación no se pierde.
4. 4¿Salida corrupta en la terminal integrada de VS Code? Ejecuta /terminal-setup — desactiva la aceleración GPU de la terminal y despeja la corrupción.

claude --resume/terminal-setup

«Model overloaded» y el bucle «Retrying…»

Esta vez la culpa no es de tu terminal, sino de la capacidad de Anthropic. Cuando el tráfico sube para todos los usuarios a la vez, la API responde con un HTTP 529 (overloaded_error, «The API is temporarily overloaded»), y Claude Code muestra «API Error: Repeated 529 Overloaded errors» solo después de haber reintentado por su cuenta — hasta 10 veces por defecto, con backoff exponencial. Esa espera es el spinner «Retrying in Ns · attempt x/y» que ves en pantalla. Una variante más amable señala directamente el modelo saturado: «Opus is experiencing high load, please use /model to switch to Sonnet». La capacidad se controla por modelo, así que el modelo en el que estés cambia tus opciones.

1. 1Deja pasar primero la ola. La recomendación oficial es reintentar a los pocos minutos: un 529 solo indica que la capacidad compartida está brevemente al límite, la mayoría de los picos bajan solos y el bucle de reintentos sigue trabajando por ti mientras tanto.
2. 2Consulta status.claude.com antes de tocar ningún ajuste local — si hay un incidente activo, esperar es toda la solución. Si te conectas mediante una pasarela o un proveedor cloud, el propio mensaje de error apunta a la página de estado de ese proveedor.
3. 3Ejecuta /model y cámbiate a un modelo menos cargado — el propio error de Claude Code lo sugiere. La capacidad se controla por modelo, así que salir de un modelo saturado hacia uno más tranquilo puede restaurar el acceso al instante.
4. 4¿Ejecución desatendida o en CI? Define CLAUDE_CODE_RETRY_WATCHDOG=1 para que Claude Code siga reintentando los errores 529 en lugar de fallar la tarea, y ajusta CLAUDE_CODE_MAX_RETRIES (por defecto 10, tope 15) si necesitas otro margen de reintentos.

/modelCLAUDE_CODE_RETRY_WATCHDOG=1 claude

No lo confundas con los límites de tu plan: la documentación oficial precisa que un 529 «is not your usage limit and doesn't count against your quota» — no es tu límite de uso ni consume cuota. El banner relacionado «Server is temporarily limiting requests (not your usage limit)» es una limitación puntual del servidor que Claude Code reintenta automáticamente desde la v2.1.199.