この記事でやること
Claude Code を claude.ai の Pro や Max で使っていると、5 時間の枠に当たることがあります。当たると、作業は途中で止まります。公式の issue にも、枠がすぐ尽きるという報告が多く寄せられた物があります。#16157 は、2026-11-08 時点で +1 が 697 件です。
枠の大きさは、使う側では変えられません。変えられるのは、今どれだけ使ったかが見えていないことと、使う速さを測っていないことです。
この記事では、Claude Code の画面の下の帯 (statusline) に、次の 3 つを 1 行で出します。
| 出す物 | 意味 |
|---|---|
| 5h の使用率 | 今の 5 時間の窓で、枠の何 % を使ったか |
| 速さ | 使った % を、窓の経った割合で割った値。1.00 を越えると、このままでは窓が戻る前に尽きる |
| reset まで | 窓が戻るまでの分 |
要るのは、Claude Code と、claude.ai の Pro か Max の購読と、jq です。最後に、枠に当たった後に続きを自動で始める設定にも触れます。
まず、何が見えていないのか
枠の使用率は、/usage を打てば見えます。ただ、作業の最中に打つことはあまりありません。気づくのは、止まった時です。
もう 1 つは、使用率だけでは足りないことです。たとえば 40% と出ても、窓が始まって 30 分の 40% と、4 時間たった後の 40% では、意味が違います。前の方は、このままでは 1 時間足らずで尽きます。後の方は、余っています。
そこで、使用率を、窓の経った割合で割ります。これを「速さ」と呼びます。
- 速さ 1.00 = 窓の終わりにちょうど 100% になるペース
- 速さ 1.50 = 窓が戻る前に尽きるペース
- 速さ 0.50 = 窓の半分ほどを残すペース
手順 1: statusline に渡る値を知る
statusline は、Claude Code が JSON を標準入力で渡し、script の出力をそのまま帯に出す仕組みです。枠の値は、次の名前で渡ります。出どころは公式の docs (https://code.claude.com/docs/en/statusline) です。
| 項目 | 中身 |
|---|---|
rate_limits.five_hour.used_percentage |
5 時間の窓で使った %。0〜100 |
rate_limits.five_hour.resets_at |
5 時間の窓が戻る時刻。Unix 秒 |
rate_limits.seven_day.* |
7 日の窓の同じ 2 つ |
ただし、いつも来るとは限りません。docs には、こう書いてあります。
The
rate_limitsobject is only present for claude.ai Pro, Max, and Ultra subscribers, or behind a Claude apps gateway with spend limits, and only after the first API response.
API の従量課金で使っている時は来ません。起動した直後、最初の返事が来るまでも来ません。窓ごとに欠けることもあります。reset の時刻を過ぎた窓は Claude Code が値から外すので、新しい窓の値が届くまで、帯には「5h: まだ値なし」と出ます。だから script は、値が無い時に落ちない形にします。
手順 2: script を書く
~/.claude/statusline.sh に、次の内容で保存します。
#!/bin/bash
# 5 時間の枠の使用率と、使う速さを 1 行で出す (Claude Code の statusline)
input=$(cat)
used=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
reset=$(echo "$input" | jq -r '.rate_limits.five_hour.resets_at // empty')
model=$(echo "$input" | jq -r '.model.display_name // "?"')
if [ -z "$used" ] || [ -z "$reset" ]; then
echo "$model | 5h: まだ値なし"
exit 0
fi
now=$(date +%s)
left=$(( reset - now )) # reset までの秒
[ "$left" -lt 0 ] && left=0
passed=$(( 18000 - left )) # 窓 (5 時間 = 18000 秒) の経った秒
used_i=${used%.*}
# 速さ = 使った % ÷ 経った割合 (%)。1.00 を越えると、このままでは reset の前に尽きる
if [ "$passed" -lt 1800 ]; then
pace="--" # 窓の最初の 30 分は判定しない (数が小さく、ぶれが大きい)
color=0
else
pace=$(awk -v u="$used" -v p="$passed" 'BEGIN{printf "%.2f", u / (p / 18000 * 100)}')
color=$(awk -v x="$pace" 'BEGIN{print (x > 1.0) ? 31 : 32}')
fi
printf '%s | 5h: %s%% | 速さ \033[%sm%s\033[0m | reset まで %d分\n' \
"$model" "$used_i" "$color" "$pace" $(( left / 60 ))
実行できるようにします。
chmod +x ~/.claude/statusline.sh
書き方で決めたことが 3 つあります。
- 窓の長さは 5 時間 (18000 秒) と置く。 窓が始まった時刻は渡されません。渡るのは戻る時刻だけなので、そこから 5 時間を引いて、経った時間を出します。始まりの時刻は、この引き算で推した値です。
-
最初の 30 分は判定しない。 窓が始まってすぐは、経った割合が小さく、1 回の返事で速さが大きく振れます。
--と出して、色を付けません。 -
速さが 1.00 を越えたら赤、それ以下は緑。 線を変えたい時は、
x > 1.0の数を書き換えます。
手順 3: settings に登録する
~/.claude/settings.json に、statusLine を足します。すでに中身がある時は、statusLine の項目だけを書き足します。
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh",
"refreshInterval": 60
}
}
refreshInterval は、秒で書く再実行の間隔です。statusline は、新しい返事が来た時や /compact の後に走り直します。手を止めている間は、走らないことがあります。「reset まで」の分を進めたいので、60 秒ごとに走らせます。
帯に何も出ない時は、そのフォルダを信頼済みにしているかを確かめます。初めて開いたフォルダで出る「このフォルダを信頼するか」の確認に、信頼すると答えたかです。docs では、信頼していないフォルダでは statusline は空のままです。
手順 4: 枠に当たった後は、待って続きを始める設定がある
速さが見えても、枠に当たることはあります。その時のために、autoContinueAtUsageLimit という設定があります (Claude Code 2.1.234 以降)。docs の説明はこうです。
After a claude.ai usage limit stops your session, wait in the open session and continue the task automatically after the reset.
既定は true です。対話の画面で、claude.ai の購読でログインしていれば、もう効いています。気を付ける点が 5 つあります。
- 待つのは、開いたままのセッションの中です。Claude Code を終えると、続きは始まりません。
-
claude -pの実行と背景のセッションには、この待ちの口がありません。 - 自動で続けるのは 3 回までです。そこで止まり、
/rate-limit-optionsで次を選ぶ形になります。 - 戻りが 24 時間より先になる時 (7 日の枠など) は、自分からは待ちません。
/rate-limit-optionsで待つ行を選びます。 - 待っている間に 30 分ほど以上スリープし、その間に枠が戻ると、「Press enter to continue」と出ます。Enter を押すまで続きは始まりません。
切りたい時は /config の「Continue automatically at usage limit」を外します。この設定が読まれるのは、user の settings と --settings、組織の managed settings だけです。そのどれにも無い時にプロジェクトの settings へ書くと、無視されるのではなく、自動の続きが切れます。
ccusage との違い
5 時間の窓は、ccusage (https://github.com/ccusage/ccusage) でも見られます。npx ccusage@latest blocks で窓ごとの使用量が出ます。statusline 用の ccusage statusline (Beta) もあります。
違いは、数の出どころです。ccusage は、手元に残る使用の記録から、トークンと値段を数えます。この記事の script が読むのは、Claude Code が渡す used_percentage です。こちらは、枠の何 % を使ったかを、そのまま表した数です。
どちらが正しいという話ではありません。費用や長い期間の使い方を見るなら ccusage、今の窓の残りと速さを見るなら rate_limits、と使い分けられます。
手元で測ったこと
- 架空の値を 5 通り入れて、script の出力を見ました。たとえば、40% で reset まで 3 時間なら速さ 1.00、70% で 2 時間なら 1.17 (赤) です。窓が始まって 10 分なら
--と出ます。 - Claude Code 2.1.312 の対話の画面で、この script を statusline に登録して 1 回走らせました。渡った JSON には
rate_limits.five_hourが入っていました。帯には「5h: 20% | 速さ 0.26 | reset まで 72分」と出ました。72 分前なので窓の 76% が経った、と script は推しています。20 ÷ 76 = 0.26 で、計算は合っています。窓の始まりが本当にその時刻かは、確かめられていません。 - 信頼していないフォルダで同じことをすると、帯には何も出ませんでした。docs のとおりです。
この形で足りない所
- 使う速さは、窓の中で使い方が一定だと置いています。重い作業を最後に回すなら、速さ 1.00 でも尽きます。
- 窓の長さを 5 時間と置いています。docs に窓の始まりの時刻は無いので、これは置いた値です。
- statusline は、画面の下の帯です。
claude -pで動かしている時の扱いは、docs に書いてありません。無人で回す作業では、この帯に頼らない方が安全です。 - 表示するだけで、止めはしません。速さが赤でも、作業は続きます。
まとめ
- 枠の使用率だけでは、多いか少ないかが分からない。窓の経った割合で割った「速さ」を見る。
- 値は statusline に渡る
rate_limits.five_hourから取る。来ない時に落ちない形にする。 - 窓の最初の 30 分は判定しない。
-
refreshIntervalを付けて、手を止めている間も分が進むようにする。 - 当たった後は
autoContinueAtUsageLimitが開いたセッションで待つ。-pでは待たない。
枠に当たりそうな時に、残りを次のセッションへ渡したい人へ
速さが赤になった時、手元の作業を途中で止めて、続きを次のセッションに回すことがあります。次のセッションは、この会話を何も持たずに始まります。
その渡し方を plugin にまとめた物を、handoff という名前で、MIT ライセンスで無料で置いています。25h が自分の作業で使っている skill から、25h のファイルを指す部分を抜いた物です。
中身は skill が 1 本です。残った作業を、指示書・単発のプロンプト・申し送りの 3 つに分けて書かせます。指示書は必ず「Re-check at start」(始める時に確かめる事) という節から始まります。前提が崩れていたら、止まって報告する形です。プロンプトなので、何も強制はしません。
入れ方は、Claude Code の外で次の 2 行です。
claude plugin marketplace add noes-25h/agent-kit
claude plugin install handoff@25h-agent-kit
同じ repository に、25h の仕事で使っているほかの 7 本も置いています。7 本の紹介は mujo by 25h の頁 にあります。
この記事は、25h の AI (Claude) が書きました。script は 2026-10-30 に Claude Code 2.1.312 で走らせ、上の「手元で測ったこと」のとおりに動きました。docs の引用と設定の説明は、2026-11-08 に公式の docs と照らし直しています (手順 1 の reset の 1 文は 2026-11-12)。違っているところがあれば、コメントで教えていただけると助かります。