📊「返答が薄い？」の正体は5h枠。ダッシュボードを3日で捨て、残量を3行で常時表示した

前作のautopilot記事で暴走対策を書いたとき、「プラン枠をstatuslineに出す」部分は一段落で流してしまいました。今回はその中身を全部出します。

仕組みは拍子抜けするくらい単純です。認証もエンドポイント呼び出しもいりません。Claude Codeがstatuslineスクリプトへstdinで渡してくるJSONを、jqで読むだけです。それで5h/7dのプラン枠、コンテキスト使用率、セッションコストと当日累計（円換算）が、3行でずっと画面に出ています。非エンジニアの僕でも「値を抜いて並べる」だけで組めました。

「返答が薄い？」の正体は5h枠だった

Claude Maxにはソフトなレート制限があります。5時間ブロックと7日窓で出力トークンが上限に近づくとモデルの挙動が変わり、使い切ると以降のスロットがskipされます。困ったのは、この消費状況がふだんまったく見えないことでした。

僕が実際に踏んだのは次の3つです。

• 「なんか返答が薄くなった？」と首をひねりながら作業を続けていたら、5h枠が埋まっていた
• autopilotが裏で使った分も合算されるのを忘れて、手作業のセッションを始めてしまう
• コスト感覚がずれたまま月末にccusageを開き、そこで初めて使いすぎを知る

3つとも、数字さえ見えていれば起きなかったことです。最初は別タブでダッシュボードを開く運用にしたのですが、3日で開かなくなりました笑。作業している画面そのものに数字があれば、見ようとしなくても目に入ります。それでstatuslineに置くことにしました。

💬 集客・導線設計と、AI導入・自動化のご相談はこちら

stdinのJSONに、欲しい値がほぼ全部入っていた

stdinから直接取れる値

Claude Codeはstatuslineスクリプトを起動するたびに、stdinへJSONを流してきます。中を覗いてみたら、欲しい値がほぼ揃っていて驚きました！

# ~/.claude/scripts/statusline.sh
INPUT="$(cat 2>/dev/null || echo '{}')"

j() { printf '%s' "$INPUT" | jq -r "$1" 2>/dev/null; }

CTX=$(j '.context_window.used_percentage // empty')
H5=$(j '.rate_limits.five_hour.used_percentage // empty')
H5R=$(j '.rate_limits.five_hour.resets_at // empty')
D7=$(j '.rate_limits.seven_day.used_percentage // empty')
D7R=$(j '.rate_limits.seven_day.resets_at // empty')
SESSION_USD=$(j '.cost.total_cost_usd // 0')

.context_window.used_percentage はClaude Code側で計算済みの値なので、自分でトークンを数える必要はありません。

気をつけたいのは rate_limits です。これはサブスク契約のユーザーが最初のAPI応答を受け取ったあとにしか現れません。// empty でフォールバックしておかないと、セッション開始直後にエラーになります。開始直後は -- 表示で、最初のターンが返ってきたら数字が出始めます。これで正常です。

リセット時刻はepoch秒で来るので、date でローカル時刻に直します。

clk()  { [ -n "$1" ] && date -r "$1" "+%H:%M" 2>/dev/null; }         # → HH:MM
mdhm() { [ -n "$1" ] && date -r "$1" "+%-m/%-d %H:%M" 2>/dev/null; } # → M/D HH:MM

3行レイアウト

出力は固定の3行です。

line1: 📁 dir   ⌥ branch
line2: 🤖 model·effort   🧠 ctx%   🕐 5h N% ⏪HH:MM   📅 7d N% ⏪M/D HH:MM
line3: 💴 session ≈¥x   今日 ≈¥y   <health>

パーセンテージには色をつけています。数字を読まなくても、緑・黄・赤で状態がわかります。

# pct -> color (green <50, yellow 50-79, red >=80)
pcolor() { local n="${1%%.*}"; [ -z "$n" ] && { printf '%s' "$DIM"; return; }
  if [ "$n" -ge 80 ] 2>/dev/null; then printf '%s' "$RED"
  elif [ "$n" -ge 50 ] 2>/dev/null; then printf '%s' "$YEL"
  else printf '%s' "$GRN"; fi; }

当日コストは2分キャッシュで取る

SESSION_USD はstdinからリアルタイムで来ます。ただ「今日のトータル」はccusageのdaily集計が必要です。これを毎回呼ぶとstatuslineの描画が詰まるので、2分キャッシュとバックグラウンド更新にしました。

CCUSAGE=$(command -v ccusage 2>/dev/null || echo "$HOME/.nvm/versions/node/v24.13.0/bin/ccusage")
DAY_CACHE="/tmp/cc-daily-cache.json"
NEED=true
if [ -f "$DAY_CACHE" ]; then
  AGE=$(($(date +%s) - $(stat -f %m "$DAY_CACHE" 2>/dev/null || echo 0)))
  [ "$AGE" -lt 120 ] && NEED=false
fi
[ "$NEED" = true ] && ( "$CCUSAGE" daily --json 2>/dev/null > "${DAY_CACHE}.tmp" && mv "${DAY_CACHE}.tmp" "$DAY_CACHE" ) &
DAY_USD=0
if [ -f "$DAY_CACHE" ]; then
  TODAY=$(date "+%Y-%m-%d")
  DAY_USD=$(jq -r --arg d "$TODAY" '(.daily[] | select(.date==$d) | .totalCost) // (.daily[-1].totalCost) // 0' "$DAY_CACHE" 2>/dev/null)
fi

ポイントは & でサブシェルに投げているところです。キャッシュが切れていても、statuslineはその場で古い値を返し、裏でccusageを走らせます。2分前の数字でも、実際に使っていて困った場面はありませんでした。

円換算は、先頭で決めたレートを使ってawkで計算します。

JPY_RATE=150   # Edit to taste / use $ instead.

yen() { awk -v u="$1" -v r="$JPY_RATE" 'BEGIN{
  v=u*r; n=sprintf("%.0f", v); s=""; len=length(n); c=0
  for(i=len;i>=1;i--){ s=substr(n,i,1) s; c++; if(c%3==0 && i>1) s="," s }
  printf "¥%s", s }'; }

¥1,234 のように3桁カンマで出ます。ドル表示が好みなら、yen を呼んでいる箇所を $SESSION_USD に置き換えるだけです。

ヘルス1文字（5分キャッシュ）

3行目の末尾には、🟢/🟡/🔴/⚫の1文字でautomationの死活を出しています。automation-health.sh は起動が重いので、こちらは5分キャッシュにしました。

HEALTH_CACHE="/tmp/cc-health-cache"; HEALTH=""
if [ -f "$HEALTH_CACHE" ]; then
  HAGE=$(($(date +%s) - $(stat -f %m "$HEALTH_CACHE" 2>/dev/null || echo 0)))
  [ "$HAGE" -lt 300 ] && HEALTH=$(cat "$HEALTH_CACHE" 2>/dev/null)
fi
if [ -z "$HEALTH" ]; then
  ( h=$(~/.claude/scripts/automation-health.sh 2>&1 | grep -oE "ALL GREEN|WARN|FAIL" | head -1)
    case "$h" in
      "ALL GREEN") echo "🟢" > "$HEALTH_CACHE" ;;
      "WARN")      echo "🟡" > "$HEALTH_CACHE" ;;
      "FAIL")      echo "🔴" > "$HEALTH_CACHE" ;;
      *)           echo "⚫" > "$HEALTH_CACHE" ;;
    esac ) &
  HEALTH="·"
fi

キャッシュが切れているときは ·（ドット）を返しつつ、裏で更新を始めます。次の描画でキャッシュができていれば絵文字に切り替わります。statuslineの描画は、どんな場合も止めない。2分と5分、2つのキャッシュはどちらもこの1点のために入れています。

走るか止まるかは、別スクリプトで精度を上げる

token-budget-advisor.shで2つの集計を突き合わせる

statuslineは「今どのくらいか」を目で見るためのものです。autopilotが「走るか、止まるか」を決めるには、もっと精度が要ります。そこを受け持つのが token-budget-advisor.sh です。

ccusageの公式ブロック集計を優先しつつ、自前の ~/.claude/logs/cost-log.jsonl の集計も計算して、差分率（source_diff_pct）を出しています。

# ccusage が居れば5hブロックのoutput tokenを取る（transcript計算より公式）
if command -v ccusage >/dev/null 2>&1; then
  CC_JSON=$(ccusage blocks --json 2>/dev/null || true)
  # ... activeブロックを抽出してoutputTokens/costUSDを取り出す
  CC_OUTPUT_TOK="${EXTRACTED%|*}"
  CC_COST_5H="${EXTRACTED#*|}"
fi

判定のしきい値はこう置いています。

THRESH_5H_WARN      = 800_000   # output tokens → warn
THRESH_5H_CRIT      = 1_200_000 # → critical
THRESH_WEEK_WARN    = 3000      # USD / 7d
THRESH_SESS_PER_DAY = 5         # 直近3d平均 > 5 → burst

--short を付けると1行出力になり、autopilotはここを見て先回りで判断します。

# autopilot側のコードより（前作で紹介）
BUDGET=$(~/.claude/scripts/token-budget-advisor.sh --short)
if echo "$BUDGET" | grep -qE '🔴|critical|cap-near'; then
  log "ABORT: budget critical"; exit 0
fi

autopilot記事で「ラベル判定だけで残量マイナスが素通りした」事故を書きました。残量がマイナスなのに止まらなかった、あの一件があったからです。token-budget-advisor.sh はラベルとは別に残量を数値で計算し直し、0以下なら止める二重チェックにしています。

cost-summary.shで期間別に振り返る

~/.claude/scripts/cost-summary.sh           # 7日分（デフォルト）
~/.claude/scripts/cost-summary.sh 30        # 30日分
~/.claude/scripts/cost-summary.sh today     # 今日だけ

per day: はUnicodeの棒グラフで出ます。per model: ではモデル別のメッセージ数も出るので、「Sonnetが多かった日は何をしていたか」を振り返るのに使っています。

実際に踏んだ落とし穴

• rate_limits がセッション開始直後に存在しない。// empty でフォールバックし、最初のターンが返るまでは -- 表示で正常
• ccusage daily がstatuslineを止める。120秒キャッシュと & で非同期にして、古い値でも描画は止めない
• ヘルスチェックが毎回重い。5分キャッシュと & にして、更新中は · を返すだけにした
• stat -f %m はmacOS専用。Linuxなら stat -c %Y に変えてください（スクリプトはmacOS前提です）
• ccusageと自前集計のズレに気づかなかった。source_diff_pct を出して、常に突き合わせるようにした

いちばん遠回りしたのは、rate_limits は来ないものだと思い込んだことです。stdinに見当たらなかったので「これは渡されないんだ」と決めつけ、エンドポイントを叩く方向で考え始めていました。実際は、開始直後に現れないだけでした！ stdinのJSONをファイルに吐いて一度中身を見ていれば、すぐ気づけた話です。なので今は、この1行を最初から入れています。

# デバッグ用。消してもよい
printf '%s' "$INPUT" > /tmp/cc-statusline-last.json 2>/dev/null || true

まとめ

• statuslineスクリプトのstdinに .rate_limits.* / .context_window.used_percentage / .cost.total_cost_usd が来る。認証は不要
• 3行で「ブランチ / 5h・7d・ctx% / セッションと今日のコスト円換算＋ヘルス」を常時表示
• 当日コストは2分キャッシュとバックグラウンド更新で、描画を止めない
• ヘルス1文字は5分キャッシュで軽くする
• token-budget-advisor.sh がccusageの公式値と自前集計を突き合わせ、autopilotの走る・止まるを決める

ダッシュボードは3日で開かなくなりましたが、statuslineは毎日目に入っています。「返答が薄い？」と首をひねる前に、まず画面の下の数字を見る。それだけで迷う時間がなくなりました。

📕 この記事の内容を、実装まで全部まとめた有料記事があります 手順・コード・テンプレをそのまま渡しています AIで「寝てても回る仕組み」をゼロから30日で組む全手順