O Claude Code oferece um orçamento de tokens de 5 horas em uma janela contínua. A questão é: essa janela começa no momento em que você envia sua primeira mensagem do dia. Se você enviar uma pergunta rápida às 8:30 AM e esgotar seu orçamento até as 11 AM, você será bloqueado até a 1 PM, duas horas "mortas" bem no meio do seu dia de trabalho.
Um desenvolvedor criou uma solução elegante para isso. É chamada de claude-warmup, e usa uma GitHub Action agendada para enviar um "oi" descartável único para o Claude Haiku antes do seu dia de trabalho começar. Essa única mensagem ancora sua janela de 5 horas a um horário que você escolhe, e não a qualquer momento em que você abra o Claude.
Por Que Isso Funciona
A janela de orçamento do Claude Code é ancorada à hora cheia da sua primeira mensagem. Uma mensagem enviada às 6:15 AM estabelece a janela para as 6:00 AM, então seu bloco de 5 horas vai das 6 AM às 11 AM. Quando você esgota seu orçamento no meio da manhã, sua próxima janela começa imediatamente às 11 AM.
Sem isso, a janela começa sempre que você envia a primeira mensagem ao Claude, muitas vezes no meio da manhã, e a redefinição cai no meio das suas horas mais produtivas.
O "ping" de aquecimento não custa quase nada. Um "oi" para o Claude Haiku sem ferramentas ou contexto usa tokens insignificantes.
Configuração (6 Passos)
1. Faça um "fork" do repositório
gh repo fork vdsmon/claude-warmup --clone
cd claude-warmup
2. Gere um token OAuth
Em uma máquina onde o Claude Code está instalado, execute:
claude setup-token
Isso gera um token sk-ant-oat01-.... Copie-o. Ele permanece válido por cerca de um ano.
3. Armazene o token como um segredo do GitHub
gh secret set CLAUDE_OAUTH_TOKEN
Cole o token quando solicitado. As GitHub Actions usarão isso para autenticar.
4. Defina seu agendamento cron
O padrão é dias úteis às 9:15 UTC. Altere para corresponder ao seu fuso horário e horário de trabalho:
gh variable set WARMUP_CRON --body "15 13 * * 1-5"
Alguns horários de referência:
| Seu fuso horário | Aquecimento para início às 9 AM | Expressão Cron |
|---|---|---|
| UTC | 8:45 AM UTC | 45 8 * * 1-5 |
| Leste dos EUA (EST) | 8:45 AM = 13:45 UTC | 45 13 * * 1-5 |
| Pacífico dos EUA (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. Teste o fluxo de trabalho
gh workflow run warmup.yml
Observe a aba "Actions" no seu fork para confirmar que ele executa com sucesso.
6. Verifique se está funcionando
Na manhã seguinte, abra o Claude Code e execute:
/usage
O horário de redefinição da sessão deve corresponder à sua hora de ancoragem. Se você configurou o aquecimento para disparar às 8:45 AM, sua janela deve mostrar uma redefinição às 8:00 AM.
Alternativa: Execute Localmente
Se você preferir não usar GitHub Actions, execute o comando de aquecimento diretamente do seu terminal via cron ou macOS launchd:
claude -p "hi" --model haiku --no-session-persistence
Adicione isso ao seu crontab local (crontab -e) usando a mesma lógica de agendamento. Funciona da mesma forma, a chave é que a mensagem seja disparada antes de você começar seu dia, e não que venha dos servidores do GitHub.
Dicas para Fazer Seu Orçamento Durar Mais
Controlar a janela de redefinição ajuda, mas vale a pena saber o que consome seu orçamento mais rapidamente para que você possa se planejar.
O "Extended Thinking" queima tokens rapidamente. Quando o Claude raciocina passo a passo através de um problema complexo, ele usa significativamente mais tokens do que uma resposta direta. Guarde o "Extended Thinking" para tarefas que realmente precisam dele, decisões de arquitetura, depuração de lógica complicada, e desative-o para buscas rápidas ou geração de código que você já sabe como estruturar.
Mantenha o contexto enxuto. O Claude Code lê seus arquivos abertos e a saída recente do terminal como parte de cada mensagem. Quanto maior esse contexto, mais tokens cada troca custa. Feche os arquivos nos quais você não está trabalhando ativamente e use --no-session-persistence ao executar comandos únicos que não precisam de histórico.
Agrupe suas solicitações. Dez perguntas pequenas custam mais do que uma pergunta bem formulada que abrange todas as dez. Antes de perguntar algo, reserve 30 segundos para escrever um prompt claro e completo. Você obterá uma resposta melhor e gastará menos tokens para chegar lá.
Use Haiku para tarefas simples. Quando você está pedindo ao Claude para renomear uma variável, gerar uma função boilerplate ou reformatar um arquivo de configuração, você não precisa de Opus ou Sonnet. Especifique --model haiku para tarefas leves e guarde os modelos mais robustos para trabalhos que exigem raciocínio real.
Se Você Está Construindo APIs Juntamente com o Claude Code
Muitos desenvolvedores usam o Claude Code ao construir ou testar APIs. Se esse é o seu fluxo de trabalho, o Apidog se encaixa naturalmente ao lado dele. Você pode projetar seu esquema de API, gerar servidores mock e executar testes automatizados, tudo em um só lugar, sem alternar entre Postman, Swagger e ferramentas de mock separadas. Quando o Claude Code escreve um endpoint, você pode testá-lo imediatamente no Apidog sem copiar nada entre as ferramentas.
É gratuito para começar e suporta REST, GraphQL e gRPC de imediato.
O Que Ter em Mente
- A janela é fixa uma vez definida. Assim que a primeira mensagem é disparada, o bloco de 5 horas é travado. Ele não mudará no meio do dia.
- O orçamento é compartilhado. claude.ai, Claude Code e Claude Desktop todos usam do mesmo pool. O "Extended Thinking" e as chamadas de ferramentas o esgotam mais rapidamente do que um chat simples.
- Há também um limite de 7 dias. Esta técnica controla a janela de redefinição diária, não o teto do orçamento semanal.
- O token é redefinido para a hora cheia. Um aquecimento às 8:47 AM ancora para as 8:00 AM, não 8:47. Planeje seu cron 15 minutos antes da hora que você deseja.
Se suas sessões do Claude Code continuam a esgotar no momento errado, essa correção leva menos de 10 minutos para ser configurada e funciona sozinha todos os dias. O repositório completo está em github.com/vdsmon/claude-warmup.