¿Dónde se ha atascado? Mira la pantalla y después el proceso
# in the session
Esc # cancel the current tool or turn
Ctrl+C (twice) # abort the turn / exit
# from another terminal
ps aux | grep -E "claude|node" | grep -v grep # child processes still running?
top -o cpu # is claude spinning or idle?
claude --debug # next time: timestamps for every request and tool call
claude -c # resume the last session after a killUna CPU inactiva con un prompt congelado significa que está esperando algo externo: un flujo de red, un servidor MCP, un proceso hijo o una solicitud que no puedes ver. Una CPU al máximo significa que está trabajando en algo interno: analizando un resultado enorme de una herramienta, realizando retroceso en una expresión regular o cargando una sesión grande. Si la memoria aumenta de forma constante, se está cargando íntegramente el resultado de una herramienta o un archivo de sesión.
Causas conocidas en el registro de incidencias
- `/rewind` se bloquea, `Ctrl+C` se ignora, se necesita `kill -9` (#53011, 21 reacciones, en sesiones de cualquier tamaño en las versiones 2.1.1xx). Un ingeniero de Anthropic no pudo reproducirlo en 2.1.233, así que actualiza primero; en una versión antigua, termina el proceso y reanuda con
claude -cen lugar de retroceder. - Las sesiones de Remote Control se congelan durante la ejecución y solo un `Esc` local las reactiva (#51267, abierta). Cualquier herramienta o subproceso que se bloquee congela toda la sesión remota sin posibilidad de cancelarla de forma remota; mantén estas sesiones cortas y evita las herramientas que puedan solicitar una entrada.
- La solicitud de autenticación de MCP se bloquea en `Enter` (#42707, abierta). Autentica el servidor desde un comando
claude mcpindependiente o desde el navegador y, después, reinicia la sesión. - `grep` mediante el motor de coincidencias integrado consume toda la memoria (#54394): en las versiones nativas, cada comando de shell
grepse ejecuta dentro de un procesoclaudecon su propio heap de V8; una expresión regular con retroceso sobre una línea larga minificada crece hasta ocupar gigabytes y el mecanismo de terminación por falta de memoria se lleva también la sesión, tanto en WSL2 como en Linux. Evita las expresiones regulares sin límites sobre archivos minificados, excluye los archivos generados por la compilación ynode_modules, o instala la versión del sistema deripgrepe invócala explícitamente. - Bucle de reintentos atascado en `400 thinking blocks cannot be modified` (#63231) — el historial de la conversación no es válido y todos los reintentos fallan de la misma manera.
/rewindhasta antes del turno, o/clear; consulta la guía de 400. - **Ejecuciones en la nube o programadas atascadas en *Configurando un contenedor en la nube*** (#53691, #54528) — el problema está en el servicio; no hay nada que hacer localmente, cancela y consulta status.claude.com.
- Reanudar una sesión grande tarda minutos — la transcripción se reproduce al iniciar. Reanuda la sesión específica que necesitas (
claude -r) en lugar de la más grande y deja que la compactación reduzca las sesiones enormes.
Bloqueos al iniciar
Una pantalla en blanco justo después de claude sin que aparezca el prompt suele indicar que la primera llamada a la API no devuelve una respuesta: una variable de proxy que apunta a un proxy inactivo, una VPN, DNS o un ANTHROPIC_BASE_URLinaccesible. Ejecuta la comprobación con curl de la guía de errores de conexión, y después claude doctor. Si el inicio es lento pero acaba apareciendo el prompt, se están iniciando servidores MCP; claude mcp list y elimina los que agoten el tiempo de espera.
Procesos secundarios que nunca terminan
Una herramienta de shell que abre un editor, espera una contraseña, sigue un registro o inicia un servidor de desarrollo nunca devuelve el control, y el turno se queda esperándola. Indica al agente que ejecute los servidores en segundo plano y que añada --no-pager, -y o < /dev/null cuando un comando pueda solicitar una entrada. Si ya ha ocurrido, Esc cancela la herramienta; si el proceso secundario lo ignora, termínalo por su PID desde otra terminal y el turno continuará con el error.
Uso elevado de memoria y CPU
- Los resultados de las herramientas se conservan en memoria y en disco durante la sesión; leer un archivo de 200 MB supone una sesión de 200 MB. Lee las partes que necesites.
- Muchos subagentes en paralelo multiplican todo;
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2en equipos con pocos recursos. - Los emuladores de terminal con renderizado lento (algunas consolas de Windows, tmux remoto a través de una conexión limitada) hacen que la salida en streaming parezca congelada;
claude --debugmuestra si siguen llegando tokens. - Si la memoria aumenta mientras está inactivo, busca procesos
claudeque hayan quedado de sesiones del IDE que se cerraron inesperadamente y termínalos (el proceso terminó con el código 1 cubre el caso de los procesos huérfanos en Windows).
Cuando el problema está en la API, no en el cliente
Una sesión que se bloquea en cada turno en el mismo punto, con un pequeño indicador de carga y una línea de reintento que acaba apareciendo, indica una conexión a la API lenta o con cortes en lugar de un fallo del cliente: 529 sobrecargado, limitación del lado del servidor o una conexión restablecida. A través de una puerta de enlace (ANTHROPIC_BASE_URL=https://aiprimetech.io), se cambia de una cuenta saturada del proveedor a otra, lo que acorta precisamente estas esperas.
¿Te has cansado de lidiar con este error?
Ejecuta Claude Code a través del gateway de AI Prime Tech: los mismos modelos Claude en las cuentas de origen propias del gateway, dos variables de entorno para cambiar, y las cuentas nuevas reciben $5 de crédito gratuito para la API con el código FIXIT — sin tarjeta.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyPreguntas frecuentes
¿Por qué Claude Code se queda atascado y no responde?
Está esperando algo: un flujo de la API, una herramienta que ha iniciado, un servidor MCP o una solicitud de aprobación fuera de la pantalla. Pulsa Esc para cancelar la herramienta y Ctrl+C dos veces para interrumpir la ejecución; si nada responde, termina el proceso y reanuda con claude -c.
¿Cómo soluciono el bloqueo de Claude Code en /rewind?
Actualiza a una versión actual; el bloqueo se notificó en 2.1.1xx y Anthropic no pudo reproducirlo en 2.1.233. En una versión antigua, termina el proceso y usa claude -c en lugar de /rewind.
¿Por qué Claude Code utiliza tanta memoria?
Los resultados grandes de las herramientas y las transcripciones de las sesiones se conservan completos, los subagentes los multiplican y, en las versiones nativas, una expresión regular de grep con retroceso se ejecuta dentro de un proceso claude con un heap de V8 grande. Lee menos, excluye los archivos generados por la compilación y reduce la concurrencia.
Claude Code se bloquea al iniciar sin mostrar el prompt. ¿Qué debo comprobar?
La primera solicitud a la API no devuelve una respuesta: variables de proxy, VPN, DNS o un ANTHROPIC_BASE_URL inaccesible. Ejecuta curl contra el endpoint, después claude doctor y elimina los servidores MCP que agoten el tiempo de espera.
Ejecuta Claude Code con la pasarela
Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código FIXIT.
Obtener una clave de API Ver planes ilimitadosAI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.