¿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