制限に達するまで気づけない——Claude Codeを毎日使う人なら、一度は経験があるはずです。
この記事では、ターミナル下部に5時間枠と週間枠を常時表示するオープンソースツール「ccstatusline」の導入方法と、表示項目の読み方を解説します。
この記事でわかること
- Claude Codeの利用制限が見えにくい理由
- ccstatuslineの仕組みとセットアップ手順
- ステータスバー各項目の意味と運用のコツ
Claude Codeの利用制限は、確認しないと見えない
AnthropicのClaude Codeは、Claude.aiのPro・Maxプラン向けに5時間のローリング枠と7日間の週間枠の2層で利用量を管理しています。5時間枠は最初のプロンプト送信時からカウントが始まり、枠内の使用量を使い切ると次のリセットまで待つ必要があります。週間枠はより長い周期で上限が設けられており、こちらに達すると数日待つケースもあります。5時間枠の消費は週間枠にも加算されるため、短時間に集中して使うと両方の残量が同時に減っていきます。
2026年5月、AnthropicはPro・Max・Team・Enterprise向けに5時間枠の上限を2倍に引き上げ、ピーク時間帯の制限縮小も廃止しました。上限は緩和された一方で、「あとどれだけ使えるか」は依然としてユーザー側で確認する必要があります。
Claude Codeで残量を調べる標準手段は、ターミナル内で/usageコマンドを実行する方法です。claude.aiでは設定画面のUsageセクションを開く必要があり、いずれも作業の途中で別操作が発生します。制限に近づいても画面上に常時表示されるわけではなく、上限到達時に「しばらくお待ちください」系のメッセージで初めて気づく——という流れが起きやすい構造です。
ccstatuslineが解決する課題
ccstatuslineは、Matthew Breedlove氏が開発・公開しているMITライセンスのステータスライン整形ツールです。Claude Codeが標準で備えるstatusLine機能に接続し、Anthropic公式ドキュメントが定義するセッションJSON（モデル名、トークン数、rate_limitsなど）を読み取って、色付きのプログレスバーとリセット時刻として表示します。
Claude CodeのstatusLineは、設定ファイルで任意のコマンドを指定すると、表示更新のたびにJSONを標準入力へ渡し、コマンドの標準出力をターミナル下部に描画する仕組みです。公式ドキュメントではrate_limits.five_hour.used_percentage（5時間枠の使用率0〜100）とrate_limits.seven_day.used_percentage（週間枠の使用率）、各resets_at（リセット時刻のUnixエポック秒）が利用可能と明記されています。ccstatuslineはこの公式データを整形するだけで、外部サービスへ認証情報を送る設計ではありません。
コミュニティでも同種のニーズは高く、AnthropicのClaude Codeリポジトリにはステータスラインへの制限表示を組み込む機能要望が複数立ち上がっています。ccstatuslineはnpmパッケージとして配布され、Awesome Claude Codeにも掲載されている実績のある選択肢です。
導入手順
セットアップは対話型のTUI（ターミナルUI）が案内します。ターミナルで次を実行してください。
npx -y ccstatusline@latest
Bunを使う場合はbunx -y ccstatusline@latestでも同じTUIが起動します。初回フローでは表示するウィジェットの選択、色の調整、Claude Codeのsettings.jsonへの書き込みまで一連で進められます。グローバルにバージョンを固定したい場合は、TUI内の「Pinned global install」を選ぶと、以降はccstatuslineコマンドだけで設定画面を開けます。
TUIからインストールすると、~/.claude/settings.jsonに次のような設定が追加されます。
{
"statusLine": {
"type": "command",
"command": "npx -y ccstatusline@latest",
"padding": 0,
"refreshInterval": 10
}
}
refreshIntervalはClaude Code 2.1.97以降で有効なオプションで、プロンプト送信の合間も10秒ごとに表示を更新します。設定は~/.config/ccstatusline/settings.jsonに別途保存されるため、ウィジェット構成を変えたいときは再度TUIを起動すれば足ります。Claude Codeの設定ディレクトリを変えている環境では、環境変数CLAUDE_CONFIG_DIRを指定してください。
ステータスバーの見方
導入後、ターミナル最下部に次のような情報が並びます。表示項目はTUIで取捨選択できますが、制限管理で押さえたいのは次のとおりです。
Session（5時間枠） — 現在の5時間ローリング枠の使用率です。バーの色が進むほど残量が少なくなっています。
Weekly（週間枠） — 7日間の上限に対する使用率です。短期集中のセッションが積み重なると、こちらが先に逼迫することがあります。
Reset — 現在の5時間枠がリセットされるまでのカウントダウンです。作業を続けるか、モデルを切り替えるかの判断材料になります。
Model — 稼働中のモデル名です。OpusとSonnetでは消費速度が異なるため、残量と合わせて確認すると計画的に使えます。
Context — コンテキストウィンドウの埋まり具合です。利用制限とは別枠ですが、会話が長くなると過去の内容を参照しにくくなるため、同じ画面で見られるのは実用的です。
v2.2系では、Sonnet・Opus別の週間使用量ウィジェット、Extra Usage（従量課金の超過枠）表示、コンパクション回数なども追加されています。必要な項目だけを並べ替えれば、情報過多を避けられます。
類似ツールとの違い
Claude Code向けのステータスライン拡張は複数存在します。Bashとjqベースのスクリプトを自分で書く方法、ccusage、claude-powerlineなどが代表的です。ccstatuslineの強みは、コードを書かずにTUIだけでウィジェット・配色・Powerline表示を組み立てられる点です。npm経由でnpx一発から始められるため、シェルスクリプトに慣れていない人でも導入のハードルが低い構成になっています。
一方、最小構成のシェルスクリプトの方が依存パッケージが少ない、という好みの人もいます。いずれにせよ、表示の元データはClaude Codeが渡す公式JSONに共通しており、ツール選びは「どれだけ手間をかけずにカスタマイズしたいか」で決めれば十分です。
運用するときの注意点
rate_limitsは、Claude.aiのPro・Max契約者がセッション内で最初のAPI応答を受け取った後にJSONへ含まれる仕様です。起動直後は表示が空のことがありますが、1回プロンプトを送れば値が入ります。APIキー単体のClaude Code利用では、このオブジェクト自体が現れない点にも留意してください。
ccstatuslineはオープンソースのため、フォークやウィジェット追加のPRも歓迎されています。制限強化が話題になるたびに「残量の見える化」の需要は高まっており、作業の途中で/usageを叩く手間を減らしたい人にとって、導入コストに見合う実用性があるツールです。