Claude Codeのステータスライン設定｜レートリミット・コンテキスト使用率をリアルタイム表示する方法

ステータスラインの基本構成と表示可能な情報。rate_limitsフィールドの仕組みと5h/7dウィンドウの見方。

本記事は「Claude Code実践ガイド｜AI開発の生産性を高める運用設計」シリーズの一部です。

Claude Codeのステータスラインをカスタマイズすれば、レートリミットの使用率やコンテキストウィンドウの消費量をリアルタイムで確認できます。 v2.1.80で追加されたrate_limitsフィールドにより、5時間/7日間のウィンドウ使用率が可視化され、API制限に達する前に作業ペースを調整できるようになりました。

この記事でわかること

Claude Codeのステータスラインをカスタマイズして、レートリミットの残量やコンテキスト使用率をリアルタイムで把握する方法を解説します。API制限に達する前に作業ペースを調整できる環境を構築できます。

• ステータスラインの基本構成と表示可能な情報 — ステータスラインは、ClaudeCodeのプロンプト行の下部に表示される情報バーです。
• rate_limitsフィールドの仕組みと5h/7dウィンドウの見方 — v2.1.80で追加されたフィールドは、APIの使用量を2つのウィンドウで表示します。
• settings.jsonでのカスタマイズ方法とPythonスクリプトによる拡張 — ステータスラインの情報をさらに活用するため、Pythonスクリプトで独自の表示パターンを構築できます。

対象読者: Claude Codeのレートリミット管理に課題を感じているエンジニア、作業環境の情報表示を最適化したい方

ステータスラインとは

ステータスラインは、Claude Codeのプロンプト行の下部に表示される情報バーです。モデル名、コンテキスト使用量、レートリミット状況などの運用情報をリアルタイムに表示します。

デフォルト表示

claude-sonnet-4-20250514 | Context: 45% | Rate: 23% (5h) / 8% (7d)

rate_limitsフィールドの仕組み

v2.1.80で追加されたrate_limitsフィールドは、APIの使用量を2つのウィンドウで表示します。

色による視覚的アラート

使用率に応じてステータスラインの色が変化します。

レートリミットの可視化は「見えないコスト」を「見えるコスト」に変える第一歩です。5hウィンドウで短期的な使いすぎを検知し、7dウィンドウで週単位の消費ペースを把握することで、API制限に達する前に作業ペースを調整できます。

この色変化により、ターミナルを見るだけで現在の使用状況が一目でわかります。

settings.jsonでの設定

基本設定

// ~/.claude/settings.json
{
  "statusLine": {
    "enabled": true,
    "showModel": true,
    "showContext": true,
    "showRateLimits": true
  }
}

表示項目のカスタマイズ

Pythonスクリプトによる拡張表示

ステータスラインの情報をさらに活用するため、Pythonスクリプトで独自の表示パターンを構築できます。以下に5つの実用パターンを紹介します。

パターン1: 使用率のログ記録

#!/usr/bin/env python3
"""Claude Codeのレートリミット使用率をCSVに記録するスクリプト"""
import json
import csv
from datetime import datetime
from pathlib import Path

LOG_FILE = Path.home() / ".claude" / "rate_limit_log.csv"

def log_rate_limit(usage_5h: float, usage_7d: float):
    """使用率をCSVファイルに追記"""
    with open(LOG_FILE, "a", newline="") as f:
        writer = csv.writer(f)
        writer.writerow([
            datetime.now().isoformat(),
            f"{usage_5h:.1f}",
            f"{usage_7d:.1f}"
        ])

# 使用例: log_rate_limit(45.2, 12.8)

パターン2: Slack通知連携

#!/usr/bin/env python3
"""使用率が閾値を超えたらSlackに通知"""
import requests

SLACK_WEBHOOK = "https://hooks.slack.com/services/xxx/yyy/zzz"
THRESHOLD = 80.0

def notify_if_high(usage_5h: float):
    if usage_5h >= THRESHOLD:
        requests.post(SLACK_WEBHOOK, json={
            "text": f"Claude Code レートリミット警告: 5h使用率 {usage_5h}%"
        })

パターン3: ターミナルプロンプトへの埋め込み

# .bashrcまたは.zshrcに追加
export PS1='$(claude-rate-check)$ '

パターン4: 時間帯別の使用傾向分析

#!/usr/bin/env python3
"""時間帯別の使用傾向をレポート"""
import csv
from collections import defaultdict
from pathlib import Path

def analyze_usage():
    hourly = defaultdict(list)
    log_file = Path.home() / ".claude" / "rate_limit_log.csv"

    with open(log_file) as f:
        for row in csv.reader(f):
            hour = row[0].split("T")[1][:2]
            hourly[hour].append(float(row[1]))

    for hour in sorted(hourly):
        avg = sum(hourly[hour]) / len(hourly[hour])
        print(f"{hour}時台: 平均 {avg:.1f}%")

パターン5: コンテキスト使用量のアラート

#!/usr/bin/env python3
"""コンテキスト使用率が高くなったら/compactを推奨"""

CONTEXT_THRESHOLD = 70.0

def check_context(usage_pct: float):
    if usage_pct >= CONTEXT_THRESHOLD:
        print(f"コンテキスト使用率 {usage_pct}%: /compact コマンドの実行を推奨します")

コンテキスト管理と組み合わせることで、長時間セッションでの効率的な運用が可能になります。

コスト最適化との連携

ステータスラインの情報は、コスト最適化の観点でも重要です。レートリミット使用率を常に把握しておくことで、以下の判断が可能になります。

• 使用率が低い時間帯: 大量のバッチ処理やコード生成を集中実行
• 使用率が高い時間帯: モデル/Effort選択で軽量モデルに切り替え
• 7d使用率が高い週: planモードで読み取り中心の作業にシフト

ビジネス活用の視点

レートリミットの可視化は、AI活用のコスト管理に直結します。「見えないコスト」を「見えるコスト」に変えることで、経営判断のための情報が揃います。CRMの世界では「可視化こそが改善の第一歩」ですが、AI運用でもまったく同じ原則が当てはまります。

少数精鋭のチームでは、限られたAPI枠を効率的に使い切ることが重要です。ステータスラインの活用により、チームメンバー間でのAPI使用量の偏りを検知し、適切に配分する運用が可能になります。AI活用の詳細は、経営データBI支援やコンテンツマーケティング支援のページもご覧ください。

あわせて読みたい

• Claude Codeのサンドボックス設定｜ファイルシステム・ネットワークの安全な制限方法
• Claude Codeの見た目カスタマイズ｜テーマ・カラー・ステータスラインの設定方法
• Claude Code × Chatwork連携｜顧客コミュニケーションを自動化する方法

まとめ

本記事ではClaude Codeのステータスライン設定について、レートリミットとコンテキスト使用率のリアルタイム表示方法を解説しました。

• ステータスラインはモデル名・コンテキスト使用量・レートリミット状況をリアルタイムに表示する情報バーで、v2.1.80で追加されたrate_limitsフィールドにより5h/7dの使用率が可視化されます
• 使用率に応じて緑（0〜50%）・黄（50〜80%）・赤（80〜100%）の色変化で視覚的にアラートが表示され、作業ペースの調整判断が直感的に行えます
• settings.jsonで表示項目をカスタマイズし、Pythonスクリプトでログ記録・Slack通知・時間帯別分析などの拡張が可能です
• コスト最適化の観点では、使用率が低い時間帯に大量処理を集中し、高い時間帯には軽量モデルへの切り替えやplanモードへのシフトが有効です

Claude Codeの全コマンド一覧はClaude Codeチートシートをご覧ください。AI活用の全体像はAI活用完全ガイドで解説しています。

よくある質問（FAQ）

Q1. ステータスラインのレートリミット表示が赤になったらどうすればよいですか？

使用率が80%を超えて赤表示になった場合は、大量のコード生成やバッチ処理を一時停止し、スライディングウィンドウのリセットを待つのが基本です。作業を完全に止める必要はなく、planモードに切り替えてコード分析や調査に集中する、軽量モデル（Haiku等）に切り替えるといった対応で効率的に時間を使えます。

Q2. ステータスラインの5hウィンドウと7dウィンドウはどう違いますか？

5h（5時間）ウィンドウは直近5時間のAPI呼び出し量を表示し、短期的な使いすぎを検知するための指標です。7d（7日間）ウィンドウは直近7日間の累積使用量で、週単位の消費ペースを把握できます。どちらもスライディングウィンドウ方式で常時更新されるため、時間が経過すれば古い使用量は自然に減少します。

Q3. チームメンバー間でAPI使用量の偏りを管理する方法はありますか？

Pythonスクリプトで各メンバーのレートリミット使用率をCSVに記録し、時間帯別の使用傾向を分析することで偏りを可視化できます。さらにSlack通知連携を設定すれば、特定メンバーの使用率が閾値を超えた際にチームに自動通知されます。これらのスクリプトとステータスラインの情報を組み合わせることで、限られたAPI枠をチーム全体で効率的に配分できます。

Q4. ステータスラインの表示をカスタムフォーマットに変更できますか？

settings.jsonのstatusLine設定で表示項目のON/OFFは制御できますが、表示フォーマット自体のカスタマイズはClaude Code本体の機能としては提供されていません。独自のフォーマットが必要な場合は、Pythonスクリプトでrate_limitsの値を取得し、ターミナルプロンプト（PS1）に埋め込む方法で対応できます。

Q5. レートリミットに達した場合、作業データは失われますか？

レートリミットに達してもClaude Codeのセッションは維持され、それまでの作業データ（編集中のファイル、コンテキスト）は失われません。新しいAPIリクエストが一時的にブロックされるだけなので、スライディングウィンドウのリセットを待てば作業を再開できます。緊急時はplanモードに切り替えて読み取り専用の調査作業を続ける方法も有効です。