Claude Code Statusline 顯示 Rate Limits 用量

2026-03-21 | Pan

Claude Code v2.1.80 起，statusline JSON 新增 rate limits 資料。把以下腳本存成 .sh 檔，在 settings.json 的 statusLine 設定中指定即可即時顯示 5 小時 / 7 天用量百分比與重置時間。

#!/bin/sh
# Claude Code status line - displays rate limit usage + 5h reset time
input=$(cat)

five=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
five_reset=$(echo "$input" | jq -r '.rate_limits.five_hour.resets_at // empty')
week=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')

out=""
if [ -n "$five" ]; then
  out="5h: $(printf '%.0f' "$five")%"
  if [ -n "$five_reset" ]; then
    reset_time=$(date -r "$five_reset" +"%H:%M")
    out="$out (reset $reset_time)"
  fi
fi
[ -n "$week" ] && out="$out  7d: $(printf '%.0f' "$week")%"

echo "$out"