Cómo programar agentes de programación con IA para que trabajen mientras duermes
Todo desarrollador ha tenido el mismo pensamiento: ¿y si mi agente de programación con IA pudiera seguir trabajando después de cerrar el portátil? Tienes un backlog de tareas de refactorización, una suite de tests que necesita arreglos en 40 archivos o una migración de una versión de API a otra. Cada tarea le lleva a Claude Code entre 5 y 15 minutos. Hacerlas de una en una, haciendo de niñera de cada ejecución, supone perder una tarde entera esperando.
La idea de programar agentes de programación con IA para que se ejecuten de forma autónoma (encolar trabajo antes de acostarte y despertar con pull requests) no es ciencia ficción. Es el desbloqueo de productividad más práctico disponible hoy para los desarrolladores que usan Claude Code. Pero hay una brecha entre el sueño y la realidad del uso del CLI en crudo que la mayoría de la gente descubre por las malas.
Esta guía explica exactamente cómo programar agentes de Claude Code para que trabajen mientras duermes usando SuperBuilder, la app de escritorio gratuita y de código abierto para Claude Code. Recorreremos el sistema de cola de tareas, la ingeniería de fiabilidad que hace viables las ejecuciones nocturnas y un flujo de trabajo paso a paso para encolar cinco tareas y despertar con resultados.
Tabla de contenidos
- El sueño de programar de noche
- Por qué el CLI en crudo no puede hacer esto
- Cómo funciona la cola de tareas de SuperBuilder
- Paso a paso: encola 5 tareas antes de acostarte
- Casos de uso para ejecuciones nocturnas de agentes
- La ingeniería de fiabilidad que lo hace posible
- Notificaciones y monitorización
- Consejos para mejores resultados nocturnos
- Preguntas frecuentes
El sueño de programar de noche
La cuenta es sencilla. Una sola sesión de Claude Code puede gestionar trabajo sustancial: implementar una funcionalidad, arreglar una clase de bugs, escribir tests para un módulo o migrar un archivo de un patrón a otro. Cada una de estas tareas puede llevar entre 5 y 20 minutos de tiempo de agente. Si tienes diez de estas tareas, eso son entre una y tres horas de tiempo de cómputo: tiempo en el que no haces nada más que mirar un terminal.
Ahora imagina encolar esas diez tareas a las 11 de la noche. Te vas a dormir. El agente las recorre de forma secuencial: la tarea uno termina, la tarea dos arranca, y así sucesivamente. Para las 7 de la mañana, tienes diez tareas completadas esperando tu revisión. Eso es el trabajo mecánico de todo un sprint hecho mientras estabas inconsciente.
Este no es un flujo de trabajo teórico. Los desarrolladores que usan agentes de IA en segundo plano y automatización de tareas ya reportan aumentos de rendimiento de 2-3x en bases de código donde el trabajo puede descomponerse en tareas independientes. La restricción nunca ha sido la capacidad del modelo de IA: es el tooling que lo rodea.
Por qué el CLI en crudo no puede hacer esto
El CLI de Claude Code es potente. Ejecutar claude -p "fix the auth bug" en un terminal te lleva notablemente lejos. Pero para una operación nocturna y desatendida, el CLI en crudo tiene limitaciones fundamentales que rompen el flujo de trabajo:
Fragilidad de la sesión de terminal
Cierra la tapa del portátil y tu sesión de terminal puede morir. Las conexiones SSH expiran. macOS suspende agresivamente los procesos en segundo plano. Incluso con tmux o screen, estás luchando contra la gestión de energía del sistema operativo en lugar de trabajar con ella.
Sin cola de tareas
El CLI procesa un prompt a la vez. No hay ningún mecanismo integrado para decir "ejecuta estos cinco prompts de forma secuencial". Podrías escribir un script de bash con un bucle, pero ese script no tiene manejo de errores, ni lógica de reintento, ni conciencia de si la tarea anterior tuvo éxito o falló.
Caídas por rate limit
La API de Anthropic tiene rate limits. Cuando Claude Code alcanza un rate limit durante una tarea larga, el CLI termina con un error. Tu script de bash ve un código de salida distinto de cero y o bien se detiene por completo o inicia ciegamente la siguiente tarea sin el contexto de lo que pasó. No hay backoff, ni reintento, ni recuperación.
Sin detección de zombis
A veces un proceso de Claude Code se cuelga. El PTY produce una salida no parseable (códigos de escape ANSI en lugar de JSON, un flujo que se detiene a mitad de respuesta). En un terminal, te das cuenta y pulsas Ctrl+C. En un script desatendido, ese proceso se queda ahí para siempre, bloqueando todo lo que tiene detrás.
Sin sistema de notificaciones
Incluso si todo funciona a la perfección, no tienes forma de saber que terminó. Te despiertas, abres el portátil y compruebas manualmente cada tarea. ¿Se completó? ¿Dio error? ¿Produjo la salida correcta? El bucle de feedback es enteramente manual.
Estos no son casos extremos. Son los modos normales de fallo de ejecutar cualquier proceso de larga duración de forma desatendida. Resolverlos requiere una infraestructura creada a propósito.
Cómo funciona la cola de tareas de SuperBuilder
SuperBuilder es una app de escritorio gratuita y de código abierto que envuelve Claude Code con la infraestructura necesaria para una operación fiable y desatendida. Su cola de tareas es la función central que hace práctica la programación de agentes.
Ejecución secuencial con aislamiento
Cada tarea se ejecuta en su propia sesión de Claude Code, lanzada como un proceso PTY (pseudoterminal) mediante node-pty. Las tareas se ejecutan de forma secuencial: una termina antes de que la siguiente empiece. Esto evita la contención de recursos y garantiza que cada tarea reciba toda la atención de Claude.
La cola es persistente. Sobrevive a reinicios de la app, interrupciones por rate limit y ciclos de suspensión del sistema. Cuando SuperBuilder se despierta, retoma donde lo dejó.
Gestión de rate limits y reintento automático
Cuando Claude Code alcanza un rate limit, SuperBuilder detecta el fallo y reintenta automáticamente con backoff exponencial. En lugar de caerse y perder el progreso, la cola se pausa, espera a que la ventana del rate limit se reinicie y reanuda. Esto es crítico para las ejecuciones nocturnas, donde podrías alcanzar los límites de tu nivel de uso durante sesiones extensas.
Gestión atómica del estado
Cada operación de la cola usa actualizaciones atómicas de la base de datos. Una tarea no se marca como "enviada" hasta que el proceso de PTY confirma que ha arrancado. Esto evita la clásica condición de carrera en la que una tarea aparece como completada en la UI pero en realidad nunca se ejecutó.
Preservación del contexto de la sesión
Cada tarea puede heredar el contexto de ejecuciones anteriores o empezar de cero, según tu configuración. Para tareas relacionadas (como arreglar bugs en un módulo), la preservación del contexto significa que el agente recuerda lo que ya probó. Para tareas independientes, las sesiones nuevas evitan la contaminación del contexto.
Paso a paso: encola 5 tareas antes de acostarte
Aquí tienes un recorrido práctico. Encolaremos cinco tareas para una ejecución nocturna en un proyecto de TypeScript.
Paso 1: Abre tu proyecto en SuperBuilder
Inicia SuperBuilder y abre el directorio de tu proyecto. La app indexa tu base de código y configura la integración con Claude Code automáticamente.
Paso 2: Escribe tu primera tarea
En el compositor de prompts, escribe tu primera tarea. Sé específico: cuanto más contexto des, mejores serán los resultados nocturnos:
En lugar de enviarla de inmediato, añádela a la cola. El sistema de cola de SuperBuilder te permite apilar varias tareas que se ejecutarán en orden.
Paso 3: Añade las tareas restantes
Encola el resto de tu trabajo nocturno:
Tarea 2 -- Cobertura de tests:
Tarea 3 -- Migración de API:
Tarea 4 -- Documentación:
Tarea 5 -- Limpieza de lint:
Paso 4: Revisa la cola
Antes de marcharte, revisa el orden de la cola. SuperBuilder te muestra todas las tareas pendientes con sus prompts, su complejidad estimada y su orden de ejecución. Puedes arrastrar para reordenar, editar prompts o eliminar tareas.
Pon primero las tareas más críticas. Si algo va mal a las 3 de la madrugada, querrás que el trabajo de alta prioridad ya esté hecho.
Paso 5: Configura las notificaciones e inicia la cola
Activa las notificaciones de escritorio para recibir un resumen cuando la cola se complete. El sistema de notificaciones de SuperBuilder incluye actualizaciones de la insignia del dock y alertas de estado por tarea.
Inicia la cola. SuperBuilder empieza a procesar la tarea uno de inmediato. Puedes observar cómo arranca la primera tarea para verificar que todo funciona, y luego cerrar el portátil con confianza.
Paso 6: Despierta con resultados
Por la mañana, abre SuperBuilder. Verás un resumen de todas las tareas completadas: cuáles tuvieron éxito, cuáles dieron error y qué cambios se hicieron. El historial completo de conversación de cada tarea se conserva en la vista de hilo, para que puedas revisar exactamente qué hizo el agente, paso a paso.
Revisa los cambios, ejecuta tu suite de tests y haz push a tus ramas de funcionalidad.
Casos de uso para ejecuciones nocturnas de agentes
Programar agentes de Claude Code no es solo cuestión de comodidad: ciertas categorías de trabajo encajan mucho mejor con la ejecución en segundo plano.
Refactorización nocturna
La refactorización a gran escala es el caso de uso ideal. Renombrar un módulo, extraer una clase, migrar de callbacks a async/await o reestructurar los directorios de tu proyecto. Estas tareas están bien definidas, son mecánicas y consumen tiempo. El agente no necesita tu intervención a mitad de tarea, y los resultados son fáciles de verificar con tests.
Encola las tareas de refactorización organizadas por orden de dependencia: extrae primero las clases base, luego refactoriza las implementaciones, luego actualiza los consumidores.
Arreglos de la suite de tests
Un pipeline de CI fallido con 30 tests rotos es doloroso de arreglar manualmente pero sencillo para un agente. Encola una tarea por archivo de test o por categoría de fallo. El agente puede leer la salida de error, entender el comportamiento esperado, arreglar el test y verificar que pasa.
Para suites de tests grandes, esto puede ahorrar un día entero de depuración tediosa.
Generación de documentación
Escribir comentarios JSDoc, archivos README, documentación de API y ejemplos de código es importante pero rara vez urgente. Encola las tareas de documentación para ejecuciones nocturnas y despierta con una base de código completamente documentada. El agente puede seguir tu estilo de documentación existente y cubrir cada función exportada.
Migración de la base de código
Migrar de una versión de una librería a otra (React 18 a 19, Express 4 a 5, Stripe v2 a v3) implica actualizar cientos de puntos de llamada. La migración de cada archivo es independiente y verificable. Encola la migración archivo por archivo o módulo por módulo y deja que el agente recorra la lista.
Actualizaciones de dependencias
Las actualizaciones importantes de dependencias a menudo requieren cambios de código en todo el proyecto. Encola la propia actualización como primera tarea, y luego encola tareas de arreglo para cada módulo que se rompa. La ejecución secuencial garantiza que la dependencia se actualice antes de que empiecen los arreglos.
Preparación de la revisión de código
Antes de una revisión grande, encola tareas para añadir comentarios en línea que expliquen la lógica compleja, garantizar un formato consistente y verificar que todos los casos extremos tienen tests. Despierta con una base de código más fácil de revisar.
La ingeniería de fiabilidad que lo hace posible
Ejecutar agentes de noche solo es útil si realmente completan su trabajo. Un proceso colgado a la 1 de la madrugada significa que todo lo que tiene detrás en la cola queda bloqueado hasta que intervengas manualmente a las 7. La capa de fiabilidad de SuperBuilder es lo que marca la diferencia entre un truco y un flujo de trabajo de producción.
Detección de hilos zombi
A veces un proceso de PTY de Claude Code entra en un estado "zombi". El proceso está vivo pero no produce salida útil: puede estar atascado en un bucle, esperando una entrada que nunca llegará o produciendo códigos de escape ANSI no parseables en lugar de JSON.
SuperBuilder hace seguimiento de la tasa de fallos de parseo por hilo. Si un hilo produce más de 10 fallos de parseo en una ventana de 5 segundos, se marca como corrupto y se elimina. Esto evita que la corrupción del flujo gire para siempre y bloquee la cola.
Eliminación de emergencia para hilos atascados
Un mecanismo independiente monitoriza la actividad de los hilos. Si un proceso de PTY ha estado inactivo durante más de 20 segundos durante el procesamiento activo (sin salida, sin progreso), la función emergencyKillStuckThread() de SuperBuilder lo termina. La cola avanza entonces a la siguiente tarea.
Esto no es un timeout tosco. El sistema distingue entre las pausas de "pensamiento" (normales en tareas complejas) y los bloqueos genuinos (el proceso está colgado). El umbral de 20 segundos está calibrado contra el comportamiento real de Claude Code, donde incluso las pausas de pensamiento más largas rara vez superan los 15 segundos.
Recolección periódica de zombis
Cada 15 segundos, un recolector en segundo plano comprueba todos los hilos rastreados. Cualquier hilo que haya estado en el mapa de hilos durante más de 60 segundos sin actividad se elimina. Esto captura casos extremos que la monitorización por hilo podría pasar por alto; por ejemplo, un hilo marcado como en marcha pero cuyo proceso de PTY salió sin enviar una señal de salida adecuada.
Prevención de fugas de hilos en arranque
Cuando SuperBuilder lanza un nuevo proceso de Claude Code, añade el ID del hilo a un conjunto spawningThreadIds. Si el arranque tiene éxito, el ID se elimina. Si el arranque falla (caída, timeout, OOM), un bloque try/finally garantiza que el ID siempre se limpie. Sin esto, los IDs filtrados se acumulan y acaban convenciendo a la cola de que todos los slots están ocupados, bloqueando permanentemente las nuevas tareas.
Un timeout de arranque de 30 segundos actúa como red de seguridad. Si un proceso de PTY no ha arrancado en 30 segundos, se elimina y el slot de arranque se libera.
Difusión independiente de la ventana
Un arreglo de fiabilidad sutil pero crítico: cuando SuperBuilder necesita notificar a la UI sobre la finalización de una tarea, difunde a todas las ventanas abiertas en lugar de apuntar a una "ventana principal" concreta. El enfoque anterior fallaba silenciosamente cuando la referencia a la ventana principal era nula (común tras los ciclos de suspensión/reactivación), lo que significaba que el renderer nunca se enteraba de que una tarea había terminado. Difundir mediante BrowserWindow.getAllWindows() elimina este modo de fallo.
Notificaciones y monitorización
Las ejecuciones nocturnas necesitan un mecanismo de feedback. SuperBuilder ofrece varios:
Notificaciones de escritorio
Las notificaciones nativas de macOS se disparan cuando una tarea se completa, cuando una tarea falla y cuando toda la cola termina. Aparecen en el Centro de Notificaciones, así que puedes ver el resumen aunque revises el teléfono a primera hora de la mañana.
Insignia del dock
El icono de SuperBuilder en el dock muestra una insignia con el número de tareas completadas. De un vistazo, puedes ver que 5/5 tareas terminaron antes incluso de abrir la app.
Historial a nivel de hilo
La conversación completa de cada tarea se conserva. Puedes leer exactamente qué hizo Claude: qué archivos editó, qué comandos ejecutó, qué errores encontró y cómo se recuperó. Este registro de auditoría es esencial para las ejecuciones nocturnas en las que no estabas mirando en tiempo real.
Seguimiento de costes
Cada tarea hace seguimiento de su uso de tokens y su coste estimado. Tras una ejecución nocturna, puedes ver el gasto total de todas las tareas. SuperBuilder te avisa si una sola tarea supera los 0,10 USD, dándote la oportunidad de revisar las operaciones caras antes de que se acumulen a lo largo de una cola.
Consejos para mejores resultados nocturnos
Tras ejecutar cientos de sesiones nocturnas de agentes, estos son los patrones que producen los mejores resultados:
1. Escribe los prompts como tickets, no como conversaciones
Las tareas nocturnas no te tienen disponible para aclarar dudas. Escribe cada prompt como si fuera un ticket detallado de Jira: qué cambiar, dónde cambiarlo, cómo verificar el éxito y qué evitar. Incluye rutas de archivo, nombres de función y criterios de aceptación.
Mal: "Arregla el bug de auth"
Bien: "Arregla el bug de timeout de autenticación en src/middleware/auth.ts donde los tokens JWT no se refrescan cuando expiran durante solicitudes de larga duración. El arreglo debe usar el refresh token almacenado en la sesión para obtener un nuevo access token antes de reintentar la solicitud original. Verifica ejecutando npm test -- auth.test.ts."
2. Ordena las tareas por dependencia
Si la tarea 3 depende de la salida de la tarea 1, ponlas en el orden correcto. SuperBuilder ejecuta de forma secuencial, así que los cambios de las tareas anteriores están en disco cuando las tareas posteriores empiezan. Pero no crees cadenas largas de dependencias: prefiere tareas independientes que puedan tener éxito o fallar sin afectarse entre sí.
3. Incluye pasos de verificación en el prompt
Dile al agente que ejecute tests, comprobaciones de lint o comprobaciones de tipos después de hacer cambios. Esto captura errores durante la ejecución nocturna en lugar de dejártelos para la revisión matutina. Una tarea que termina con "ejecuta npm test y arregla cualquier fallo" tiene muchas más probabilidades de producir resultados limpios.
4. Empieza con un árbol de trabajo limpio
Antes de encolar tareas nocturnas, haz commit o stash de tus cambios actuales. Las modificaciones del agente son más fáciles de revisar cuando parten de un estado conocido. También evita conflictos de fusión entre tu trabajo en curso y los cambios del agente.
5. Usa ramas separadas por tarea
Para ejecuciones más grandes, instruye a cada tarea para que cree su propia rama. Esto te da diffs limpios para revisar y te permite hacer cherry-pick de los buenos resultados mientras descartas las tareas que se torcieron.
6. Prueba primero con una tarea
Antes de encolar una ejecución nocturna completa, ejecuta una sola tarea representativa y revisa los resultados. Esto valida que tu estilo de prompts, la configuración del proyecto y la configuración de SuperBuilder funcionan correctamente. Una ejecución de prueba exitosa te da la confianza para encolar diez tareas y marcharte.
7. Mantén las tareas centradas
Un prompt de 50 líneas que intenta lograr cinco cosas distintas producirá peores resultados que cinco prompts de 10 líneas que logran una cosa cada uno. El agente rinde mejor con objetivos claros y delimitados. Descompón tu trabajo en las unidades independientes más pequeñas.
Empieza con SuperBuilder
SuperBuilder es gratuito, de código abierto y está disponible para macOS. Configurarlo lleva unos dos minutos:
- Descarga SuperBuilder desde superbuilder.sh
- Abre la app y apúntala al directorio de tu proyecto
- Asegúrate de tener una suscripción activa a Claude Code (el plan Max es recomendable para ejecuciones nocturnas por sus rate limits más altos)
- Encola tu primera tarea y obsérvala ejecutarse
- Una vez que tengas confianza en la configuración, encola un lote y márchate
La cola de tareas, la ingeniería de fiabilidad, las notificaciones y el seguimiento de costes vienen todos incluidos de fábrica. Sin archivos de configuración, sin contenedores de Docker, sin infraestructura autoalojada.
Si ya usas Claude Code en el terminal y quieres desbloquear la automatización de claude code para trabajo desatendido, SuperBuilder es el puente entre un CLI potente y un sistema de orquestación de agentes de nivel de producción.
Preguntas frecuentes
¿Puedo programar tareas para que se ejecuten a una hora concreta?
La cola de SuperBuilder empieza a procesar de inmediato cuando la inicias. Para una programación basada en horarios, puedes usar la programación integrada de tu sistema (como Atajos de macOS o cron) para disparar SuperBuilder a una hora concreta, o simplemente iniciar la cola cuando estés listo para marcharte.
¿Qué pasa si mi ordenador se suspende?
SuperBuilder mantiene vivo el proceso de Electron y evita la suspensión mientras hay tareas en marcha. Si tu Mac llega a suspenderse (al cerrar la tapa, por ejemplo), la cola se pausa y reanuda cuando el sistema se despierta. No se pierde ninguna tarea.
¿Cuántas tareas puedo encolar?
No hay un límite estricto. La cola está respaldada por SQLite, así que gestiona cientos de tareas sin problema. El límite práctico es tu nivel de uso de Claude Code: los usuarios del plan Max tienen los rate limits más altos y pueden ejecutar la mayor cantidad de tareas por sesión nocturna.
¿Esto funciona con la clave de API o la suscripción de Claude Code?
SuperBuilder usa tu instalación y suscripción existentes de Claude Code. Lanza Claude Code como subproceso, así que cualquier método de autenticación que tengas configurado (suscripción, clave de API) funciona automáticamente.
¿Se envía mi código a los servidores de SuperBuilder?
No. SuperBuilder es completamente local. Tu código se queda en tu máquina. La app se comunica únicamente con la API de Anthropic a través de Claude Code, exactamente igual que el CLI. No hay servidores de SuperBuilder involucrados.
¿Puedo usar esto con otras herramientas de programación con IA?
SuperBuilder está creado específicamente para Claude Code. La cola de tareas, la monitorización de fiabilidad y la gestión de sesiones están todas diseñadas en torno a los comportamientos específicos y el formato de salida de Claude Code. La compatibilidad con agentes adicionales puede llegar en el futuro.
¿Y si una tarea produce malos resultados?
Cada tarea se ejecuta en su propia sesión, y todos los cambios se hacen en tu sistema de archivos local. Puedes revisar los diffs, revertir cambios con git o descartar tareas individuales. Nada se hace push a repositorios remotos a menos que el prompt de la tarea instruya explícitamente al agente para hacerlo.
¿Cuánto cuesta una ejecución nocturna?
El coste depende de tu plan de Claude y de la complejidad de las tareas. Con el plan Max (100-200 dólares al mes), obtienes un rate limit generoso que cubre la mayoría de las cargas de trabajo nocturnas. SuperBuilder hace seguimiento de los costes por tarea para que puedas monitorizar el gasto. Una ejecución nocturna típica de 5 tareas en una base de código de complejidad media usa aproximadamente entre 2 y 8 dólares de créditos de API en los planes basados en uso.
¿Listo para poner a trabajar a tu agente de programación con IA mientras duermes? Descarga SuperBuilder y empieza a encolar tareas esta noche. Es gratuito, de código abierto y está construido para desarrolladores que quieren sacarle más partido a Claude Code sin hacer de niñera de un terminal.
