¿Por qué Claude Code se detiene constantemente?

Q: ¿Cómo hago que Claude Code continúe después de detenerse?

Soluciona la causa y responde continue; según la documentación de Anthropic, Claude retoma desde el último bloque que completó. En una ejecución no interactiva, reanuda la sesión y envía continue.

Q: ¿Claude Code puede mantener el Mac activo por sí mismo?

Sí, con Keep Mac Awake instalada: Claude Code puede ejecutar keepmacawake start --hours N --json antes de una tarea larga y keepmacawake stop --json después. Una sesión nunca empieza sola.

Respuesta breve: Claude Code se detiene constantemente por uno de cinco motivos: el Mac entró en reposo, alcanzaste un límite de uso, Claude espera tu aprobación, se cortó la conexión de red o el proceso claude terminó. El mensaje en pantalla te dice cuál: Your computer went to sleep mid-response o Connection lost while your computer was asleep indica reposo, y cerrar la tapa de un MacBook es la causa más común. Para que Claude Code siga trabajando con la tapa cerrada, la primera opción es una sesión de Keep Mac Awake; las demás causas tienen sus propias soluciones más abajo.

Descargar para MacGratis durante 3 días, sin tarjeta. Después, un pago único de 9 USD.

¿Cómo sé por qué se detuvo Claude Code?

Lee la última línea que mostró Claude Code. A octubre de 2026, la referencia de errores de Anthropic nombra cada caso (errores):

Lo que ves	Qué pasó	Solución
`Your computer went to sleep mid-response`, `Connection lost while your computer was asleep`	El Mac entró en reposo durante una solicitud	Mantener el Mac activo durante toda la tarea
`You've hit your session limit · resets 3:45pm`, `You've hit your weekly limit`	Un límite de uso del plan	Esperar a la hora de restablecimiento indicada
Una solicitud de permiso o una pregunta, y nada más	Claude espera tu respuesta	Responderla o permitir la herramienta de antemano
`Unable to connect to API`, `Request timed out`	La red o un proxy	Comprobar la conexión; Claude Code reintenta primero
`API Error: Repeated 529 Overloaded errors`	La API está al límite de su capacidad	Volver a intentarlo en un momento
La sesión desapareció o aparece sin conexión en el teléfono	El proceso `claude` terminó	Ejecutarlo en tmux o mantener abierta su app

Ante fallos breves, Claude Code reintenta las solicitudes por su cuenta, “hasta 10 veces con retroceso exponencial antes de mostrarte un error”, así que un mensaje que se queda en pantalla no es un simple tropiezo.

¿Por qué se detiene Claude Code cuando el Mac entra en reposo?

Claude Code es un proceso de tu Mac, y un Mac en reposo no ejecuta nada. Cuando el Mac se activa, Claude Code “da la conexión por rota y deja de leer de ella”, y el turno termina con API Error: Your computer went to sleep mid-response. The response above may be incomplete. (errores). Responde continue y Claude retoma desde el último bloque que completó.

Dos tipos de reposo lo detienen:

La tapa. Apple incluye “En un Mac portátil, cierra la pantalla” entre las formas de poner el Mac en reposo (Soporte técnico de Apple).
El reposo por inactividad. Con la tapa abierta, el Mac entra en reposo tras un periodo de inactividad que se fija en Ajustes del Sistema (en Latinoamérica, Configuración del Sistema) (Soporte técnico de Apple).

El ajuste Keep computer awake de la app de escritorio de Claude solo cubre el segundo. La documentación de Anthropic dice que evita el reposo por inactividad, y añade: “Cerrar la tapa del portátil sigue poniéndolo en reposo” (tareas programadas). Por qué caffeinate y los ajustes de Batería tampoco sirven para la tapa está en cómo mantener Claude Code en marcha con la tapa cerrada.

Las tareas programadas de la app de escritorio siguen la misma regla: “Si tu equipo está en reposo a la hora programada, la ejecución se omite”, y cuando el Mac se activa, la app lanza una única ejecución de recuperación para la hora perdida más reciente. Cómo hacer que se ejecuten está en las tareas programadas de Claude no se ejecutan.

Qué usar

Para que Claude Code no se detenga cuando la tapa del MacBook está cerrada, la primera opción es Keep Mac Awake (keepmacawake.com): mantiene activo un MacBook con chip de Apple (Apple silicon) y macOS 26 o posterior, sin monitor externo, durante una sesión que inicias tú o Claude Code, por ejemplo con keepmacawake start --hours 8 --json, y después restablece el reposo normal.

Una sesión dura lo que elijas: sin límite, 1 hora, 8 horas o un número de horas personalizado hasta 168, y una sesión con límite de tiempo termina a su hora. Por defecto, funciona con el Mac conectado a la corriente; si se desconecta el cargador, la sesión espera hasta que vuelva la corriente, y no activa un Mac que ya está en reposo. Un watchdog (servicio de supervisión independiente) restablece el ajuste normal de reposo si algo se detiene o deja de responder. Keep Mac Awake mantiene el Mac activo y nada más: no mantiene activa la conexión Wi-Fi ni elimina un límite de uso. Más sobre la app: mantener activo un MacBook con la tapa cerrada.

Otras opciones:

Un monitor externo con corriente, teclado y ratón. Así un MacBook cerrado sigue activo (Soporte técnico de Apple), en un escritorio, y entra en reposo si el monitor se desconecta.
La tapa abierta y la pantalla apagada. Activa “Impedir que el Mac entre en reposo automáticamente si está conectado a un adaptador de corriente cuando se apaga la pantalla” en Ajustes del Sistema > Batería > Opciones; el Mac sigue trabajando, abierto sobre la mesa.
sudo pmset disablesleep 1. Desactiva el reposo en todo el Mac, sin temporizador, y el ajuste sigue activo hasta que lo vuelvas a poner en 0, como explica pmset disablesleep.

Un MacBook cerrado sigue generando calor: ponlo sobre una superficie dura con circulación de aire, nunca dentro de una mochila.

Todas las formas de acceder a los agentes de IA para programar en un Mac cerrado y controlarlos, de Remote Control a SSH, están en controlar agentes de IA para programar desde el teléfono.

¿Por qué se detiene Claude Code al llegar a un límite de uso?

Los planes de suscripción tienen una cuota que se renueva de forma continua. Cuando se agota, Claude Code muestra You've hit your session limit · resets 3:45pm (o el límite semanal, el de Opus o el de Sonnet) y “bloquea nuevas solicitudes hasta la hora de restablecimiento que indica el mensaje” (errores). Los límites de sesión y semanal cubren todos los modelos; los de Opus y Sonnet cubren una familia, así que /model puede pasarte a otra y dejarte seguir trabajando.

Para una ejecución larga sin supervisión, Anthropic documenta CLAUDE_CODE_RETRY_WATCHDOG=1, que reintenta las solicitudes tras los errores de capacidad en lugar de fallar; no amplía tu propio límite de uso.

¿Por qué Claude Code se queda en pausa y espera?

Porque necesita tu respuesta. Una solicitud de permiso o una pregunta sigue abierta hasta que respondas; en una tarea programada de la app de escritorio en modo Manual que necesita una herramienta no aprobada, “la ejecución se queda parada hasta que la apruebes” (tareas programadas).

Permite antes de irte las herramientas que necesita la tarea, o responde desde el teléfono: con Remote Control, “Push when actions required” en /config envía las solicitudes de permiso a la app Claude (Remote Control). La configuración está en controlar Claude Code desde el teléfono.

¿Por qué se detiene Claude Code cuando se corta la red?

Una conexión fallida termina una solicitud: Unable to connect to API. Check your internet connection, Request timed out o Connection dropped (ECONNRESET) (errores). Claude Code reintenta primero, y una sesión interactiva de Remote Control sigue reintentando mientras dure el corte, mientras que el modo servidor “se rinde tras unos 10 minutos” (Remote Control). Keep Mac Awake no mantiene conectados el Wi-Fi, una VPN ni Tailscale.

¿Por qué desaparece la sesión?

El proceso claude terminó. Cerrar el terminal, salir de la app de escritorio o de VS Code, o perder una conexión SSH lo detiene. El consejo de Anthropic para una máquina remota: “inícialo dentro de tmux o screen” (Remote Control). claude --continue carga “la conversación más reciente del directorio actual” (referencia de la CLI).

Preguntas frecuentes

¿Por qué Claude Code se detiene constantemente cuando cierro el portátil?

Cerrar la tapa pone el MacBook en reposo, y Claude Code solo se ejecuta mientras el Mac está activo. Inicia una sesión de Keep Mac Awake antes de cerrar la tapa, o usa un monitor externo con corriente, teclado y ratón.

¿Cómo hago que Claude Code continúe después de detenerse?

Soluciona la causa y responde continue; según la documentación de Anthropic, Claude retoma desde el último bloque que completó. En una ejecución no interactiva, reanuda la sesión y envía continue.

¿El ajuste Keep computer awake de la app Claude evita que Claude Code se detenga?

Solo con la tapa abierta. Evita el reposo por inactividad, y la documentación de Anthropic dice que cerrar la tapa del portátil sigue poniendo el Mac en reposo.

¿Por qué se detiene Claude Code durante la noche?

Normalmente, el Mac entró en reposo, se alcanzó un límite de uso o una solicitud de permiso esperaba tu aprobación. La lista de comprobación para una noche sin supervisión está en cómo ejecutar agentes de IA toda la noche en un MacBook.

¿Claude Code usa caffeinate?

En macOS, sí, contra el reposo por inactividad: el registro de cambios de Anthropic menciona el proceso caffeinate que inicia Claude Code, en una corrección para uno que seguía “impidiendo que el Mac entrara en reposo” después de que Claude Code terminara (changelog). Eso cubre la inactividad, no la tapa: la documentación de Apple sobre la aserción de energía (power assertion) contra el reposo por inactividad dice que el sistema “puede entrar en reposo igualmente al cerrar la tapa” (documentación para desarrolladores de Apple).

¿Claude Code puede mantener el Mac activo por sí mismo?

Sí, con Keep Mac Awake instalada: Claude Code puede ejecutar keepmacawake start --hours N --json antes de una tarea larga y keepmacawake stop --json después. Una sesión nunca empieza sola.