Claude Code では、循環するウィンドウでトークン予算を 5 時間分確保します。このウィンドウはその日の最初の「あなたのメッセージ」を送った瞬間に開始されます。たとえば、8:30 に急ぎの質問をした場合、11:00 までに予算が使い切られてしまうと、13:00 まで使用できないようにロックされます。結果として、日中に使っていない時間が発生します。
開発者たちは、claude-warmup と、予約実行する GitHub Action を使うことで、簡単な回避策を作りました。これにより、仕事を始める前に Claude Haiku に「こんにちは」というメッセージを 1 回だけ送ります。このメッセージによって 5 時間の予算ウィンドウが、あなたが選んだ時間に紐づきます。実際に Claude を開いた時刻ではありません。
なぜ効くのか
Claude Code は、予算ウィンドウを「最初のメッセージが送られた時間」に紐づけます。たとえば最初のメッセージを 6:15 に送ると、ウィンドウは 6:00 から始まり、11:00 まで 5 時間動作します。朝のうちに予算が尽きると、次のウィンドウは 11:00 にすぐ開始されます。
ウォームアップの送信はほとんどトークンを消費しません。たとえば、文脈なしで Claude Haiku に「こんにちは」を送るだけなら、消費されるトークンは非常に少なくて済みます。
設定（6 ステップ）
1. リポジトリをフォークする
gh repo fork vdsmon/claude-warmup --clone
cd claude-warmup
2. OAuth トークンを作成する
Claude Code がインストールされているマシンで次を実行します：
claude setup-token
sk-ant-oat01-... というトークンが約 1 年間使える状態で保存されます。
3. トークンを GitHub secret に保存する
gh secret set CLAUDE_OAUTH_TOKEN
GitHub Actions が要求してきたときに、このトークンで認証するため、値を入力します。
4. cron のスケジュールを設定する
希望するタイムゾーンに合わせてウォームアップの時間を設定します。デフォルトは平日 9:15 UTC です。例：
gh variable set WARMUP_CRON --body "15 13 * * 1-5"
参照用の一部：
| あなたのタイムゾーン | 午前 9 時の開始に向けたウォームアップ | 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（中央ヨーロッパ） | 8:45 AM = 7:45 UTC | 45 7 * * 1-5 |
5. ワークフローをテストする
gh workflow run warmup.yml
フォークしたリポジトリの Actions タブで、正常に実行されたか確認してください。
6. 動作することを確認する
翌朝、Claude Code を開いて次を実行します：
/usage
リセット時間は、設定した時間と一致するはずです。たとえば 8:45 にウォームアップを設定した場合、ウィンドウは 8:00 にリセットされるはずです。
代替案：自分のマシンで実行する
GitHub Actions を使わなくても構いません。cron や launchd 経由でこのコマンドを実行することもできます：
claude -p "hi" --model haiku --no-session-persistence
同じ時刻に crontab（crontab -e）へ追加すれば、結果は同じです。重要なのは、あなたのマシンでもサーバーでも、仕事を始める前にメッセージを送ることです。
予算をより長く使うためのヒント
- Extended Thinking はトークンを大量に消費する 必要のない作業では避けましょう。たとえば、複雑な質問やロジックのデバッグのときだけにするなどです。
-
コンテキストを減らす 未使用のファイルは閉じる。複数のファイルを同時に開きすぎない。一時的なコマンドには
--no-session-persistenceを使います。 - リクエストをまとめる 小さな複数の質問を、包括的な 1 つの質問にまとめてトークンを節約し、より効率的な回答を得ます。
-
Haiku を軽作業に使う リネーム、変数・関数の boilerplate、コードの整形などの作業では
--model haikuを使うと、より大きくトークンを節約できます。
あなたが Claude Code と一緒に API を作っているなら
多くの開発者は、API を作成・テストするときに Claude Code を使います。もしあなたのワークフローがこのような形なら、Apidog はとても相性が良いです。API のスキーマを設計し、モックサーバーを作り、すべてを同じ場所で自動テストまで回せます。ツールを切り替える必要はありません。Claude Code がエンドポイントを作成したら、Apidog ですぐにテストできます。コピペして移す必要がありません。
無料で始められ、REST、GraphQL、gRPC をすぐにサポートします。
覚えておくこと
- 最初のメッセージ送信時にウィンドウがロックされます 5 時間のウィンドウは、その日の間ずっと変わりません。
- 予算は共有されます claude.ai、Claude Code、Claude Desktop はすべて同じプールから Extended Thinking とツールの使用により、通常のチャットよりも早く消費されます。
- 7 日間の上限はまだあります このテクニックで制御できるのは日次リセットであり、週次の上限ではありません。
- トークンは時間単位でリセットされます 8:47 のウォームアップは 8:00 に紐づきます。cron は 15 分前に計画しておきましょう。
もし時間どおりにセッションが切れてしまうなどの問題に遭遇した場合、この方法はセットアップに 10 分未満で、毎日自動で動作します。完全なリポジトリは github.com/vdsmon/claude-warmup で確認できます。
