Claude Code StatuslineとStatus Barの完全ガイド【2026年最新】：ターミナルに何を表示すべきか、設定方法から活用ツールまで

Claude Code StatuslineとStatus Barの完全ガイド【2026年最新】：ターミナルに何を表示すべきか、設定方法から活用ツールまで

Claude Code Statuslineとは何か

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

Statuslineに渡されるJSONの構造

{
  "model": {
    "id": "claude-sonnet-4-6-20251022",
    "display_name": "Claude Sonnet 4.6"
  },
  "context_window": {
    "total_input_tokens": 12400,
    "total_output_tokens": 3200,
    "context_window_size": 200000,
    "used_percentage": 7.8
  },
  "cost": {
    "total_cost_usd": 0.04,
    "total_lines_added": 42,
    "total_lines_removed": 7,
    "total_duration_ms": 180000
  },
  "workspace": {
    "current_dir": "/Users/yourname/projects/my-app"
  },
  "worktree": {
    "name": "my-app-payments"
  },
  "rate_limits": {
    "five_hour": {
      "used_percentage": 42,
      "resets_at": 1742651200
    },
    "seven_day": {
      "used_percentage": 18,
      "resets_at": 1743120000
    }
  }
}

基本的なStatuslineスクリプトの作り方

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
INPUT_TOKENS=$(echo "$input" | jq -r '.context_window.total_input_tokens')
OUTPUT_TOKENS=$(echo "$input" | jq -r '.context_window.total_output_tokens')
CONTEXT_SIZE=$(echo "$input" | jq -r '.context_window.context_window_size')

TOTAL_TOKENS=$((INPUT_TOKENS + OUTPUT_TOKENS))
PERCENT_USED=$((TOTAL_TOKENS * 100 / CONTEXT_SIZE))

echo "[$MODEL] Context: ${PERCENT_USED}%"

chmod +x ~/.claude/statusline.sh

そして~/.claude/settings.jsonに設定を追加します。

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

Claude Codeを再起動すれば、ターミナルの下部に[Claude Sonnet 4.6] Context: 7%のような表示が出るようになります。

動作確認：スクリプトをテストする方法

jq --version

echo '{"model":{"display_name":"Sonnet 4.6"},"context_window":{"total_input_tokens":1000,"total_output_tokens":500,"context_window_size":200000}}' | ~/.claude/statusline.sh

コスト表示とレートリミット監視を追加する

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
INPUT_TOKENS=$(echo "$input" | jq -r '.context_window.total_input_tokens')
OUTPUT_TOKENS=$(echo "$input" | jq -r '.context_window.total_output_tokens')
CONTEXT_SIZE=$(echo "$input" | jq -r '.context_window.context_window_size')
COST=$(echo "$input" | jq -r '.cost.total_cost_usd')

TOTAL_TOKENS=$((INPUT_TOKENS + OUTPUT_TOKENS))
PERCENT_USED=$((TOTAL_TOKENS * 100 / CONTEXT_SIZE))

printf "[%s] Context: %d%% | $%.2f" "$MODEL" "$PERCENT_USED" "$COST"

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
PERCENT_USED=$(echo "$input" | jq -r '.context_window.used_percentage')
COST=$(echo "$input" | jq -r '.cost.total_cost_usd')
RL_5H=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // "N/A"')
RL_RESET=$(echo "$input" | jq -r '.rate_limits.five_hour.resets_at // ""')

# リセット時刻を人間が読める形式に変換（macOS/Linux両対応）
if [ -n "$RL_RESET" ] && [ "$RL_RESET" != "null" ]; then
  RESET_TIME=$(date -d @"$RL_RESET" "+%H:%M" 2>/dev/null || date -r "$RL_RESET" "+%H:%M" 2>/dev/null)
else
  RESET_TIME="--:--"
fi

printf "[%s] Ctx: %.0f%% | $%.2f | 5h: %.0f%% (reset %s)" \
  "$MODEL" "$PERCENT_USED" "$COST" "$RL_5H" "$RESET_TIME"

/statuslineスラッシュコマンドで簡単セットアップ

/statusline モデル名とコンテキスト使用率、セッションコストを表示するステータスラインを設定してください

これだけで、Claude Codeがスクリプトを書いて、設定ファイルを更新して、再起動の案内もしてくれます。

ccstatusline：本格的なStatuslineツール

npm install -g ccstatusline

インストール後、対話式のTUI（テキストユーザーインターフェース）で設定できます。

ccstatusline config

ccusage：Statuslineとは別の補完ツール

npm install -g ccusage

gitワークツリーとの連携

CURRENT_DIR=$(echo "$input" | jq -r '.workspace.current_dir')
DIR_NAME=$(basename "$CURRENT_DIR")

claude code context usage status lineの活用：コンテキスト管理の実践

#!/bin/bash
input=$(cat)

PERCENT_USED=$(echo "$input" | jq -r '.context_window.used_percentage')
MODEL=$(echo "$input" | jq -r '.model.display_name')
COST=$(echo "$input" | jq -r '.cost.total_cost_usd')

# 使用率に応じて色を変える
PERCENT_INT=$(printf "%.0f" "$PERCENT_USED")
if [ "$PERCENT_INT" -ge 90 ]; then
  COLOR="\033[31m"  # 赤
elif [ "$PERCENT_INT" -ge 70 ]; then
  COLOR="\033[33m"  # 黄
else
  COLOR="\033[32m"  # 緑
fi
RESET="\033[0m"

printf "[%s] ${COLOR}Ctx: %.0f%%${RESET} | \$%.2f" "$MODEL" "$PERCENT_USED" "$COST"

claude code status commandとconfig：設定をチームで共有する

よくある質問とトラブルシューティング

• jqがインストールされているか（jq --versionで確認）
• スクリプトに実行権限がついているか（chmod +x ~/.claude/statusline.sh）
• ~/.claude/settings.jsonの記述が正しいか（JSON形式が壊れていないか）
• Claude Codeを設定変更後に再起動したか

claude --version

まとめ

出典

• Claude Code Settings - Anthropic公式ドキュメント
• ccstatusline - GitHub