Como Evitar Exceder os Limites do Código Claude Diariamente

Source: Dev.to

O que está acontecendo?

Claude Code oferece um orçamento de tokens de 5 horas em uma janela contínua.
A janela começa no momento em que você envia a sua primeira mensagem do dia.

Exemplo: se a primeira mensagem for enviada às 8:30 AM e o orçamento for consumido até as 11 AM, você ficará bloqueado até as 1 PM – duas horas “mortas” no meio do expediente.

Experimente o Apidog hoje

Um desenvolvedor criou uma solução prática: claude-warmup – uma GitHub Action que envia um “oi” descartável ao Claude Haiku antes do início do seu expediente, ancorando a janela de 5 horas ao horário que você escolher.

Por que isso funciona?

• A janela de orçamento do Claude Code é ancorada à hora cheia da primeira mensagem.

  • Mensagem enviada às 6:15 AM → janela fixa para 6:00 AM → bloco de 5 horas das 6 AM às 11 AM.
  • Se o orçamento for consumido antes das 11 AM, a próxima janela começa às 11 AM.

• Sem esse controle, a janela pode iniciar no meio da manhã, fazendo com que a redefinição caia nas suas horas mais produtivas.

• O “ping” de aquecimento consome quase nenhum token – um simples “oi” para o Claude Haiku, sem contexto ou ferramentas.

Configuração (6 passos)

1️⃣ Fork do repositório

gh repo fork vdsmon/claude-warmup --clone
cd claude-warmup

2️⃣ Gere um token OAuth

Na máquina onde o Claude Code está instalado, execute:

claude setup-token

O comando gera um token no formato sk-ant-oat01-.... Copie‑o e guarde; ele é válido por cerca de um ano.

3️⃣ Armazene o token como segredo no GitHub

gh secret set CLAUDE_OAUTH_TOKEN

Cole o token quando solicitado. As GitHub Actions usarão esse segredo para autenticação.

4️⃣ Defina o agendamento cron

Por padrão, o agendamento é para dias úteis às 9:15 UTC. Ajuste conforme seu fuso horário e horário de início:

gh variable set WARMUP_CRON --body "15 13 * * 1-5"

Horários de referência (exemplo: aquecimento às 8:45 AM local)

5️⃣ Teste o workflow

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 hora de ancoragem configurada (ex.: se o aquecimento foi para 8:45 AM, a janela mostrará redefinição às 8:00 AM).

Alternativa: Execute localmente

Se preferir não usar GitHub Actions, rode o comando de aquecimento diretamente no terminal via cron (Linux/macOS) ou launchd (macOS):

claude -p "hi" --model haiku --no-session-persistence

Adicione ao seu crontab (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

• Extended Thinking consome tokens rapidamente. Use‑o apenas para tarefas complexas (decisões de arquitetura, depuração profunda). Desative para buscas rápidas ou geração de código simples.
• Mantenha o contexto enxuto. Claude Code lê arquivos abertos e a saída recente do terminal. Feche arquivos desnecessários e use --no-session-persistence em comandos pontuais.
• Agrupe suas solicitações. Várias perguntas pequenas gastam mais tokens que uma única pergunta bem formulada. Reserve 30 s para escrever um prompt claro.
• Use Haiku para tarefas simples. Renomear variáveis, gerar boilerplate ou reformatar arquivos pode ser feito com --model haiku; reserve modelos maiores para tarefas que realmente exigem.

Se você está construindo APIs com Claude Code

Muitos desenvolvedores utilizam Claude Code ao criar ou testar APIs. Nessa situação, o Apidog complementa muito bem o fluxo:

• Desenho de esquemas (REST, GraphQL, gRPC)
• Geração de mocks de servidor
• Testes automatizados em um único ambiente

Quando Claude Code gera um endpoint, você pode testá‑lo imediatamente no Apidog, sem copiar/colar entre ferramentas.

É gratuito para começar e suporta REST, GraphQL e gRPC nativamente.

—

Este artigo foi escrito por Lucas Ferreira e publicado no Dev.to.

## Ue 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.