Context Gauge
Claude Code エージェントのコンテキストウィンドウがどれだけ埋まっているかを一目で示す、タイルごとのフィルバー。
Context Gauge は Claude Code タイルのタイトルバーに表示される細いフィルバーです。一目でわかるようにするのは一つの問いに答えるためです — このエージェントはあとどれくらいでコンテキストを使い切るか。これがないと、エージェントがタスク中に突然コンパクションやトランケートを始めた事後でしか気づけません。
エージェントが長いタスクを走らせているときはこのゲージを注視してください。緑から琥珀色、そして赤へと上昇していくのに合わせて、ターンをまとめるか、新しいセッションを始めるか、コンテキスト圧迫で品質が落ちる前に別のエージェントへ引き継ぐべきタイミングがわかります。
できること
- コンテキストウィンドウの埋まり具合を一目で把握 — タイルのタイトルバーにあるフィルバーとパーセンテージラベル。
- 早期に問題を発見 — バーは 70% で琥珀色、90% で赤になるため、エージェントが壁にぶつかる前に気づけます。
- ホバーで正確な数値を確認 — ツールチップにトークン数とモデルのコンテキストウィンドウサイズが表示されます（例:
Context ~42% · 84k of 200k tokens (claude-opus-4-7)）。 - Dynamic Workflows を個別に追跡 — タイルが Claude Code の Dynamic Workflow 実行中の場合、ツールチップに集計された
workflow … tokensの数値（サブエージェント実行中は(active)マーカーも）が追加されます。メインのパーセンテージとは別に追跡されるため、メインセッションの埋まり具合を誤表示しません。
使い方
- Claude Code のエージェントタイルを立ち上げるか開きます。ゲージは自動的にタイトルバーに表示されます — 何も有効化する必要はありません。
- エージェントが作業している間、色を見て判断します:
範囲 色 < 70% 緑 70–89% 琥珀色 ≥ 90% 赤 - ゲージをホバーすると正確なトークン数とモデルが表示されます。
- ゲージが琥珀色や赤に達したら、現在のターンをまとめるか、新しいセッションを始めるか、作業を別のエージェントに移すかを判断します。
ゲージは、検出されたエージェントが Claude Code であり、実際にエージェントが検出されているタイルでのみ表示されます。Codex、Amp、OpenCode、通常のシェルには表示されません — これらの CLI は Claude Code のようなローカルで構造化された usage ブロックを公開しないためです。
よくあるユースケース
- 「この長いリファクタリング、もうすぐコンパクトされる？」 — ゲージを見て、赤ならターンをまとめるか新しいセッションを始めます。コンテキスト圧迫で品質が落ちる前に。
- 「次の指示に向けてどれくらい余裕がある？」 — ホバーして正確なパーセンテージとトークン数を確認します。
- 「ワークフローのサブエージェントのトークン消費が見たい」 — Dynamic Workflow 実行中のタイルのゲージをホバーします。ワークフローのトークン数がメインのパーセンテージとは別に表示されます。
ヒントとベストプラクティス
- 琥珀色は「もうすぐまとめる」、赤は「今すぐ決める」と考えてください。エージェントは赤を超えても動き続けますが、コンテキスト圧迫が高まると品質が落ちることがあります。
- ゲージは MadoHub ウィンドウがバックグラウンドの間は一時停止し、フォアグラウンドに戻すと即座に再更新します。そのため見ているときは常に最新の数値が表示されます。
- ポーリングが一時的に失敗した場合（多くはセッションファイルがまだ存在しないとき）、ゲージは空白になる代わりに最後の既知値を表示し続けます — 短い欠落に焦らないでください。
- ワークフローのサブエージェントはメインセッションのウィンドウではなく独自のコンテキストで動くため、そのトークン使用量は別途追跡され、意図的にメインのパーセンテージには組み込まれません。
関連機能
- Fleet — 行ごとにワークフローの進行（
workflow · 3/5 agents）を状態とともに確認できます。 - Dynamic Workflows — ツールチップがサブエージェントのトークン使用量を表示する Claude Code の機能です。
- MadoAgent — タイルのコンテキストが尽きかけているときに新しいエージェントを立ち上げます。
制限事項
- Claude Code 専用です。他のエージェントタイプや通常のシェルにはゲージが表示されません。
- パーセンテージは、最新の assistant メッセージの usage ブロックに基づく近似であり、OS レベルのリアルタイム計測ではありません。
- 未知のモデル文字列は 200,000 トークンのコンテキストウィンドウを控えめなデフォルトとして使うため、MadoHub のテーブルが更新されるまでは新モデルのパーセンテージがわずかにずれることがあります。