本文へスキップ
claudemods

Claude Code ステータスライン Mod

Claude Code ステータスライン Mod は、ブランチ、コンテキストの使用率、コスト、カウンターなどの最新情報をステータスラインやプロンプト上のバンドに表示し、尋ねる手間を省きます。

Claude Code で動作中の コンテキストメーター

コンテキストメーター

コンテキストウィンドウの使用率、5 時間・7 日間のプラン使用量、セッションのコストをステータスラインに表示し、上限が近づくと警告します。

  • ステータス
  • トースト
  • UI を変更

v2.1.291 で検証済み

Claude Code で動作中の プロンプト上の Git ブランチ表示

プロンプト上の Git ブランチ表示

Git のブランチ、変更ファイル数、ahead/behind の状態を Claude Code のプロンプトの上に 1 行で表示します。

  • プロンプト上部
  • コマンドを実行
  • ツール呼び出しを傍受
  • UI を変更

v2.1.291 で検証済み

Claude Code で動作中の ツール呼び出しカウンター

ツール呼び出しカウンター

Claude のツール呼び出しをターンごと・セッションごとに数え、スピナーの横に件数を表示。/tally で内訳も確認できます。

  • スピナー
  • トランスクリプト
  • ステータス
  • ツール呼び出しを傍受
  • UI を変更
  • コマンド・ツールを追加

v2.1.291 で検証済み

Claude Code ステータスライン Mod は、作業中にちょっとしたリアルタイムの状態を表示します。現在の git ブランチ、コンテキストウィンドウの埋まり具合、プランの残り利用量、セッションのコスト、このターンで Claude がツールを呼び出した回数などです。コマンドを入力して答えを待つ代わりに、ひと目で確認できます。

Claude Code ステータスライン Mod はどのようにテキストを描画するのですか?

表示先は 2 つあります。1 つ目はステータスラインそのもので、Mod は $.ui.status('...') で書き込みます。受け取るのはプレーンな文字列で、数値を表示する最も手軽な方法です。2 つ目は入力欄の上にある 1 行のバンドで、Mod は AbovePrompt レンダーサイトに対する ui.render イベントを処理し、$.ui.resolve(e) から取り出した Box と Text 要素を返して描画します。バンドでは色、太字、切り詰めが使えるので、⎇ main · 3 changed · ↑1 ↓0 のような情報量の多い行に向いています。

更新のタイミングは通常、最初の読み取りには session.start、Claude の回答後には turn.complete、コンパクション後には session.compact、そして予備として間隔の長い $.clock.every(ms) です。内訳を求めずに $.session.usage() を読む Mod は、Claude Code がすでに持っている数値を読むだけなのでコストがかかりません。イベントとレンダーサイトの全一覧は Mod リファレンスにあります。

インストール前に何を確認すべきですか?

権限バッジを見てください。純粋なインジケーターなら、UI を変更以外はほとんど表示されないはずです。コマンドを実行は、git status を実行する必要がある git インジケーターでは普通のことですが、「仕組み」セクションを読んで、実行するプログラムと引数を正確に確認しましょう。ネットワークや プロンプトを読み取るも表示されるステータスライン Mod には、明確な理由が必要です。

次に、「カスタマイズ」の表で更新間隔を確認します。大きなリポジトリで短いタイマーを使うと git status が頻繁に実行され、遅いディスクでは体感できることがあります。最後に、Mod のページでテスト済みのバージョンを確認してください。ターミナルで Mod を使うには Claude Code 2.1.287 以降が必要です。

複数のインジケーターを組み合わせられますか?

はい。典型的な構成は、プロンプト上のブランチ表示バンドと、ステータスラインのコンテキスト・コストメーターの組み合わせです。使わない部分は /config で各 Mod の設定からオフにし、行が騒がしくなってきたら /plugin の Installed タブで Mod ごと無効にしましょう。

よくある質問

複数の Claude Code ステータスライン Mod が互いに上書きし合うことはありますか?
いいえ。各 Mod の $.ui.status のテキストはそのプラグインに属するので、2 つの Mod がどちらもステータステキストを書き込めます。ただし行はすぐに混み合うので、実際に見る 2〜3 個の数値に絞りましょう。
ステータスライン Mod で Claude が遅くなりますか?
毎秒ポーリングするのではなく、turn.complete のようなイベントをきっかけに更新するなら遅くなりません。git status のようにタイマーでプログラムを実行する Mod では、/config で間隔を設定できます。
プロンプト上のバンドが表示されないのはなぜですか?
バンドは、アンケートが開いているときなど、Claude Code 自身のコンテンツに場所を譲ります。/plugin で Mod が有効になっているか、Claude Code 2.1.287 以降を使っているかを確認し、シェルからインストールした後は /reload-plugins を実行してください。