【保存版】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
— ryoppippi (@ryoppippi) August 9, 2025
try to add
```
{
"statusLine": {
"type": "command",
"command": "bun x ccusage statusline",
}
}
```
in your .claude/settings.json https://t.co/kD0VOZPqlc pic.twitter.com/NENfyeBm3T
本記事では、標準表示に加えて契約プラン別の残量表示や警告機能など、実運用に効く拡張の作り方を紹介します。
この記事で学べること
Claude Codeステータスラインの本質的な価値 - なぜ生産性が上がるのか
設定前後の作業効率の決定的な違い - 実測データで証明
設定時の落とし穴と解決策 - 私が実際にハマったポイント
実践的な設定例(コピペOK) - そのまま使える完全版
生産性改善の実測値 - 具体的な数値で効果を実感
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 --helpStep 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.sh2-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.sh2-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.shStep 3: プラン選択スクリプトの実行
# 実行してプラン選択
~/.claude/scripts/setup-statusline.shStep 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回15秒の節約 × 20回/日 = 5分/日の節約
でも実際の効果は集中力の維持による生産性2倍
視覚的フィードバックの威力
数値が常に見えることで自然とトークン節約意識が生まれる
警告表示により計画的な作業が可能に
設定は一度やれば永続的な効果
30分の設定時間で、毎日の作業効率が劇的に改善
ROIで考えると1日で元が取れる投資
最後に
私のように「使用量の確認って面倒...」と思っているあなたへ。
大丈夫です。この記事のコードをコピペするだけで動きます。
設定してみたら、こんなに簡単で、こんなに効果があるとは思いませんでした!
今では、ステータスラインなしのClaude Codeは考えられません。
この記事が、あなたの Claude Code ライフをより快適な環境へ導く助けとなれば幸いです。
参考リンク
この記事が役に立ったら、ぜひ「スキ」とフォローをお願いします!