TIPS 36 · GIORNI

Hacer que Claude trabaje durante días

El archivo de bitácora, la frase que abre cada sesión y un despertador que relanza el trabajo: así Claude sigue con el mismo proyecto durante días sin perder el hilo.

Qué es y por qué importa

Un trabajo grande no cabe en una sola conversación. Claude trabaja dentro de una memoria limitada, la ventana de contexto: ahí están el chat, los archivos que ha leído y los resultados de los comandos. Cuanto más avanzas, más se llena.

Cuando se acerca al límite, Claude Code la compacta por su cuenta: resume la conversación. Tus peticiones y el código importante se quedan, pero las instrucciones que diste al principio pueden perderse. Y cada sesión nueva empieza de cero, sin la conversación anterior.

Así que si el plan solo está en el chat, al día siguiente ya no existe. Yo lo guardo en un archivo del proyecto: cada sesión lo lee al principio y lo actualiza al final. El archivo hace de memoria y las sesiones son turnos de trabajo. Luego un despertador relanza el trabajo cuando se para.

1. El archivo de bitácora

Crea en la carpeta del proyecto un archivo BITACORA.md con este contenido:

El archivo
# Objetivo
[Una frase. Ej.: "Nueva página de precios, publicada, probada desde el móvil".]

## Hecho
- [ ] (las sesiones marcan aquí lo que han terminado, con la fecha)

## Pendiente
- [ ] [primera parte]
- [ ] [segunda parte]

## Decisiones tomadas
- (cada sesión escribe aquí lo que ha decidido por su cuenta y por qué)

## Dónde me quedé
(la última sesión escribe aquí el punto exacto desde el que retomar)

El objetivo es una sola frase, y tiene que decir cuándo el trabajo está terminado de verdad. «Nueva página de precios, publicada, probada desde el móvil» no es lo mismo que «haz la página de precios»: la primera tiene un final, la segunda no.

En «Pendiente» pon partes pequeñas, que una sesión cierre de una vez: una pantalla, una conexión, una corrección. Si una parte es «haz todo el pago», es demasiado grande. Si no sabes cómo dividirla, pídeselo a Claude antes de empezar:

El prompt
Lee BITACORA.md y el código del proyecto. Reescribe la sección 'Pendiente' en partes pequeñas y en orden, cada una lo bastante pequeña para terminarla en una sesión y poder probarla. No escribas código.

«Decisiones tomadas» es, para mí, la parte más útil. Cuando vuelves al cabo de dos días y encuentras una elección rara, ahí está escrito el porqué. Y la siguiente sesión no la deshace.

2. La frase que abre cada sesión

Cada vez que abres una sesión para este trabajo, lo primero que escribes es esto:

El prompt
Lee BITACORA.md antes de hacer nada. Trabaja solo en el primer punto de 'Pendiente'. Cuando lo termines y los tests pasen, muévelo a 'Hecho' con la fecha, escribe las decisiones tomadas y actualiza 'Dónde me quedé'. Si la conversación se hace demasiado larga, actualiza el archivo y para: otra sesión seguirá desde ahí.

«Antes de hacer nada» evita que Claude cambie archivos antes de saber dónde estamos. «Solo en el primer punto» mantiene la sesión corta. «Los tests pasan» significa que la parte funciona, no solo que está escrita: si no tienes tests, pon tu propia comprobación, por ejemplo «la página se abre sin errores».

La última frase es la que hace que el trabajo dure días. La sesión no tiene que llegar al final a toda costa: tiene que dejar el archivo en orden, para que la siguiente empiece limpia.

Si tienes que cerrar tú a mitad de una parte, pide esto antes:

El prompt
Para aquí. Actualiza BITACORA.md: en 'Dónde me quedé' escribe el punto exacto, lo que ya has cambiado y cuál es el siguiente paso. No dejes nada solo en el chat.

Si no quieres pegar la frase cada vez, puedes escribirla en el archivo CLAUDE.md del proyecto: Claude Code lo lee al principio de cada sesión y lo vuelve a cargar también después de una compactación.

3. Cuando la memoria se llena

No hace falta una sesión larguísima: ciérrala y abre una nueva con la misma frase. Vuelve a empezar desde el archivo, no desde el chat.

En Claude Code hay tres comandos que te ayudan:

  • /context te muestra cuánto se ha llenado la memoria y qué la ocupa.
  • /compact resume la conversación y libera espacio, sin salir de la sesión. Puedes darle un enfoque, por ejemplo /compact conserva las decisiones.
  • /clear abre una conversación nueva y vacía. La antigua no se pierde: la recuperas con /resume.

Para un trabajo de varios días prefiero /clear y la frase de inicio. Con la compactación, Claude Code decide qué conservar. Con el archivo sé exactamente desde dónde vuelve a empezar.

Para releer una conversación anterior, desde el terminal claude --continue reabre la última sesión de la carpeta y claude --resume te deja elegir de una lista. Para avanzar, en cambio, se vuelve a empezar desde BITACORA.md.

4. El despertador

El despertador es una comprobación automática que de vez en cuando mira si el trabajo está parado y lo relanza. En el vídeo lo dije así:

El prompt
cada hora revisa BITACORA.md; si 'Dónde me quedé' no ha cambiado y 'Pendiente' no está vacío, abre una sesión nueva con la frase de inicio

Claude Code puede lanzar un trabajo solo, con horario, de tres maneras. Lo que cambia es dónde se ejecuta y qué tiene que quedarse encendido.

En la app de escritorio: una tarea programada

Es la que uso yo para esto. En la app de escritorio, en la pestaña Code, abre Routines, crea una nueva rutina y elige Local. Escribe las instrucciones, elige la carpeta del proyecto y la frecuencia, por ejemplo Hourly, es decir, cada hora. Se ejecuta en tu ordenador, así que ve tus archivos, BITACORA.md incluido.

Hay un detalle que cambia el prompt: cada vez que arranca, la tarea ya abre ella misma una sesión nueva. Así que en las instrucciones pones directamente la comprobación y el trabajo:

El prompt
Lee BITACORA.md. Si 'Pendiente' está vacío, no hagas nada y para. Si no, trabaja solo en el primer punto de 'Pendiente'. Cuando lo termines y los tests pasen, muévelo a 'Hecho' con la fecha, escribe las decisiones tomadas y actualiza 'Dónde me quedé'. Si la conversación se hace demasiado larga, actualiza el archivo y para: otra sesión seguirá desde ahí.

Solo se ejecuta con la app abierta y el ordenador despierto: si el ordenador está en reposo, esa vuelta se salta. Y si la vuelta anterior sigue en marcha, la nueva no arranca. Antes de dejarla sola, pulsa Run now y aprueba los permisos que pida con «always allow»; si no, se bloquea en la primera petición y te espera.

En el terminal: /loop

Si trabajas desde el terminal, /loop repite un prompt a intervalos mientras la sesión siga abierta: por ejemplo /loop 1h seguido de la comprobación que hay que hacer. Pero no abre una sesión nueva: el prompt vuelve a la misma conversación. Se para si cierras el terminal y se apaga solo a los siete días. Va bien para una jornada de trabajo, no tanto para dejarlo funcionar solo.

En la nube: las rutinas

Con /schedule creas una rutina que se ejecuta en los servidores de Anthropic, incluso con el ordenador apagado, como mucho una vez por hora. Cada vuelta es una sesión nueva, pero sobre una copia recién clonada de tu repositorio de GitHub, no sobre los archivos de tu ordenador: BITACORA.md tiene que estar en el repositorio. Los cambios van a un branch aparte y la siguiente vuelta empieza otra vez desde el branch principal, así que indica en el prompt en qué branch trabajar.

Nada de magia: una bitácora y un despertador.

Errores comunes

  • Tener el plan solo en el chat: después de una compactación o de una sesión nueva ya no está. Escríbelo en BITACORA.md.
  • Partes demasiado grandes en «Pendiente»: la sesión se llena a mitad del trabajo. Divídelas hasta que cada una se cierre en una sesión.
  • Cerrar la sesión sin actualizar el archivo: la siguiente empieza a ciegas. Antes de cerrar, haz siempre que se actualice «Dónde me quedé».
  • No decir cuándo una parte está terminada: Claude la mueve a «Hecho» en cuanto la ha escrito. Pide que pasen los tests o pon tu propia comprobación.
  • Dejar la tarea programada sin haberla probado: se bloquea en la primera petición de permiso. Lánzala una vez con Run now y aprueba lo que necesite.

Lista de comprobación

  • BITACORA.md está en la carpeta del proyecto
  • El objetivo dice cuándo el trabajo está terminado
  • Cada punto de «Pendiente» se cierra en una sesión
  • Cada sesión empieza con la frase de inicio
  • Antes de cerrar, «Dónde me quedé» está actualizado
  • El despertador se ha probado una vez a mano

Preguntas frecuentes

¿Tengo que llamarlo BITACORA.md?

No, el nombre lo eliges tú. Lo que importa es que sea el mismo en el archivo, en la frase de inicio y en el despertador.

¿Puedo trabajar yo mientras está puesto el despertador?

Sí, pero no al mismo tiempo sobre el mismo archivo. Cuando te pongas a trabajar, pausa la tarea programada y reactívala cuando termines.

← Todas las guías