1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code の 5 時間の枠が尽きる前に気づける。statusline に「使う速さ」を出す

1
Last updated at Posted at 2026-11-10

この記事でやること

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_limits object 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

handoff (GitHub)

同じ 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)。違っているところがあれば、コメントで教えていただけると助かります。

1
0
4

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?