Claude Code te ofrece un presupuesto de tokens de 5 horas en una ventana móvil. El problema: esa ventana comienza en el momento en que envías tu primer mensaje del día. Si haces una pregunta rápida a las 8:30 AM y agotas tu presupuesto para las 11 AM, te quedas bloqueado hasta la 1 PM, dos horas muertas justo en medio de tu jornada laboral.
Un desarrollador creó una solución elegante para esto. Se llama claude-warmup, y utiliza una GitHub Action programada para enviar un "hola" desechable a Claude Haiku antes de que comience tu jornada laboral. Ese único mensaje ancla tu ventana de 5 horas a una hora que tú eliges, no a cuando abres Claude por casualidad.
Por qué funciona
La ventana de presupuesto de Claude Code se ancla a la hora en punto de tu primer mensaje. Un mensaje enviado a las 6:15 AM fija la ventana a las 6:00 AM, por lo que tu bloque de 5 horas va de 6 AM a 11 AM. Cuando agotas tu presupuesto a media mañana, tu siguiente ventana comienza inmediatamente a las 11 AM.
Sin esta automatización, la ventana comienza cada vez que envías el primer mensaje a Claude, a menudo a media mañana, y el reinicio ocurre en medio de tus horas más productivas.
El "ping" de calentamiento casi no gasta tokens. Un "hola" a Claude Haiku sin herramientas ni contexto usa una cantidad insignificante de tokens.
Configuración (6 Pasos)
1. Bifurca el repositorio
gh repo fork vdsmon/claude-warmup --clone
cd claude-warmup
2. Genera un token OAuth
En una máquina donde Claude Code esté instalado, ejecuta:
claude setup-token
Esto generará un token sk-ant-oat01-.... Cópialo. Permanece válido durante aproximadamente un año.
3. Guarda el token como un secreto de GitHub
gh secret set CLAUDE_OAUTH_TOKEN
Pega el token cuando se te solicite. GitHub Actions lo utilizará para autenticarse.
4. Establece tu horario cron
El valor predeterminado es de lunes a viernes a las 9:15 UTC. Cámbialo para que coincida con tu zona horaria y horario de trabajo:
gh variable set WARMUP_CRON --body "15 13 * * 1-5"
Algunos horarios de referencia:
| Tu zona horaria | Calentamiento para inicio a las 9 AM | Expresión Cron |
|---|---|---|
| UTC | 8:45 AM UTC | 45 8 * * 1-5 |
| US Eastern (EST) | 8:45 AM = 13:45 UTC | 45 13 * * 1-5 |
| US Pacific (PST) | 8:45 AM = 16:45 UTC | 45 16 * * 1-5 |
| CET (Europa Central) | 8:45 AM = 7:45 UTC | 45 7 * * 1-5 |
5. Prueba el flujo de trabajo
gh workflow run warmup.yml
Observa la pestaña "Actions" (Acciones) en tu bifurcación para confirmar que se ejecuta correctamente.
6. Verifica que funciona
A la mañana siguiente, abre Claude Code y ejecuta:
/usage
La hora de reinicio de la sesión debe coincidir con tu hora de anclaje. Si configuraste el calentamiento para que se active a las 8:45 AM, tu ventana debería mostrar un reinicio a las 8:00 AM.
Alternativa: Ejecútalo Localmente
Si prefieres no usar GitHub Actions, ejecuta el comando de calentamiento directamente desde tu terminal a través de cron o macOS launchd:
claude -p "hi" --model haiku --no-session-persistence
Añade esto a tu crontab local (crontab -e) usando la misma lógica de temporización. Funciona igual: la clave es que el mensaje se envíe antes de que comiences tu día, no que provenga de los servidores de GitHub.
Consejos para que tu presupuesto dure más
Controlar la ventana de reinicio ayuda, pero vale la pena saber qué consume tu presupuesto más rápido para que puedas planificar en consecuencia.
El Pensamiento Extendido consume tokens rápidamente. Cuando Claude razona paso a paso a través de un problema complejo, utiliza significativamente más tokens que una respuesta directa. Guarda el Pensamiento Extendido para tareas que realmente lo necesiten, decisiones de arquitectura, depuración de lógica complicada y desactívalo para búsquedas rápidas o generación de código cuya estructura ya conoces.
Mantén el contexto ligero. Claude Code lee tus archivos abiertos y la salida reciente de la terminal como parte de cada mensaje. Cuanto mayor sea ese contexto, más tokens costará cada intercambio. Cierra los archivos en los que no estés trabajando activamente y usa --no-session-persistence cuando ejecutes comandos únicos que no necesiten historial.
Agrupa tus solicitudes. Diez preguntas pequeñas cuestan más que una pregunta bien formulada que cubra las diez. Antes de preguntar algo, tómate 30 segundos para escribir un prompt claro y completo. Obtendrás una mejor respuesta y gastarás menos tokens para conseguirla.
Usa Haiku para tareas sencillas. Cuando le pidas a Claude que cambie el nombre de una variable, genere una función base (boilerplate) o reformatee un archivo de configuración, no necesitas Opus o Sonnet. Especifica --model haiku para tareas ligeras y guarda los modelos más pesados para trabajos que requieran un razonamiento real.
Si estás construyendo APIs junto a Claude Code
Muchos desarrolladores usan Claude Code mientras construyen o prueban APIs. Si ese es tu flujo de trabajo, Apidog encaja naturalmente. Puedes diseñar tu esquema de API, generar servidores mock y ejecutar pruebas automatizadas todo desde un mismo lugar, sin cambiar entre Postman, Swagger y herramientas mock separadas. Cuando Claude Code escribe un endpoint, puedes probarlo inmediatamente en Apidog sin copiar nada entre herramientas.
Es gratis empezar y maneja REST, GraphQL y gRPC de inmediato.
Qué tener en cuenta
- La ventana se fija una vez establecida. Una vez que se envía ese primer mensaje, el bloque de 5 horas queda fijado. No cambiará a mitad del día.
- El presupuesto es compartido. claude.ai, Claude Code y Claude Desktop, todos usan el mismo presupuesto. El Pensamiento Extendido y las llamadas a herramientas lo agotan más rápido que el chat normal.
- También hay un límite de 7 días. Esta técnica controla la ventana de reinicio diaria, no el límite del presupuesto semanal.
- El token se reinicia a la hora en punto. Un calentamiento a las 8:47 AM se ancla a las 8:00 AM, no a las 8:47. Planifica tu cron 15 minutos antes de la hora deseada.
Si tus sesiones de Claude Code se agotan en el momento equivocado, esta solución tarda menos de 10 minutos en configurarse y se ejecuta sola todos los días. El repositorio completo está en github.com/vdsmon/claude-warmup.
Top comments (0)