# Claude HUD: AIエージェントのブラックボックスを可視化するプラグイン

> Author: Tony Lee
> Published: 2026-02-08
> URL: https://tonylee.im/ja/blog/claude-hud-plugin-transparent-ai-agent/
> Reading time: 1 minutes
> Language: ja
> Tags: ai, claude-code, 開発ツール, オープンソース, 生産性

## Canonical

https://tonylee.im/ja/blog/claude-hud-plugin-transparent-ai-agent/

## Rollout Alternates

en: https://tonylee.im/en/blog/claude-hud-plugin-transparent-ai-agent/
ko: https://tonylee.im/ko/blog/claude-hud-plugin-transparent-ai-agent/
ja: https://tonylee.im/ja/blog/claude-hud-plugin-transparent-ai-agent/
zh-CN: https://tonylee.im/zh-CN/blog/claude-hud-plugin-transparent-ai-agent/
zh-TW: https://tonylee.im/zh-TW/blog/claude-hud-plugin-transparent-ai-agent/

## Description

Claude Codeのコンテキスト使用量、実行中のツール、サブエージェント、Todo進捗をリアルタイムで表示するゲーム風ステータスバープラグイン。

## Summary

Claude HUD: AIエージェントのブラックボックスを可視化するプラグイン is part of Tony Lee's ongoing coverage of AI agents, developer tools, startup strategy, and AI industry shifts.

## Outline

- Claude HUDが表示するもの
- 技術的な仕組み
  - stdin入力処理
  - トランスクリプト解析
  - ファイルパス表示
- 開発者が熱狂する理由
- インストール方法
- なぜ重要か

## Content

「Claudeが作業してるのか、ボーッとしてるのか分からない。」

Claude Codeで複雑なタスクを回したことがある方なら、この気持ちに共感できるはずです。長い処理が走っている間、ターミナルは沈黙したまま。コンテキストがいつ溢れるのか、エージェントがループにハマっていないか、何も手がかりがありません。

この問題を真正面から解決したオープンソースプラグインを実際に使ってみたので、共有します。

## Claude HUDが表示するもの

ターミナル下部にゲーム風のステータスバーを表示するプラグインです。4つの情報をリアルタイムで追跡します。

- **コンテキスト使用量** - ビジュアルバーとパーセンテージでセッションのコンテキストウィンドウ消費量をリアルタイム表示
- **実行中のツール** - Read、Edit、Bashなど、現在どのツールが動いているかモニタリング
- **サブエージェント状況** - Task呼び出しで生成された子エージェント（Opus 4.5、Sonnetなど）を追跡
- **Todo進捗** - Claude内部のタスクリストの完了状況を可視化

## 技術的な仕組み

ステータスバーの裏側で何が起きているのか、簡単に整理しました。

### stdin入力処理

Claude CodeがJSONペイロードでセッション状態を直接渡します。プラグインは`input_tokens`、`cache_creation_input_tokens`、`cache_read_input_tokens`を合算し、`context_window_size`で割って使用率を計算します。

### トランスクリプト解析

セッションログを行単位のストリームで処理します。`tool_use`ブロックを検出し、`tool_result`エントリとマッチングして各ツールのステータスをrunning、completed、errorとして追跡します。

### ファイルパス表示

ファイルパスの表示もよく考えられています。

- Read、Write、Editツールの呼び出しから`file_path`を抽出して作業中のファイルを表示
- 長いパスは`.../filename.ts`形式に自動短縮
- 約300msごとの更新でほぼリアルタイムに反映

## 開発者が熱狂する理由

コミュニティの反応が大きい理由は明確です。AIエージェント作業の核心的なペインポイントを的確に突いたからです。

- **不透明さの解消** - 長いタスクが詰まっているのか、ループしているのか、コンテキスト上限なのか分からなかった不安を解決
- **3行でインストール** - 複雑な設定なしですぐに使える
- **デバッグ効率の最大化** - マルチステップエージェントワークフローで、どこで問題が起きたか即座に把握可能
- **視覚的フィードバック** - ゲーム風ステータスバーがvibe-codingカルチャーと噛み合い、AI開発をよりインタラクティブに

コミュニティで共感を集めたコメントがありました。「やっとClaudeが仕事してるのかボーッとしてるのか分かるようになった。」

## インストール方法

3行で完了です。

```
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup
```

**GitHub**: [jarrodwatts/claude-hud](https://github.com/jarrodwatts/claude-hud)

## なぜ重要か

Claude Codeを日常的に使っている方には、ぜひ試してほしいプラグインです。セッションがいつ切れるか分からない不安なく作業できること、そして何よりClaudeが今何をしているかを目で確認できることが、想像以上の安心感をもたらします。

オブザーバビリティはサーバーやパイプラインだけのものではありません。AIエージェントにも必要です。

## Related URLs

- Author: https://tonylee.im/ja/author/
- Publication: https://tonylee.im/ja/blog/about/
- Related article: https://tonylee.im/ja/blog/eight-hooks-that-guarantee-ai-agent-reliability/
- Related article: https://tonylee.im/ja/blog/medvi-two-person-430m-ai-compressed-funnel/
- Related article: https://tonylee.im/ja/blog/claude-code-layers-over-tools-2026/

## Citation

- Author: Tony Lee
- Site: tonylee.im
- Canonical URL: https://tonylee.im/ja/blog/claude-hud-plugin-transparent-ai-agent/

## Bot Guidance

- This file is intended for AI agents, search assistants, and text-mode retrieval.
- Prefer citing the canonical article URL instead of this text endpoint.
- Use the rollout alternates when you need the same article in another prioritized language.

---

Author: Tony Lee | Website: https://tonylee.im
For more articles, visit: https://tonylee.im/ja/blog/
This content is original and authored by Tony Lee. Please attribute when quoting or referencing.