Qué son las tareas en segundo plano
Claude Code puede ejecutar un comando de shell sin hacerte esperar. La referencia lo describe así: "Cuando Claude Code ejecuta un comando en segundo plano, ejecuta el comando de forma asíncrona e inmediatamente devuelve un ID de tarea en segundo plano. Claude Code puede responder a nuevos prompts mientras el comando continúa ejecutándose en segundo plano".
Los candidatos habituales son cosas que tardan un tiempo o que nunca terminan por sí solas. Anthropic enumera herramientas de construcción, gestores de paquetes, ejecutores de pruebas, servidores de desarrollo y procesos de larga duración.
El trabajo en segundo plano en una sesión no son solo comandos de shell. Los subagentes también pueden ejecutarse en segundo plano, y la vista /tasks los enumera junto a los shells. La descripción general del trabajo paralelo de Anthropic traza una línea entre ambos: un comando bash en segundo plano "ejecuta un comando de shell sin bloquear la conversación. No genera un agente".
Cómo termina un comando en segundo plano
Hay tres formas:
- Pidiéndolo. Indica a Claude Code que ejecute un comando en segundo plano.
- Presionando Ctrl+B. Mueve una llamada regular a la herramienta Bash al segundo plano. "Los usuarios de tmux deben presionar
Ctrl+Bdos veces debido a la tecla de prefijo de tmux". - Dejando que expire el tiempo. "Cuando un comando alcanza su tiempo de espera antes de terminar, Claude Code lo mueve automáticamente al segundo plano en lugar de detenerlo, a menos que el comando comience con
sleep".
Cada tarea en segundo plano recibe un ID y su salida va a un archivo. "La salida se escribe en un archivo y Claude puede recuperarla usando la herramienta Read". Así es como Claude puede verificar una ejecución de prueba que inició anteriormente en la sesión.
Qué muestra /tasks
/tasks es la vista para el trabajo en segundo plano en tu sesión actual. La referencia de comandos lo describe como: "Ver y gestionar el trabajo en segundo plano en la sesión actual, incluyendo subagentes que han terminado". También está disponible como /bashes.
De la descripción general del trabajo paralelo: "Para cualquier cosa que se ejecute en segundo plano de la sesión actual, /tasks enumera cada elemento y te permite verificarlo, adjuntarte a él o detenerlo. La lista también incluye subagentes que han terminado".
Dos detalles son fáciles de pasar por alto:
- Se ejecuta inmediatamente. Claude Code ejecuta algunos comandos sin interrumpir una respuesta, y
/taskses uno de ellos. - Cubre la sesión actual. No es una lista de todos los procesos en segundo plano de tu máquina, y no es una lista de otras sesiones.
Un cambio reciente hace que sea más fácil volver a los subagentes terminados. Claude Code v2.1.319, lanzado el 6 de noviembre, añadió una fila a /tasks que enumera los subagentes terminados, "para que puedas reabrir uno y enviarle mensajes incluso después de que salga de la lista o reinicies".
La lista de tareas que activas con Ctrl+T es algo diferente. Es la lista de tareas pendientes de Claude para un plan, no la vista de tareas en segundo plano. Lo cubrimos en nuestra guía sobre por qué la lista de tareas de Claude Code está vacía.
Qué sucede al salir
La regla es corta: "Las tareas en segundo plano se limpian automáticamente cuando Claude Code finaliza".
En macOS y Linux, la limpieza llega más allá del shell. "Cuando detienes una tarea en segundo plano desde /tasks o Claude Code la detiene al salir, los procesos que se desvincularon del shell de la tarea, como los iniciados bajo setsid o timeout, también se detienen".
Por lo tanto, en macOS y Linux, un servidor de desarrollo iniciado como una tarea en segundo plano se detiene cuando termina la sesión, incluso si se inició de una manera que normalmente sobreviviría al shell.
Salir con subagentes o flujos de trabajo en ejecución. Si intentas salir mientras algunos tipos de trabajo en segundo plano están en ejecución, como subagentes o flujos de trabajo, Claude Code te advierte. La documentación de la vista de agente dice que un diálogo "advierte que el trabajo se detiene" y ofrece la opción de mover la sesión al segundo plano y salir en su lugar. Esa opción no se muestra cuando la vista de agente está desactivada.
Otras formas en que las tareas en segundo plano se detienen
Salir no es el único final. La referencia enumera varios más.
Demasiada salida. "Las tareas en segundo plano se terminan automáticamente si la salida supera los 5GB, con una nota en stderr explicando el motivo".
Presión de memoria durante el tiempo de inactividad. "En macOS y Linux, Claude Code detiene tus tareas en segundo plano en ejecución cuando el sistema operativo informa de una presión de memoria crítica, siempre que la sesión haya estado inactiva durante al menos 30 minutos y no haya ningún turno o subagente en ejecución".
Todo esto debe cumplirse: el sistema está bajo presión de memoria crítica y la sesión ha estado inactiva durante al menos 30 minutos sin nada en ejecución. El registro de depuración registra por qué se detuvieron las tareas o por qué un evento de presión las dejó en ejecución. Para desactivar este comportamiento, establece CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP en 1. La referencia de variables de entorno señala que Windows no tiene señal de presión de memoria.
Límites de tiempo en sesiones no supervisadas. "Los comandos en segundo plano en una sesión local en la que trabajas desde una terminal, la aplicación de escritorio o la extensión de VS Code no tienen límite de tiempo". En una sesión que se ejecuta sin supervisión, como una ejecución con -p o una sesión en la nube, Claude Code detiene un comando en segundo plano al alcanzar su límite de tiempo.
El subagente que lo inició termina. "Un comando en segundo plano que inició un subagente en primer plano termina cuando termina la ejecución de ese subagente, ya sea porque finalizó, falló o fue interrumpido".
Este último punto afecta a quienes delegan el trabajo de configuración. Si un subagente inició tu servidor de desarrollo en segundo plano, la vida del servidor está ligada a la ejecución de ese subagente.
Cómo mantener el trabajo en segundo plano en ejecución
Si quieres que el trabajo continúe después de irte, la ruta documentada es pasar la sesión a segundo plano, no salir de ella.
La referencia dice: "Si pasas la sesión a segundo plano en lugar de salir, tus tareas en segundo plano seguirán ejecutándose en la sesión en segundo plano".
Hay varias formas de hacerlo:
/background, o/bg. "Desvincula la sesión actual para que se ejecute como un agente en segundo plano y libera esta terminal". Puedes pasar una instrucción más y monitorear la sesión conclaude agents.- El diálogo de salida. Cuando Claude Code advierta que el trabajo en segundo plano se detendrá, elige mover la sesión al segundo plano y salir.
- Iniciar en segundo plano. Pasar
--bgal iniciar Claude Code inicia una sesión que va directamente al segundo plano.
Las sesiones en segundo plano aparecen en la vista de agente, junto con su estado y si necesitan tu intervención. Cubrimos lo que estas sesiones inician y comparten en nuestra guía sobre qué es la vista de agente de Claude Code.
Una advertencia para los flujos de trabajo dinámicos. Cuando pasas a segundo plano una sesión con un flujo de trabajo en ejecución, cualquiera de sus subagentes que aún estén en ejecución "comienzan de nuevo y gastan sus tokens otra vez" cuando Claude reinicia el flujo de trabajo. El diálogo te indica cuántos, y puedes elegir quedarte hasta que terminen.
Desactivar las tareas en segundo plano
Si prefieres que nada se ejecute en segundo plano, hay un interruptor. "Para desactivar los comandos en segundo plano, establece la variable de entorno CLAUDE_CODE_DISABLE_BACKGROUND_TASKS en 1".
Tiene efectos más amplios de lo que sugiere el nombre. "Con ella activada, también pierdes el atajo Ctrl+B y otras funciones de segundo plano, como la ejecución de skills en segundo plano". La referencia de variables de entorno añade que Claude Code también deja de mover automáticamente al segundo plano subagentes, llamadas largas a herramientas MCP y comandos de shell que han expirado.
Iniciar en modo bare tiene el mismo efecto. Y con los comandos en segundo plano desactivados, un comando que alcanza su tiempo de espera se detiene en lugar de moverse al segundo plano.
Lo que una tarea en segundo plano no conserva
Una tarea en segundo plano produce una salida: registros, resultados de pruebas, un servidor en ejecución. Claude Code escribe esa salida en un archivo y Claude puede leerla durante la sesión.
Lo que la tarea no produce es un resumen de lo que significó el resultado. Si una ejecución de prueba encontró una prueba inestable, o una construcción falló por una razón que luego corregiste, esa conclusión vive en la conversación. La tarea se limpia al salir, y el razonamiento es tan duradero como la sesión en la que ocurrió.
Eso está bien para un servidor de desarrollo. Importa más para ejecuciones largas cuyos resultados deciden qué hacer a continuación.
Lo que la gente intenta primero
Cerrar la terminal y esperar que el servidor siga funcionando. Las tareas en segundo plano se limpian cuando Claude Code finaliza.
Buscar tareas de otra sesión en /tasks. Muestra el trabajo en segundo plano de la sesión actual.
Iniciar un proceso bajo setsid para que sobreviva a la sesión. En macOS y Linux, los procesos desvinculados también se detienen cuando Claude Code detiene la tarea.
Dejar una máquina potente inactiva. Bajo presión de memoria crítica, las tareas pueden detenerse después de 30 minutos de inactividad.
Delegar el inicio de un servidor a un subagente. El comando en segundo plano de un subagente en primer plano termina cuando termina la ejecución del subagente.
La solución: Mantener vivo el trabajo en segundo plano cuando lo necesites
Paso 1: Decide si el trabajo debe sobrevivir a la sesión
Los servidores de desarrollo para una comprobación rápida pueden terminar con la sesión. Las ejecuciones de pruebas largas y las construcciones a las que volverás no deberían.
Paso 2: Pasa la sesión a segundo plano en lugar de salir
Usa /background o elige mover a segundo plano en el diálogo de salida, y verifícalo más tarde con claude agents.
Paso 3: Revisa /tasks antes de irte
Mira qué sigue en ejecución, incluyendo subagentes terminados que podrías querer reabrir.
Paso 4: Anota lo que significaron los resultados
Registra las conclusiones de las ejecuciones largas, como qué pruebas son inestables y por qué falló una construcción, fuera de la sesión.
Configurando esto en MemoryLake
Las tareas en segundo plano están diseñadas para ser temporales y Claude Code las limpia al salir. Las conclusiones a las que llegas a partir de su salida, como qué prueba es inestable o qué dependencia rompió la construcción, son lo que la próxima sesión necesita.
MemoryLake es una capa de memoria para ese tipo de contexto de proyecto, como decisiones, hallazgos y restricciones, mantenidos en un solo lugar que tú gestionas y disponibles para los asistentes que conectes, como ChatGPT, Claude Code y Codex.
Tú mismo escribes las entradas, con tus propias palabras. No se lee nada, ni se escribe ni se borra de tus tareas en segundo plano, sus archivos de salida, tus sesiones, tus transcripciones de sesión, tu carpeta ~/.claude o el almacenamiento de cualquier proveedor. Las tareas en segundo plano, /tasks y la limpieza funcionan de la manera que Anthropic describe.
Paso 1: Crea una clave API
Inicia sesión y genera una clave desde el panel de control. Guárdala fuera de tus repositorios, como cualquier otra credencial.

Paso 2: Sube tus primeras memorias
Comienza con lo que escribiste en el Paso 4 de la solución: qué mostraron las ejecuciones largas, qué fallos son conocidos y qué decidiste debido a ellos. Un hallazgo por entrada.

Paso 3: Conecta tu IA y agentes
Conecta Claude Code y cualquier otro asistente que uses. Una nueva sesión, después de que las tareas de la anterior se limpiaran, puede recurrir a los mismos hallazgos.

Qué cambia esto en la práctica
La primera diferencia es que cerrar una sesión no cierra la investigación. Los hallazgos de las ejecuciones en segundo plano de ayer siguen anotados.
La segunda es menos repetición de ejecuciones. Cuando sabes que una prueba es inestable, no necesitas redescubrirlo en cada sesión.
La tercera es la continuidad entre herramientas. Codex u otro asistente que trabaje en el mismo repositorio puede usar los mismos hallazgos.
Mejores prácticas para las tareas en segundo plano de Claude Code
Conoce la regla de salida. Las tareas en segundo plano se limpian cuando Claude Code finaliza.
Pasa la sesión a segundo plano para mantener el trabajo en ejecución. Usa /background en lugar de salir.
Usa /tasks para la sesión actual. Enumera el trabajo en segundo plano, incluyendo subagentes terminados.
Vigila la memoria en periodos largos de inactividad. Las tareas pueden detenerse bajo presión de memoria crítica después de 30 minutos de inactividad.
Mantén los servidores fuera de los subagentes. Los comandos en segundo plano de un subagente en primer plano terminan con su ejecución.
Desactiva las tareas en segundo plano deliberadamente. El ajuste también elimina Ctrl+B y otras funciones de segundo plano.
Anota lo que significaron los resultados. La salida de la tarea es temporal y las conclusiones no deberían serlo.
Conclusión
Las tareas en segundo plano de Claude Code permiten que los comandos de shell y los subagentes se ejecuten mientras sigues trabajando, y /tasks enumera el trabajo en segundo plano en la sesión actual, incluyendo los subagentes que han terminado. Cuando Claude Code finaliza, las tareas en segundo plano se limpian, y en macOS y Linux eso incluye los procesos que se desvincularon del shell de la tarea.
Las tareas también pueden detenerse cuando la salida supera los 5GB, cuando el sistema informa de presión de memoria crítica después de 30 minutos de inactividad, en sesiones no supervisadas al alcanzar su límite de tiempo, o cuando el subagente en primer plano que las inició termina. Para mantener el trabajo en ejecución, pasa la sesión a segundo plano en lugar de salir, y guarda las conclusiones de las ejecuciones largas en algún lugar donde la próxima sesión pueda leerlas.