メインコンテンツへスキップ

【保存版】Claude Codeステータスライン活用術!プラン名や使用率(%)なども常に表示で開発効率UP

    実際に導入し、表示している画像がこちら

    画像

    はじめに - 導入のきっかけ

    こんにちは。バックエンドエンジニアのy__uです。

    以前からclaude codeでの使用量の監視には「claude-monitor」を利用していました。

    しかし、起動していても別タブへ確認しに行くのが正直、面倒でした!笑

    そんな時、2025年8月8日、Claude Code(v1.0.71)にステータスライン機能が追加され、ccusageツールで使用量を表示できるようになりました!

    ryoppippi氏の下記投稿を参考に、今回の設定をさせていただきました。

    we added new #ccusage subcommand for Claude Code /statusline support

    try to add
    ```
    {
    "statusLine": {
    "type": "command",
    "command": "bun x ccusage statusline",
    }
    }
    ```
    in your .claude/settings.json https://t.co/kD0VOZPqlc pic.twitter.com/NENfyeBm3T

    — ryoppippi (@ryoppippi) August 9, 2025

    本記事では、標準表示に加えて契約プラン別の残量表示や警告機能など、実運用に効く拡張の作り方を紹介します。


    この記事で学べること

    1. Claude Codeステータスラインの本質的な価値 - なぜ生産性が上がるのか

    2. 設定前後の作業効率の決定的な違い - 実測データで証明

    3. 設定時の落とし穴と解決策 - 私が実際にハマったポイント

    4. 実践的な設定例(コピペOK) - そのまま使える完全版

    5. 生産性改善の実測値 - 具体的な数値で効果を実感


    Claude Codeステータスラインの2つの機能

    1. トークン使用量のリアルタイム表示 - 常に使用状況を把握

    Before (設定前)

    # トークン使用量確認のたびにコマンド実行
    $ ccusage
    Usage: 12,450 tokens / 35,000 (35%)
    # また作業に戻る...数分後また気になって...
    $ ccusage
    Usage: 13,820 tokens / 35,000 (39%)

    After (設定後)

    # ターミナル下部に常時表示
    🤖 Sonnet 4 [MAX5] | 💰 $15.80/$35 (45%) | 📊 13.3k/88k (15%) | ⏰ 1:00AM (4h 7m) [ID:30d9] | Dir: index | Branch: main

    感想: 「え、こんなに楽になるの?」最初に設定できた時、本当に感度しました!(今でも喜んでいます!笑)
    一度使うと元には戻れません。作業の流れが止まらないって、こんなに生産的だったんだと実感しました。

    2. プラン別上限管理 - Pro/Max5/Max20を一目で判別

    # Proプラン: 月額固定
    🤖 Sonnet 4 [PRO] | 💰 $18.00/∞ | 📊 45.2k/∞ | ⏰ 2:30PM | Dir: index | Branch: main
    
    # Max 5xプラン: 5倍レート(私はこれを使用中)
    🤖 Sonnet 4 [MAX5] | 💰 $6.42/$35 (18%) | 📊 13.4k/88k (15%) | ⏰ 3:00PM | Dir: index | Branch: main
    
    # Max 20xプラン: 20倍レート
    🤖 Opus 4.1 [MAX20] | 💰 $42.15/$140 (30%) | 📊 105k/350k (30%) | ⏰ 4:00PM | Dir: index | Branch: main

    警告機能も搭載。

    • 80%未満: 通常表示(✅)

    • 80-94%: 警告表示(⚠️ そろそろ上限です)

    • 95%以上: 危険表示(🔴 まもなく上限!)

    他に、以下のように各項目をステータスに表示しています!

    画像

    つまずいたポイントと解決策

    落とし穴1: Hooksを使用しているプロジェクトでの注意点

    ステータスライン自体はグローバル設定で動作しますが、プロジェクトで独自のhooks(例:textlintのPostToolUse)を使用している場合は要注意です。

    // ✅ 基本設定: グローバル設定のみでOK
    // ~/.claude/settings.json
    {
      "statusLine": {
        "type": "command",
        "command": "bash ~/.claude/scripts/custom-statusline.sh"
      }
    }
    
    // ⚠️ プロジェクトで独自hooksを使用している場合
    // /path/to/project/.claude/settings.local.json
    {
      "hooks": {
        "SessionStart": [{
          "matcher": "(.*)",
          "hooks": [{
            "type": "command",
            "command": "bash ~/.claude/scripts/session-start-handler.sh"
          }]
        }],
        "PostToolUse": [...] // 他のhooks設定
      }
    }

    Claude Codeの仕様: ローカルにhooks設定があると、グローバルのhooks設定を完全に無視するため、SessionStartフックもローカルに再定義が必要。

    落とし穴2: Claude Code再起動を忘れる

    # 📍 私の失敗例
    # 設定を変更して「よし、完璧!」と思ったら...
    echo '設定を変更したので、すぐに効果が出るはず...'
    # → なぜか古い設定で動作し続ける...なぜ??
    
    # 正解: 設定変更後はClaude Codeを再起動
    exit  # Claude Codeを終了
    claude  # Claude Codeを再起動
    # → やっと新しい設定で動作開始!

    教訓: 設定変更後は再起動が必須。これを知らず、20分無駄にしました。


    実践ステータスライン設定を一から設定する

    設定完了後のファイル構成

    この記事の手順を完了すると、以下のファイルが作成されます。

    ~/.claude/
    ├── settings.json                     # グローバル設定(statusLine設定はここ)
    ├── scripts/
    │   ├── custom-statusline.sh         # ステータスライン表示スクリプト
    │   ├── setup-statusline.sh          # プラン選択スクリプト
    │   └── session-start-handler.sh     # セッション開始時処理
    ├── config/
    │   └── statusline-config.json       # プラン設定ファイル
    └── runtime/
        └── sessions/
            ├── session-<PID>             # プロセス別セッションID(自動生成)
            └── current                   # 最新セッションID(自動生成)
    
    /path/to/your/project/
    └── .claude/
        └── settings.local.json           # ⚠️ 条件付きで必要
                                         # (textlint等の独自hooksを使用する場合)

    重要: プロジェクトのsettings.local.jsonは、独自のhooks(textlint等)を使用する場合のみ必要です。

    Step 1: ccusageのインストール

    # まずccusageをグローバルインストール
    npm install -g ccusage
    
    # 動作確認
    ccusage --help

    Step 2: スクリプトファイルの作成

    2-1. セットアップスクリプトの作成

    # 必要なディレクトリを作成
    mkdir -p ~/.claude/scripts
    mkdir -p ~/.claude/config
    
    # セットアップスクリプトの作成
    cat > ~/.claude/scripts/setup-statusline.sh << 'SETUP_EOF'
    
    #!/bin/bash
    # Claude Code ステータスライン セットアップスクリプト
    # プランの選択と変更を簡単に行うためのインタラクティブツール
    
    CONFIG_FILE="$HOME/.claude/config/statusline-config.json"
    
    # カラー定義
    RED='\033[0;31m'
    GREEN='\033[0;32m'
    YELLOW='\033[1;33m'
    BLUE='\033[0;34m'
    NC='\033[0m' # No Color
    
    # 現在の設定を確認
    CURRENT_PLAN=""
    if [ -f "$CONFIG_FILE" ]; then
        CURRENT_PLAN=$(jq -r '.plan // ""' "$CONFIG_FILE" 2>/dev/null)
    fi
    
    clear
    echo "================================================"
    echo "    Claude Code ステータスライン設定"
    echo "================================================"
    echo ""
    
    # 現在の設定を表示
    if [ -n "$CURRENT_PLAN" ] && [ "$CURRENT_PLAN" != "null" ]; then
        echo -e "${BLUE}現在の設定:${NC} $(echo $CURRENT_PLAN | tr '[:lower:]' '[:upper:]')"
        echo ""
        echo "プランを変更しますか?"
    else
        echo -e "${YELLOW}まだプランが選択されていません。${NC}"
    fi
    
    echo ""
    echo "あなたのClaude Codeプランを選択してください:"
    echo ""
    echo "  1) Pro    (19,000 tokens / \$18)"
    echo "  2) Max5   (88,000 tokens / \$35)"
    echo "  3) Max20  (220,000 tokens / \$140)"
    echo ""
    echo "  0) キャンセル"
    echo ""
    read -p "番号を入力 (0-3): " choice
    
    case $choice in
        1)
            PLAN="pro"
            TOKEN_LIMIT=19000
            COST_LIMIT=18
            PLAN_NAME="Pro"
            ;;
        2)
            PLAN="max5"
            TOKEN_LIMIT=88000
            COST_LIMIT=35
            PLAN_NAME="Max5"
            ;;
        3)
            PLAN="max20"
            TOKEN_LIMIT=220000
            COST_LIMIT=140
            PLAN_NAME="Max20"
            ;;
        0)
            echo ""
            echo "キャンセルしました。"
            exit 0
            ;;
        *)
            echo ""
            echo -e "${RED}❌ 無効な選択です${NC}"
            exit 1
            ;;
    esac
    
    # 設定をJSONファイルに保存
    cat > "$CONFIG_FILE" << EOF
    {
      "plan": "$PLAN",
      "token_limit": $TOKEN_LIMIT,
      "cost_limit": $COST_LIMIT,
      "updated_at": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
    }
    EOF
    
    # 成功メッセージ
    echo ""
    echo -e "${GREEN}✅ ${PLAN_NAME}プランを選択しました${NC}"
    echo ""
    echo "設定を保存しました: $CONFIG_FILE"
    echo ""
    echo "------------------------------------------------"
    echo "次のステップ:"
    echo ""
    echo "1. Claude Codeが既に起動している場合:"
    echo "   設定は次回のメッセージ送信時に自動的に反映されます。"
    echo ""
    echo "2. プランを変更する場合:"
    echo "   このスクリプトを再実行してください:"
    echo -e "   ${BLUE}~/.claude/setup-statusline.sh${NC}"
    echo ""
    echo "3. エイリアスの設定(オプション):"
    echo "   以下をシェル設定ファイルに追加すると便利です:"
    echo -e "   ${BLUE}alias claude-plan='~/.claude/setup-statusline.sh'${NC}"
    echo "   その後、'claude-plan'と入力するだけで設定できます。"
    echo "------------------------------------------------"
    
    # 実際のファイル: ~/.claude/scripts/setup-statusline.sh
    SETUP_EOF
    
    # 実行権限を付与
    chmod +x ~/.claude/scripts/setup-statusline.sh

    2-2. メインスクリプトの作成

    cat > ~/.claude/scripts/custom-statusline.sh << 'EOF'
    
    #\!/bin/bash
    # Claude Code カスタムステータスライン表示スクリプト
    # プラン情報に基づいてトークン使用量とコストを表示
    
    CONFIG_FILE="$HOME/.claude/config/statusline-config.json"
    
    # 設定ファイルの読み込み
    if [ -f "$CONFIG_FILE" ]; then
        PLAN=$(jq -r '.plan // ""' "$CONFIG_FILE" 2>/dev/null)
        TOKEN_LIMIT=$(jq -r '.token_limit // 0' "$CONFIG_FILE" 2>/dev/null)
        COST_LIMIT=$(jq -r '.cost_limit // 0' "$CONFIG_FILE" 2>/dev/null)
    fi
    
    # プラン未選択の場合
    if [ -z "$PLAN" ] || [ "$PLAN" = "null" ] || [ "$PLAN" = "" ]; then
        echo "🤖 [プラン未選択] | ⚠️ ターミナルで ~/.claude/setup-statusline.sh を実行"
        exit 0
    fi
    
    # 現在の使用量を取得
    CURRENT=$(ccusage blocks --active --json 2>/dev/null)
    if [ -z "$CURRENT" ] || [ "$CURRENT" = "null" ]; then
        echo "🤖 Claude | ⚠️ No active session"
        exit 0
    fi
    
    # アクティブなブロックがあるか確認
    IS_ACTIVE=$(echo "$CURRENT" | jq -r '.blocks[0].isActive // false')
    if [ "$IS_ACTIVE" \!= "true" ]; then
        echo "🤖 Claude | ⚠️ No active block"
        exit 0
    fi
    
    # モデル名を取得と整形
    # settings.jsonから現在設定されているモデルを取得
    SETTINGS_MODEL=$(jq -r '.model // ""' ~/.claude/settings.json 2>/dev/null)
    
    if [ -n "$SETTINGS_MODEL" ] && [ "$SETTINGS_MODEL" != "null" ]; then
        # settings.jsonのモデル名をフルネームに変換
        case "$SETTINGS_MODEL" in
            "opus")
                MODEL_RAW="claude-opus-4-1-20250805"
                ;;
            "sonnet")
                MODEL_RAW="claude-sonnet-4-20250514"
                ;;
            "haiku")
                MODEL_RAW="claude-haiku-3-20250514"
                ;;
            *)
                # その他の場合はccusageから取得
                MODEL_RAW=$(echo "$CURRENT" | jq -r '.blocks[0].models[-1] // "claude"')
                ;;
        esac
    else
        # settings.jsonが読めない場合は、ccusageの最後に使用されたモデルを取得
        MODEL_RAW=$(echo "$CURRENT" | jq -r '.blocks[0].models[-1] // "claude"')
    fi
    
    # claude-opus-4-1-20250805 -> Opus 4.1
    # claude-sonnet-4-20250805 -> Sonnet 4
    # claude-sonnet-3-5-20241022 -> Sonnet 3.5
    MODEL=$(echo "$MODEL_RAW" | \
        sed 's/^claude-//' | \
        sed 's/-[0-9]\{8\}$//' | \
        sed 's/-\([0-9]\)-\([0-9]\)/ \1.\2/' | \
        sed 's/-\([0-9]\)$/ \1/' | \
        awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) substr($i,2)} 1')
    
    # トークン計算(input + outputのみがカウント対象)
    INPUT_TOKENS=$(echo "$CURRENT" | jq -r '.blocks[0].tokenCounts.inputTokens // 0')
    OUTPUT_TOKENS=$(echo "$CURRENT" | jq -r '.blocks[0].tokenCounts.outputTokens // 0')
    TOKENS=$((INPUT_TOKENS + OUTPUT_TOKENS))
    
    # コスト取得
    COST=$(echo "$CURRENT" | jq -r '.blocks[0].costUSD // 0' | xargs printf "%.2f")
    
    # リセット時刻の計算
    END_TIME=$(echo "$CURRENT" | jq -r '.blocks[0].endTime // ""')
    if [ -n "$END_TIME" ] && [ "$END_TIME" \!= "null" ]; then
        # UTCからローカル時刻に変換(macOS用)
        # ISO8601形式の日時を処理
        END_TIME_CLEAN="${END_TIME%%.*}"  # ミリ秒を削除
        END_TIME_CLEAN="${END_TIME_CLEAN%%Z}"  # Zを削除
    
        # UTCをエポック秒に変換してからローカル時刻に変換
        END_EPOCH=$(date -j -u -f "%Y-%m-%dT%H:%M:%S" "$END_TIME_CLEAN" +%s 2>/dev/null)
        if [ -n "$END_EPOCH" ]; then
            # エポック秒からローカル時刻に変換
            RESET_TIME=$(LC_TIME=C date -r $END_EPOCH "+%-I:%M%p" 2>/dev/null)
    
            # 残り時間の計算
            CURRENT_EPOCH=$(date +%s)
            REMAINING_SECONDS=$((END_EPOCH - CURRENT_EPOCH))
            if [ $REMAINING_SECONDS -gt 0 ]; then
                REMAINING_HOURS=$((REMAINING_SECONDS / 3600))
                REMAINING_MINUTES=$(((REMAINING_SECONDS % 3600) / 60))
                REMAINING_TIME="${REMAINING_HOURS}h ${REMAINING_MINUTES}m"
            else
                REMAINING_TIME="0m"
            fi
        else
            RESET_TIME="--"
            REMAINING_TIME="--"
        fi
    else
        RESET_TIME="--"
        REMAINING_TIME="--"
    fi
    
    # パーセント計算
    if [ "$TOKEN_LIMIT" -gt 0 ]; then
        TOKEN_PCT=$(awk "BEGIN {printf \"%.0f\", ($TOKENS/$TOKEN_LIMIT)*100}")
        # トークン表示をk単位に変換
        if [ $TOKENS -ge 1000 ]; then
            TOKEN_DISPLAY=$(awk "BEGIN {printf \"%.1fk\", $TOKENS/1000}")
        else
            TOKEN_DISPLAY="$TOKENS"
        fi
        if [ $TOKEN_LIMIT -ge 1000 ]; then
            LIMIT_DISPLAY=$(awk "BEGIN {printf \"%.0fk\", $TOKEN_LIMIT/1000}")
        else
            LIMIT_DISPLAY="$TOKEN_LIMIT"
        fi
    else
        TOKEN_PCT="--"
        TOKEN_DISPLAY="$TOKENS"
        LIMIT_DISPLAY="--"
    fi
    
    if [ "$COST_LIMIT" \!= "0" ] && [ "$COST_LIMIT" \!= "" ]; then
        COST_PCT=$(awk "BEGIN {printf \"%.0f\", ($COST/$COST_LIMIT)*100}")
    else
        COST_PCT="--"
    fi
    
    # プラン名を大文字に変換
    PLAN_DISPLAY=$(echo "$PLAN" | tr '[:lower:]' '[:upper:]')
    
    # 警告レベルの判定(80%以上で警告、95%以上で危険)
    WARNING=""
    if [ "$TOKEN_PCT" \!= "--" ] && [ "$TOKEN_PCT" -ge 95 ]; then
        WARNING="🔴"
    elif [ "$TOKEN_PCT" \!= "--" ] && [ "$TOKEN_PCT" -ge 80 ]; then
        WARNING="⚠️"
    fi
    
    # セッションIDの取得
    SESSION_ID=""
    SESSION_DIR="$HOME/.claude/runtime/sessions"
    
    # プロセスツリーを遡ってclaudeのPIDを特定
    CURRENT_PID=$$
    CLAUDE_PID=""
    for i in {1..10}; do
        # 親プロセスのコマンド名を確認
        PARENT_CMD=$(ps -p $CURRENT_PID -o comm= 2>/dev/null)
    
        # claudeプロセスが見つかった場合
        if [[ "$PARENT_CMD" == *"claude"* ]]; then
            CLAUDE_PID=$CURRENT_PID
            break
        fi
    
        # 次の親プロセスへ
        CURRENT_PID=$(ps -o ppid= -p $CURRENT_PID 2>/dev/null | tr -d ' ')
        if [ -z "$CURRENT_PID" ] || [ "$CURRENT_PID" = "1" ]; then
            break
        fi
    done
    
    # claudeのPIDが特定できた場合、そのセッションファイルを読む
    if [ -n "$CLAUDE_PID" ] && [ -f "$SESSION_DIR/session-$CLAUDE_PID" ]; then
        SESSION_ID=$(cat "$SESSION_DIR/session-$CLAUDE_PID" 2>/dev/null)
    # フォールバック: currentファイル(後方互換性)
    elif [ -f "$SESSION_DIR/current" ]; then
        SESSION_ID=$(cat "$SESSION_DIR/current" 2>/dev/null)
    fi
    
    # それでも取得できない場合
    if [ -z "$SESSION_ID" ] || [ "$SESSION_ID" = "" ]; then
        SESSION_ID="----"
    fi
    
    # 現在のフォルダ名を取得
    CURRENT_FOLDER=$(basename "$PWD")
    
    # Gitブランチ名を取得(エラーは無視)
    GIT_BRANCH=$(git branch --show-current 2>/dev/null)
    
    # セッションID表示部分の生成(時刻直後用)
    SESSION_DISPLAY_NEW=""
    if [ -n "$SESSION_ID" ] && [ "$SESSION_ID" != "" ]; then
        SESSION_DISPLAY_NEW=" [ID:$SESSION_ID]"
    fi
    
    # フォルダ・ブランチ表示部分の生成
    FOLDER_DISPLAY=" | Dir: $CURRENT_FOLDER"
    BRANCH_DISPLAY=""
    if [ -n "$GIT_BRANCH" ]; then
        BRANCH_DISPLAY=" | Branch: $GIT_BRANCH"
    fi
    
    # 表示(1行に収める)
    if [ -n "$WARNING" ]; then
        echo "🤖 $MODEL [$PLAN_DISPLAY] $WARNING | 💰 \$$COST/\$$COST_LIMIT (${COST_PCT}%) | 📊 ${TOKEN_DISPLAY}/${LIMIT_DISPLAY} (${TOKEN_PCT}%) | ⏰ ${RESET_TIME} (${REMAINING_TIME})${SESSION_DISPLAY_NEW}${FOLDER_DISPLAY}${BRANCH_DISPLAY}"
    else
        echo "🤖 $MODEL [$PLAN_DISPLAY] | 💰 \$$COST/\$$COST_LIMIT (${COST_PCT}%) | 📊 ${TOKEN_DISPLAY}/${LIMIT_DISPLAY} (${TOKEN_PCT}%) | ⏰ ${RESET_TIME} (${REMAINING_TIME})${SESSION_DISPLAY_NEW}${FOLDER_DISPLAY}${BRANCH_DISPLAY}"
    fi
    # END_OF_SCRIPT
    
    # 実際のファイル: ~/.claude/scripts/custom-statusline.sh
    # プラン情報に基づいてトークン使用量とコストを表示
    
    CONFIG_FILE="$HOME/.claude/config/statusline-config.json"
    
    # 依存関係チェック
    if ! command -v jq >/dev/null 2>&1; then
        echo "🤖 Claude | ⚠️ jq command not found"
        exit 0
    fi
    
    if ! command -v ccusage >/dev/null 2>&1; then
        echo "🤖 Claude | ⚠️ ccusage command not found - run: npm install -g ccusage"
        exit 0
    fi
    
    # 設定ファイルの読み込み(破損チェック付き)
    if [ -f "$CONFIG_FILE" ]; then
        if ! jq '.' "$CONFIG_FILE" >/dev/null 2>&1; then
            echo "🤖 Claude | ⚠️ Config file corrupted - run: ~/.claude/scripts/setup-statusline.sh"
            exit 0
        fi
    
        PLAN=$(jq -r '.plan // ""' "$CONFIG_FILE" 2>/dev/null)
        TOKEN_LIMIT=$(jq -r '.token_limit // 0' "$CONFIG_FILE" 2>/dev/null)
        COST_LIMIT=$(jq -r '.cost_limit // 0' "$CONFIG_FILE" 2>/dev/null)
    fi
    
    # プラン未選択の場合
    if [ -z "$PLAN" ] || [ "$PLAN" = "null" ] || [ "$PLAN" = "" ]; then
        echo "🤖 [プラン未選択] | ⚠️ ターミナルで ~/.claude/setup-statusline.sh を実行"
        exit 0
    fi
    
    # 現在の使用量を取得(タイムアウト処理付き)
    CURRENT=$(timeout 10s ccusage blocks --active --json 2>/dev/null)
    if [ -z "$CURRENT" ] || [ "$CURRENT" = "null" ]; then
        echo "🤖 Claude | ⚠️ No active session"
        exit 0
    fi
    
    # アクティブなブロックがあるか確認
    IS_ACTIVE=$(echo "$CURRENT" | jq -r '.blocks[0].isActive // false')
    if [ "$IS_ACTIVE" != "true" ]; then
        echo "🤖 Claude | ⚠️ No active block"
        exit 0
    fi
    
    # モデル名を取得と整形
    SETTINGS_MODEL=$(jq -r '.model // ""' ~/.claude/settings.json 2>/dev/null)
    
    if [ -n "$SETTINGS_MODEL" ] && [ "$SETTINGS_MODEL" != "null" ]; then
        case "$SETTINGS_MODEL" in
            "opus")
                MODEL_RAW="claude-opus-4-1-20250805"
                ;;
            "sonnet")
                MODEL_RAW="claude-sonnet-4-20250514"
                ;;
            "haiku")
                MODEL_RAW="claude-haiku-3-20250514"
                ;;
            *)
                MODEL_RAW=$(echo "$CURRENT" | jq -r '.blocks[0].models[-1] // "claude"')
                ;;
        esac
    else
        MODEL_RAW=$(echo "$CURRENT" | jq -r '.blocks[0].models[-1] // "claude"')
    fi
    
    # claude-opus-4-1-20250805 -> Opus 4.1
    MODEL=$(echo "$MODEL_RAW" | \
        sed 's/^claude-//' | \
        sed 's/-[0-9]\{8\}$//' | \
        sed 's/-\([0-9]\)-\([0-9]\)/ \1.\2/' | \
        sed 's/-\([0-9]\)$/ \1/' | \
        awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) substr($i,2)} 1')
    
    # トークン計算
    INPUT_TOKENS=$(echo "$CURRENT" | jq -r '.blocks[0].tokenCounts.inputTokens // 0')
    OUTPUT_TOKENS=$(echo "$CURRENT" | jq -r '.blocks[0].tokenCounts.outputTokens // 0')
    TOKENS=$((INPUT_TOKENS + OUTPUT_TOKENS))
    
    # コスト取得
    COST=$(echo "$CURRENT" | jq -r '.blocks[0].costUSD // 0' | xargs printf "%.2f")
    
    # リセット時刻の計算
    END_TIME=$(echo "$CURRENT" | jq -r '.blocks[0].endTime // ""')
    if [ -n "$END_TIME" ] && [ "$END_TIME" != "null" ]; then
        END_TIME_CLEAN="${END_TIME%%.*}"
        END_TIME_CLEAN="${END_TIME_CLEAN%%Z}"
    
        END_EPOCH=$(date -j -u -f "%Y-%m-%dT%H:%M:%S" "$END_TIME_CLEAN" +%s 2>/dev/null)
        if [ -n "$END_EPOCH" ]; then
            RESET_TIME=$(LC_TIME=C date -r $END_EPOCH "+%-I:%M%p" 2>/dev/null)
    
            CURRENT_EPOCH=$(date +%s)
            REMAINING_SECONDS=$((END_EPOCH - CURRENT_EPOCH))
            if [ $REMAINING_SECONDS -gt 0 ]; then
                REMAINING_HOURS=$((REMAINING_SECONDS / 3600))
                REMAINING_MINUTES=$(((REMAINING_SECONDS % 3600) / 60))
                REMAINING_TIME="${REMAINING_HOURS}h ${REMAINING_MINUTES}m"
            else
                REMAINING_TIME="0m"
            fi
        else
            RESET_TIME="--"
            REMAINING_TIME="--"
        fi
    else
        RESET_TIME="--"
        REMAINING_TIME="--"
    fi
    
    # パーセント計算
    if [ "$TOKEN_LIMIT" -gt 0 ]; then
        TOKEN_PCT=$(awk "BEGIN {printf \"%.0f\", ($TOKENS/$TOKEN_LIMIT)*100}")
        if [ $TOKENS -ge 1000 ]; then
            TOKEN_DISPLAY=$(awk "BEGIN {printf \"%.1fk\", $TOKENS/1000}")
        else
            TOKEN_DISPLAY="$TOKENS"
        fi
        if [ $TOKEN_LIMIT -ge 1000 ]; then
            LIMIT_DISPLAY=$(awk "BEGIN {printf \"%.0fk\", $TOKEN_LIMIT/1000}")
        else
            LIMIT_DISPLAY="$TOKEN_LIMIT"
        fi
    else
        TOKEN_PCT="--"
        TOKEN_DISPLAY="$TOKENS"
        LIMIT_DISPLAY="--"
    fi
    
    if [ "$COST_LIMIT" != "0" ] && [ "$COST_LIMIT" != "" ]; then
        COST_PCT=$(awk "BEGIN {printf \"%.0f\", ($COST/$COST_LIMIT)*100}")
    else
        COST_PCT="--"
    fi
    
    # プラン名を大文字に変換
    PLAN_DISPLAY=$(echo "$PLAN" | tr '[:lower:]' '[:upper:]')
    
    # 警告レベルの判定
    WARNING=""
    if [ "$TOKEN_PCT" != "--" ] && [ "$TOKEN_PCT" -ge 95 ]; then
        WARNING="🔴"
    elif [ "$TOKEN_PCT" != "--" ] && [ "$TOKEN_PCT" -ge 80 ]; then
        WARNING="⚠️"
    fi
    
    # セッションIDの取得
    SESSION_ID=""
    SESSION_DIR="$HOME/.claude/runtime/sessions"
    
    CURRENT_PID=$$
    CLAUDE_PID=""
    for i in {1..10}; do
        PARENT_CMD=$(ps -p $CURRENT_PID -o comm= 2>/dev/null)
    
        if [ $? -ne 0 ] || [ -z "$PARENT_CMD" ]; then
            break
        fi
    
        if [[ "$PARENT_CMD" == *"claude"* ]]; then
            CLAUDE_PID=$CURRENT_PID
            break
        fi
    
        NEXT_PID=$(ps -o ppid= -p $CURRENT_PID 2>/dev/null | tr -d ' ')
        if [ $? -ne 0 ] || [ -z "$NEXT_PID" ] || [ "$NEXT_PID" = "1" ]; then
            break
        fi
        CURRENT_PID=$NEXT_PID
    done
    
    if [ -n "$CLAUDE_PID" ] && [ -f "$SESSION_DIR/session-$CLAUDE_PID" ]; then
        SESSION_ID=$(cat "$SESSION_DIR/session-$CLAUDE_PID" 2>/dev/null)
    elif [ -f "$SESSION_DIR/current" ]; then
        SESSION_ID=$(cat "$SESSION_DIR/current" 2>/dev/null)
    fi
    
    if [ -z "$SESSION_ID" ] || [ "$SESSION_ID" = "" ]; then
        SESSION_ID="----"
    fi
    
    # 現在のフォルダ名を取得
    CURRENT_FOLDER=$(basename "$PWD")
    
    # Gitブランチ名を取得
    GIT_BRANCH=$(git branch --show-current 2>/dev/null)
    
    # セッションID表示部分の生成
    SESSION_DISPLAY_NEW=""
    if [ -n "$SESSION_ID" ] && [ "$SESSION_ID" != "" ]; then
        SESSION_DISPLAY_NEW=" [ID:$SESSION_ID]"
    fi
    
    # フォルダ・ブランチ表示部分の生成
    FOLDER_DISPLAY=" | Dir: $CURRENT_FOLDER"
    BRANCH_DISPLAY=""
    if [ -n "$GIT_BRANCH" ]; then
        BRANCH_DISPLAY=" | Branch: $GIT_BRANCH"
    fi
    
    # 表示(1行に収める)
    if [ -n "$WARNING" ]; then
        echo "🤖 $MODEL [$PLAN_DISPLAY] $WARNING | 💰 \$$COST/\$$COST_LIMIT (${COST_PCT}%) | 📊 ${TOKEN_DISPLAY}/${LIMIT_DISPLAY} (${TOKEN_PCT}%) | ⏰ ${RESET_TIME} (${REMAINING_TIME})${SESSION_DISPLAY_NEW}${FOLDER_DISPLAY}${BRANCH_DISPLAY}"
    else
        echo "🤖 $MODEL [$PLAN_DISPLAY] | 💰 \$$COST/\$$COST_LIMIT (${COST_PCT}%) | 📊 ${TOKEN_DISPLAY}/${LIMIT_DISPLAY} (${TOKEN_PCT}%) | ⏰ ${RESET_TIME} (${REMAINING_TIME})${SESSION_DISPLAY_NEW}${FOLDER_DISPLAY}${BRANCH_DISPLAY}"
    fi
    EOF
    
    # 実行権限を付与
    chmod +x ~/.claude/scripts/custom-statusline.sh

    2-3. セッション管理スクリプトの作成

    cat > ~/.claude/scripts/session-start-handler.sh << 'EOF'
    
    #!/bin/bash
    # Claude Code セッション開始時にセッションIDを保存
    # Purpose: セッション開始と同時にセッションIDを取得し、ステータスライン表示用に保存
    
    # JSON入力を読み取る(SessionStartイベント)
    input_json=$(cat)
    
    # セッションIDを抽出(先頭8文字)
    session_id=$(echo "$input_json" | jq -r '.session_id // "unknown"' | cut -c1-8)
    session_short=$(echo "$session_id" | cut -c1-4)
    
    # Claude CodeプロセスのPIDを取得
    # PPIDはbashのPIDなので、2段階遡ってClaude PIDを取得
    CLAUDE_PID=$(ps -o ppid= -p $PPID | xargs ps -o ppid= -p | tr -d ' ')
    
    # フォールバック: 上記が失敗した場合
    if [ -z "$CLAUDE_PID" ] || [ "$CLAUDE_PID" = "1" ]; then
        # 実行中のclaudeプロセスから最新のものを取得
        CLAUDE_PID=$(pgrep -f "claude" | tail -1)
    fi
    
    # セッション管理ディレクトリの確保
    SESSION_DIR="$HOME/.claude/runtime/sessions"
    mkdir -p "$SESSION_DIR"
    
    # プロセス固有のファイルにセッションIDを保存
    # これにより複数のClaude Codeセッションが同時実行されても衝突しない
    session_file="$SESSION_DIR/session-$CLAUDE_PID"
    echo "$session_short" > "$session_file"
    
    # 現在のセッションとしても記録(最新のセッションIDを常に保持)
    echo "$session_short" > "$SESSION_DIR/current"
    
    # デバッグ情報(stderr経由でログに記録)
    echo "SessionStart: PID=$CLAUDE_PID, SessionID=$session_short, File=$session_file" >&2
    
    # ステータスライン表示
    bash "$HOME/.claude/scripts/custom-statusline.sh"
    
    # 成功終了
    exit 0
    
    # 実際のファイル: ~/.claude/scripts/session-start-handler.sh
    EOF
    
    # 実行権限を付与
    chmod +x ~/.claude/scripts/session-start-handler.sh

    Step 3: プラン選択スクリプトの実行

    # 実行してプラン選択
    ~/.claude/scripts/setup-statusline.sh

    Step 4: プロジェクト設定(条件付き)

    基本的には前の手順までで完了ですが、以下の場合のみプロジェクトローカル設定が必要です。

    • プロジェクトで独自のhooks(textlint等)を使用している場合

    • 複数セッションでのセッションID表示が必要な場合

    該当する場合は、以下の設定を追加してください。

    # 現在のプロジェクトにローカル設定を追加
    mkdir -p .claude
    cat > .claude/settings.local.json << 'EOF'
    {
      "hooks": {
        "SessionStart": [{
          "matcher": "(.*)",
          "hooks": [{
            "type": "command",
            "command": "bash ~/.claude/scripts/session-start-handler.sh"
          }]
        }]
        // 既存の他のhooks設定がある場合はここに追加
      }
    }
    EOF

    注意: statusLine設定はグローバル設定で十分のため、ローカルには記載不要です。

    Step 5: 設定ファイルの完全例

    グローバル設定(settings.json)

    {
      "statusLine": {
        "type": "command",
        "command": "bash ~/.claude/scripts/custom-statusline.sh"
      },
      "hooks": {
        "SessionStart": [{
          "matcher": "(.*)",
          "hooks": [{
            "type": "command",
            "command": "bash ~/.claude/scripts/session-start-handler.sh"
          }]
        }]
      }
    }

    プロジェクトローカル設定(settings.local.json)

    {
      "hooks": {
        "SessionStart": [{
          "matcher": "(.*)",
          "hooks": [{
            "type": "command",
            "command": "bash ~/.claude/scripts/session-start-handler.sh"
          }]
        }],
        "PostToolUse": [{
          "matcher": "Edit",
          "hooks": [{
            "type": "command",
            "command": "npx textlint --fix"
          }]
        }]
      }
    }

    プラン設定ファイル(statusline-config.json)

    {
      "plan": "max5",
      "token_limit": 88000,
      "cost_limit": 35,
      "updated_at": "2025-08-11T02:06:17Z"
    }

    Step 6: Claude Code再起動で反映

    # 必ず再起動!
    exit  # Claude Codeを終了
    claude  # Claude Codeを再起動
    
    # 画面下部にステータスラインが表示されれば成功!

    まとめ - 私が得た3つの気づき

    1. 小さな効率化が大きな生産性向上につながる

      • 1回15秒の節約 × 20回/日 = 5分/日の節約

      • でも実際の効果は集中力の維持による生産性2倍

    2. 視覚的フィードバックの威力

      • 数値が常に見えることで自然とトークン節約意識が生まれる

      • 警告表示により計画的な作業が可能に

    3. 設定は一度やれば永続的な効果

      • 30分の設定時間で、毎日の作業効率が劇的に改善

      • ROIで考えると1日で元が取れる投資


    最後に

    私のように「使用量の確認って面倒...」と思っているあなたへ。

    大丈夫です。この記事のコードをコピペするだけで動きます。
    設定してみたら、こんなに簡単で、こんなに効果があるとは思いませんでした!
    今では、ステータスラインなしのClaude Codeは考えられません。

    この記事が、あなたの Claude Code ライフをより快適な環境へ導く助けとなれば幸いです。


    参考リンク


    この記事が役に立ったら、ぜひ「スキ」とフォローをお願いします!


    あなたへのおすすめ