← Back to archive
Project

Claude Usage Warmup

Stack
GitHub Actions · YAML · Bash · Claude Code CLI

A lightweight GitHub Actions workflow that keeps Claude's rolling 5-hour usage window "pre-started" by sending a minimal prompt to the Claude API roughly every 5 hours. Since Claude's usage window begins at the first message rather than a fixed clock time, this scheduled warmup ensures the next reset is always close at hand instead of resetting from a cold start during active work sessions.

Key features:

  • Scheduled cron workflow using GitHub Actions schedule and workflow_dispatch triggers
  • Times spaced ~5h05m apart to reliably trigger a fresh usage window without waste
  • Secure token handling via GitHub Actions secrets (CLAUDE_CODE_OAUTH_TOKEN), with no token ever printed in logs and no pull_request trigger, preventing fork-based secret exposure
  • Works for both public and private repositories, with documented security guidance for each

Tech stack: GitHub Actions, YAML, Claude Code CLI, Bash

Role: Designed and implemented the workflow end-to-end, including the scheduling strategy, secret-handling security model, and setup documentation.

GitHub

Claude Usage Warmup · Tionusa Catur Pamungkas