コンテキストメーター：Claude Code のコンテキスト使用率をステータスラインに表示

コンテキストメーターは、Claude Code のコンテキスト使用率をステータスラインに表示する Mod です。ステータスラインに ctx 42% · 5h 23% · 7d 61.5% · $1.20 のようなコンパクトな 1 行を書き込みます。これは、コンテキストウィンドウがどれだけ埋まっているか、5 時間と 7 日間のプラン利用ウィンドウをどれだけ使ったか（サブスクリプションの場合）、そしてこれまでのセッションのコストを示しています。コンテキストが 80% に達すると、トーストで一度だけ警告するので、Claude が以前の詳細を失い始める前に /compact や /clear を実行できます。

目的は、当て推量をやめることです。長いタスクが収まるかどうかを知るために /cost や /context を実行する必要はもうありません。警告は十分早いタイミングで届くので、自分の都合のよいときにコンパクションできます。Claude Code 2.1.287 以降が必要です。

録画では、この Mod を読み込んだ状態でセッションを開始しています。最初の応答までステータスラインには ctx – と表示され、ターンが完了するとコンテキストの割合、プランの利用ウィンドウ、コストが表示されます。

インストールブロックにある方法のどれかを選んでください。設定は不要です。デフォルトのままで、アカウントが提供するすべての数値が表示されます。

この Mod 全体は、3 つのフックと 1 つの更新関数だけでできています。hooks/register.ts から抜粋します。

async function refresh($: EngineInterface, meter: Meter): Promise<void> {
  // No `breakdown`: the status-line figures alone, which cost no request.
  const usage = await $.session.usage()
  $.ui.status(formatMeter(usage, meter))
  const percent = contextPercent(usage)
  const step = warnStep(percent, meter.warnAtPercent, meter.warned)
  meter.warned = step.warned
  if (step.toast) {
    $.ui.toast(`Context is ${percent}% full. Consider /compact or /clear soon.`)
  }
}

$.session.usage() は、コンテキストのトークン数とウィンドウサイズ、プランのレート制限、そしてコストを返します。breakdown を指定せずに呼び出すと、Claude Code がすでに持っている数値を読むだけなので、メーターは好きなだけ頻繁に実行してもコストがかかりません。hooks/format.ts の formatMeter が表示テキストを組み立て、エンジンが持っていない数値は 0 と表示せずに省略します。warnStep はすでに警告したかどうかを記憶しているため、トーストはしきい値を越えるたびに一度だけ表示されます。コンパクションによってコンテキストがしきい値を下回れば、再び警告できるようになります。

refresh は、session.start（ここで $.clock.every のタイマーも開始します）、メインループのターンに限った turn.complete、そして session.compact から呼ばれます。session.compact はコンパクションを取り消すことができるため、このフックはまず next(e) を await し、next の結果をそのまま返す .catch を備えています。メーターがコンパクションを止めることはありません。

以下のオプションは /config で設定できます。format: verbose にすると、表示が Context 42% (84k/200k) · 5-hour 23% · 7-day 61.5% · Cost $1.20 のように省略なしの形になります。ラベルは hooks/format.ts の LIMIT_LABELS テーブルにあるので、5h や 7d の名前を変えたい場合はそこを編集してください。警告文は refresh の中のテンプレート文字列です。

付いているバッジは UI を変更 だけです。この Mod はステータスラインに書き込み、トーストを表示します。コマンドの実行、ファイルの読み書き、ネットワークの利用、プロンプトの読み取り、モデルの呼び出しは一切行いません。そのため、インストールできる Mod の中でも特に安全なものの 1 つであり、最初の 1 本としても最適です。

オフにするには /plugin disable cm-context-meter を実行します。すべての Mod をオフにしてセッションを始めるには claude --safe-mode を使います。

macOS のターミナル上で Claude Code 2.1.291 にてテスト済みです。メーターが表示されない場合は、次を確認してください。

• claude --version を確認してください。Mod には 2.1.287 以降が必要です。
• /plugin の Installed タブで、この Mod が有効になっていることを確認してください。
• シェルからインストールした場合は、すでに開いているセッションで /reload-plugins を実行してください。
• 別の Mod やカスタムのステータスラインコマンドが同じ行を共有している場合があります。他のステータス系 Mod を一時的に無効にして、表示が押し出されていないか確認してください。
• API キーで利用している場合にプランの数値が表示されないのは、想定どおりの動作です。

コストの数値は、/cost が合計しているのと同じセッションの見積もりであり、請求書ではありません。