Claude Codeの「今何してる？」が一目でわかるダッシュボード — claude-hud

アーキテクチャ・仕組み

Claude HUDはClaude Codeのネイティブ statusline API を利用しており、標準入力（stdin）からJSON形式でデータを受け取り、標準出力（stdout）でターミナルに表示する仕組みです。別ウィンドウやtmuxは不要で、どのターミナルでも動作します。

Claude Code → stdin JSON → claude-hud → stdout → ターミナル表示
           ↘ transcript JSONL（ツール・エージェント・Todo情報）

• トークン数はClaude Codeからのネイティブデータを使用（推定値ではない）
• 1Mコンテキストセッションを含むClaude Codeの報告するウィンドウサイズに自動スケール
• トランスクリプト（会話ログ）をパースしてツール/エージェントの活動を取得
• 約300msごとに更新

対応環境

• Claude Code: v1.0.80以上
• ランタイム: Node.js 18以上 または Bun
• OS: macOS、Linux、Windows対応
  • Linuxでは/tmpがtmpfsの場合にインストール時の回避策が必要
  • Windowsではセットアップ後にClaude Codeの完全再起動が必要

主要機能一覧

プリセット

• Full: 全機能有効（ツール、エージェント、Todo、Git、使用量、セッション時間）
• Essential: アクティビティ + Git情報のみ
• Minimal: モデル名とコンテキストバーのみ

レイアウト

• expanded（デフォルト）: 複数行で詳細表示
• compact: 1行にまとめた簡潔表示

カスタマイズ

設定ファイル: ~/.claude/plugins/claude-hud/config.json

• パス表示レベル（1〜3階層）
• 表示要素の順序変更（elementOrderで制御）
• カラーカスタマイズ（名前指定、256色番号、HEX値に対応）
• コンテキスト表示形式（パーセント、トークン数、残量、複合）
• 7日間使用量の表示閾値設定

制約・注意点

• 使用量表示はClaude サブスクリプションユーザーのみ対応（APIキーのみのユーザーには非対応）
• AWS BedrockモデルではBedrockラベル表示、使用量制限は非表示
• メモリ使用量はOS全体の概算値であり、Claude Code固有のメモリ使用量ではない
• 設定ファイルのJSON構文エラーがあると無言でデフォルトにフォールバック
• rate_limitsはセッション中の最初のモデル応答後に利用可能になる場合がある

ライセンス

MITライセンス（商用利用可能）

Claude Codeのセッション内で以下のコマンドを順に実行します：

ステップ1: マーケットプレイスを追加

/plugin marketplace add jarrodwatts/claude-hud

ステップ2: プラグインをインストール

/plugin install claude-hud

⚠️ Linuxの場合は事前に以下を実行：

mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude

ステップ3: ステータスラインを設定

/claude-hud:setup

設定完了後、Claude Codeを再起動するとHUDが表示されます。