O Claude Code oferece um orçamento de tokens de 5 horas em uma janela contínua. O detalhe importante: essa janela começa no momento em que você envia sua primeira mensagem do dia. Se você mandar uma pergunta rápida às 8:30 AM e consumir o orçamento até as 11 AM, ficará bloqueado até 1 PM, ou seja, duas horas "mortas" no meio do expediente.
Um desenvolvedor criou uma solução prática para isso: claude-warmup. Trata-se de uma GitHub Action agendada para disparar um "oi" descartável para o Claude Haiku antes do início do seu expediente. Assim, você ancora sua janela de 5 horas para um horário definido por você, e não aleatoriamente quando abre o Claude.
Por Que Isso Funciona
A janela de orçamento do Claude Code é ancorada à hora cheia da sua primeira mensagem. Por exemplo, uma mensagem enviada às 6:15 AM fixa a janela para as 6:00 AM, então seu bloco de 5 horas vai das 6 AM às 11 AM. Se consumir o orçamento no meio da manhã, sua próxima janela começa às 11 AM.
Sem esse controle, a janela começa no momento em que você envia a primeira mensagem, muitas vezes no meio da manhã, e a redefinição pode cair nas suas horas mais produtivas.
O "ping" de aquecimento consome pouquíssimos tokens. Um simples "oi" para o Claude Haiku, sem contexto ou ferramentas, gasta quase nada.
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
Na máquina com Claude Code instalado, execute:
claude setup-token
Isso gera um token no formato sk-ant-oat01-.... Copie e guarde — ele é 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 vão usar esse segredo para autenticação.
4. Defina seu agendamento cron
Por padrão, o agendamento é para dias úteis às 9:15 UTC. Ajuste conforme seu fuso horário e início de expediente:
gh variable set WARMUP_CRON --body "15 13 * * 1-5"
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
Acesse a aba "Actions" no seu fork para confirmar que a execução ocorreu sem erros.
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 coincidir com a sua hora de ancoragem. Por exemplo, se o aquecimento foi configurado para 8:45 AM, a janela deve mostrar uma redefinição às 8:00 AM.
Alternativa: Execute Localmente
Se preferir não usar GitHub Actions, rode o comando de aquecimento direto do terminal via cron ou launchd do macOS:
claude -p "hi" --model haiku --no-session-persistence
Adicione esse comando ao seu crontab local (crontab -e) usando a mesma lógica de agendamento. O importante é que a mensagem seja disparada antes do início do expediente, mesmo sem passar pelos servidores do GitHub.
Dicas para Fazer Seu Orçamento Durar Mais
- O "Extended Thinking" consome tokens rapidamente. Quando o Claude faz raciocínio passo a passo, usa muito mais tokens. Reserve para tarefas complexas, como decisões de arquitetura ou depuração, e desative para buscas rápidas ou geração de código simples.
-
Mantenha o contexto enxuto. O Claude Code lê arquivos abertos e saída recente do terminal. Quanto mais contexto, mais tokens. Feche arquivos desnecessários e use
--no-session-persistenceem comandos pontuais. - Agrupe suas solicitações. Várias perguntas pequenas gastam mais do que uma pergunta bem formulada. Reserve 30 segundos para escrever um bom prompt.
-
Use Haiku para tarefas simples. Para renomear variável, gerar boilerplate ou reformatar arquivos, use
--model haikue reserve modelos mais avançados para tarefas que realmente exigem.
Se Você Está Construindo APIs Juntamente com o Claude Code
Muitos desenvolvedores utilizam o Claude Code ao construir ou testar APIs. Se esse é seu fluxo de trabalho, o Apidog pode complementar muito bem. Com ele, você projeta esquemas de API, gera mocks de servidor e executa testes automatizados — tudo em um só lugar, sem alternar entre Postman, Swagger e mocks separados. Quando o Claude Code gera um endpoint, você já testa imediatamente no Apidog, sem copiar nada entre ferramentas.
É gratuito para começar e suporta REST, GraphQL e gRPC nativamente.
O Que Ter em Mente
- A janela é fixa uma vez definida. Depois da primeira mensagem, o bloco de 5 horas é travado até o próximo ciclo.
- O orçamento é compartilhado. claude.ai, Claude Code e Claude Desktop consomem do mesmo pool. "Extended Thinking" e chamadas de ferramentas esgotam o orçamento mais rápido que chats simples.
- Há também um limite de 7 dias. Essa técnica controla a janela de redefinição diária, não o teto semanal.
- O token é ancorado à hora cheia. Um aquecimento às 8:47 AM ancora para as 8:00 AM, não 8:47. Programe o cron para pelo menos 15 minutos antes do início do seu expediente.
Se suas sessões do Claude Code continuam acabando no momento errado, essa solução leva menos de 10 minutos para configurar e funciona sozinha, diariamente. Veja o repositório completo em github.com/vdsmon/claude-warmup.
Top comments (0)