SpyBara
Go Premium

statusline.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 133 additions and 36 deletions.

2026
Wed 9 22:58 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

ステータスラインをカスタマイズする

Claude Code でコンテキストウィンドウの使用状況、コスト、git ステータスを監視するカスタムステータスバーを設定します

ステータスラインは Claude Code の下部にあるカスタマイズ可能なバーで、設定したシェルスクリプトを実行します。stdin 経由で JSON セッションデータを受け取り、スクリプトが出力したものを表示し、コンテキスト使用状況、コスト、git ステータス、またはその他の追跡したい情報を一目で確認できる永続的なビューを提供します。

ステータスラインは以下の場合に便利です：

  • 作業中にコンテキストウィンドウの使用状況を監視したい
  • セッションコストを追跡する必要がある
  • 複数のセッション間で作業し、それらを区別する必要がある
  • git ブランチとステータスを常に表示したい

ステータスラインは組み込みのフッターバッジの上にある独自の行にレンダリングされ、それらを置き換えません。カスタムステータスラインが設定されている場合、Claude Code はフッターのキーボードヒントのほとんどを表示しなくなります。これには esc to interrupt、? for shortcuts フォールバック、および hold space to speak 音声入力 ヒントが含まれます。会話内に ID が表示されたときにフッターにクリック可能なリンクバッジを追加する場合は、スクリプトを記述せずに footerLinksRegexes を設定してください。

以下は、最初の行に git 情報を表示し、2 番目の行にカラーコード化されたコンテキストバーを表示する 複数行ステータスライン の例です。

最初の行にモデル名、ディレクトリ、git ブランチを表示し、2 番目の行にコンテキスト使用状況プログレスバー、コスト、期間を表示する複数行ステータスライン

このページでは、基本的なステータスラインの設定 について説明し、Claude Code からスクリプトへの データフロー について説明し、表示できるすべてのフィールド をリストアップし、git ステータス、コスト追跡、プログレスバーなどの一般的なパターンの すぐに使える例 を提供します。

ステータスラインを設定する

/statusline コマンド を使用して Claude Code にスクリプトを生成させるか、手動でスクリプトを作成 して設定に追加します。

/statusline コマンドを使用する

/statusline コマンドは、表示したい内容を説明する自然言語の指示を受け入れます。Claude Code は ~/.claude/ にスクリプトファイルを生成し、設定を自動的に更新します：

/statusline show model name and context percentage with a progress bar

セットアップ中に Claude Code が権限を求める場合は、ファイル編集プロンプトを承認してください。

ステータスラインを手動で設定する

ユーザー設定（~/.claude/settings.json、~ はホームディレクトリ）または プロジェクト設定 に statusLine フィールドを追加します。type を "command" に設定し、command をスクリプトパスまたはインラインシェルコマンドに指定します。スクリプト作成の完全なチュートリアルについては、ステータスラインをステップバイステップで構築する を参照してください。

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh",
    "padding": 2
  }
}

command フィールドはシェルで実行されるため、スクリプトファイルの代わりにインラインコマンドを使用することもできます。この例では jq を使用して JSON 入力を解析し、モデル名とコンテキスト割合を表示します：

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
  }
}

オプションの padding フィールドは、ステータスラインコンテンツに追加の水平スペース（文字単位）を追加します。デフォルトは 0 です。このパディングはインターフェイスの組み込みスペースに加えて追加されるため、ターミナルエッジからの絶対距離ではなく相対的なインデントを制御します。

オプションの refreshInterval フィールドは、イベント駆動更新 に加えて、N 秒ごとにコマンドを再実行します。最小値は 1 です。ステータスラインが時計などの時間ベースのデータを表示する場合、またはメインセッションがアイドル状態の間にバックグラウンドサブエージェントが git 状態を変更する場合に設定します。イベントのみで実行する場合は設定しないままにします。

オプションの hideVimModeIndicator フィールドは、プロンプトの下にある組み込みの -- INSERT -- テキストを非表示にします。スクリプトが vim.mode 自体をレンダリングする場合は、これを true に設定して、モードが 2 回表示されないようにします。

ステータスラインを無効にする

/statusline を実行し、ステータスラインを削除またはクリアするよう指示します（例：/statusline delete、/statusline clear、/statusline remove it）。settings.json から statusLine フィールドを手動で削除することもできます。

ステータスラインをステップバイステップで構築する

このチュートリアルでは、現在のモデル、作業ディレクトリ、コンテキストウィンドウ使用状況の割合を表示するステータスラインを手動で作成することで、内部で何が起こっているかを示します。

これらの例では Bash スクリプトを使用しており、macOS と Linux で動作します。Windows では、Windows 設定 で PowerShell と Git Bash の例を参照してください。

モデル名、ディレクトリ、コンテキスト割合を表示するステータスライン
1

JSON を読み取り、出力を出力するスクリプトを作成する

Claude Code は stdin 経由でスクリプトに JSON データを送信します。このスクリプトは jq（コマンドラインの JSON パーサーで、インストールが必要な場合があります）を使用して、モデル名、ディレクトリ、コンテキスト割合を抽出し、フォーマットされた行を出力します。

これを ~/.claude/statusline.sh に保存します（~ はホームディレクトリ、macOS では /Users/username、Linux では /home/username など）：

#!/bin/bash
# Claude Code が stdin に送信する JSON データを読み取る
input=$(cat)

# jq を使用してフィールドを抽出する
MODEL=$(echo "$input" | jq -r '.model.display_name')
DIR=$(echo "$input" | jq -r '.workspace.current_dir')
# "// 0" はフィールドが null の場合のフォールバックを提供します
PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)

# ステータスラインを出力します - ${DIR##*/} はフォルダ名のみを抽出します
echo "[$MODEL] 📁 ${DIR##*/} | ${PCT}% context"
2

実行可能にする

スクリプトを実行可能にマークして、シェルが実行できるようにします：

chmod +x ~/.claude/statusline.sh
3

設定に追加する

Claude Code にスクリプトをステータスラインとして実行するよう指示します。この設定を ~/.claude/settings.json に追加します。これは type を "command"（「このシェルコマンドを実行する」という意味）に設定し、command をスクリプトに指定します：

{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh"
}
}

ステータスラインはインターフェイスの下部に表示されます。Claude Code は設定を自動的に再読み込みし、ファイルを保存するとすぐにスクリプトを実行します。

ステータスラインの仕組み

Claude Code はスクリプトを実行し、stdin 経由で JSON セッションデータ をパイプします。スクリプトが stdout に出力したものを Claude Code が表示します。

更新のタイミング

スクリプトはセッション開始時（再開時を含む）に 1 回実行されます。その後、以下の場合に再度実行されます：

  • 新しいアシスタントメッセージが到着したとき
  • /compact が完了したとき
  • パーミッション権限モードが変更されたとき
  • Vim モードが切り替わったとき
  • statusLine 設定で command を変更したとき
  • refreshInterval タイマーが経過したとき（設定した場合）
  • スクリプトが最後に受け取ったデータ内の レート制限ウィンドウ が resets_at 時刻に到達したとき
  • スクリプトが最後に受け取ったデータ内のウォーム プロンプトキャッシュ が expires_at 時刻に到達したとき

Claude Code は更新を 300ms でデバウンスするため、急速な変更がバッチ処理され、スクリプトは変更が停止した後に 1 回実行されます。command 自体への変更はデバウンスをスキップします。Claude Code は新しいコマンドをすぐに実行します。スクリプトがまだ実行中に新しい更新がトリガーされた場合、Claude Code は実行中のスクリプトをキャンセルします。スクリプトを編集した場合、変更は更新トリガーが次に実行されるときに表示されます。

イベント駆動型トリガーは、メインセッションがアイドル状態の場合（例えば、コーディネーターがバックグラウンドサブエージェントを待機している場合）、静かになる可能性があります。アイドル期間中に時間ベースまたは外部ソースのセグメントを最新に保つには、refreshInterval を設定して、固定タイマーでもコマンドを再実行します。

スクリプトが出力できるもの

  • 複数行：各 echo または print ステートメントは別の行として表示されます。複数行の例 を参照してください。
  • 色：\033[32m のような ANSI エスケープコード を使用して緑色を表示します（ターミナルがサポートしている必要があります）。git ステータスの例 を参照してください。
  • リンク：OSC 8 エスケープシーケンス を使用してテキストをクリック可能にします（macOS では Cmd+クリック、Windows/Linux では Ctrl+クリック）。iTerm2、Kitty、WezTerm などのハイパーリンクをサポートするターミナルが必要です。クリック可能なリンクの例 を参照してください。

ターミナルに出力をサイズ調整する

Claude Code はスクリプトの出力をキャプチャするため、ターミナルに直接接続しません。そのため、tput cols と言語レベルの幅検出はスクリプト内からターミナルサイズを読み取ることができません。代わりに COLUMNS および LINES 環境変数を読み取ってください。Claude Code はスクリプトを実行する前に、これらを現在のターミナルサイズに設定します。

利用可能なデータ

Claude Code は以下の JSON フィールドを stdin 経由でスクリプトに送信します：

フィールド 説明
model.id、model.display_name 現在のモデル識別子と表示名
cwd、workspace.current_dir 現在の作業ディレクトリ。両方のフィールドに同じ値が含まれます。workspace.current_dir は workspace.project_dir との一貫性のために推奨されます。
workspace.project_dir Claude Code が起動されたディレクトリ。セッション中に作業ディレクトリが変更された場合、cwd と異なる場合があります
workspace.added_dirs /add-dir または --add-dir 経由で追加された追加ディレクトリ。追加されていない場合は空配列
workspace.git_worktree 現在のディレクトリが git worktree add で作成されたリンク worktree 内にある場合の git worktree 名。メイン作業ツリーでは不在。worktree.* が worktree セッション 中のみに存在するのとは異なり、任意の git worktree に対して入力されます
workspace.repo.host、workspace.repo.owner、workspace.repo.name origin リモートから解析されたリポジトリ ID。例えば "github.com"、"anthropics"、"claude-code"。git リポジトリの外部または origin リモートが設定されていない場合は不在。gitlab.com プロジェクトがサブグループにネストされている場合、owner は "group/subgroup" のようなスラッシュ付きの完全な名前空間パスです。v2.1.260 より前は、これらのプロジェクトでは workspace.repo が不在でした
cost.total_cost_usd USD でのセッションの推定コスト。クライアント側で計算されます。modelPricing テーブルが有効な場合を除き、定価で計算されます。実際の請求額と異なる場合があります。/clear で新しいセッションが開始されると $0 にリセットされます。v2.1.211 より前は、/clear の後も合計が引き継がれていました
cost.total_duration_ms セッション開始からの総経過時間（ミリ秒）
cost.total_api_duration_ms API レスポンスを待つのに費やされた総時間（ミリ秒）
cost.total_lines_added、cost.total_lines_removed 変更されたコード行
context_window.total_input_tokens、context_window.total_output_tokens コンテキストウィンドウに現在あるトークン数。最新の API レスポンスから取得。入力にはキャッシュ読み取りと書き込みが含まれます
context_window.context_window_size トークン単位の最大コンテキストウィンドウサイズ。デフォルトは 200000、拡張コンテキストを持つモデルの場合は 1000000
context_window.used_percentage 事前計算されたコンテキストウィンドウ使用割合
context_window.remaining_percentage 事前計算されたコンテキストウィンドウ残り割合
context_window.current_usage 最後の API 呼び出しからのトークン数。コンテキストウィンドウフィールド で説明されています
exceeds_200k_tokens 最新の API レスポンスからの総トークン数（入力、キャッシュ、出力トークンの組み合わせ）が 200k を超えるかどうか。これは実際のコンテキストウィンドウサイズに関係なく固定閾値です。
fast_mode セッションで fast mode が有効になっているかどうか
effort.level 現在の推論努力レベル（low、medium、high、xhigh、または max）。ライブセッション値を反映しており、セッション中の /effort 変更を含みます。Ultracode は個別のレベルではなく、xhigh として報告されます。現在のモデルが effort パラメータをサポートしていない場合は不在
thinking.enabled セッションで拡張思考が有効になっているかどうか
rate_limits.five_hour.used_percentage、rate_limits.seven_day.used_percentage 5 時間または 7 日のレート制限の消費割合（0～100）
rate_limits.five_hour.resets_at、rate_limits.seven_day.resets_at 5 時間または 7 日のレート制限ウィンドウがリセットされる Unix エポック秒
rate_limits.spend_limit.used_percentage、rate_limits.spend_limit.resets_at Claude apps gateway の背後にある場合、あなたに適用される支出制限の使用割合、およびその期間がリセットされる Unix エポック秒。割合は 0～100 の範囲、または制限を超えると 100 以上になります。Claude Code v2.1.251 以降が必要です
prompt_cache メイン会話の prompt cache 統計情報：ヒット率、ミス数、キャッシュがウォーム状態かどうか。すべてのフィールドについては prompt cache フィールド を参照してください。メイン会話の最初の API レスポンスまで不在。Claude Code v2.1.251 以降が必要です
session_id 一意のセッション識別子
session_name セッション名。--name フラグまたは /rename で設定されたカスタム名が存在する場合はそれを使用し、そうでない場合は AI が生成したセッションタイトルを使用します。デフォルト表示名（my-app-3f など）はこのフィールドに入力されません。セッションにカスタム名も AI が生成したタイトルもない場合は不在
prompt_id 現在処理中のユーザープロンプトを識別する UUID。OpenTelemetry イベントの prompt.id 属性 と一致します。最初のユーザー入力まで不在。Claude Code v2.1.196 以降が必要です
transcript_path 会話トランスクリプトファイルへのパス
version Claude Code バージョン
output_style.name 現在の出力スタイルの名前
vim.mode vim モード が有効な場合の現在の vim モード（NORMAL、INSERT、VISUAL、または VISUAL LINE）
agent.name --agent フラグまたはエージェント設定が設定されている場合のエージェント名
pr.number、pr.url 現在のブランチのオープンプルリクエスト。フッターの PR バッジをミラーします。リポジトリに GitLab リモートがある場合、Claude Code はこれらのフィールドをブランチのオープン merge request から代わりに入力するため、pr.number はマージリクエスト番号です。マージリクエストデータには Claude Code v2.1.234 以降が必要です。git リポジトリにない場合、プルリクエストまたはマージリクエストが見つかるまで、またはマージもしくはクローズされた後は不在
pr.review_state オープン PR のレビューステータス：approved、pending、changes_requested、または draft。pr が存在する場合でも独立して不在の可能性があります
pr.kind GitLab merge request を説明する場合は mr。GitHub プルリクエストでは不在なため、このフィールドの前に書かれたスクリプトは引き続き機能します。マージリクエストの場合、Claude Code は GitLab がマージ可能と報告した場合は review_state を approved に、その他のオープン状態の場合は pending に、ドラフトの場合は draft に設定します。Claude Code v2.1.234 以降が必要です
worktree.name アクティブな worktree の名前。worktree セッション 中のみ存在
worktree.path worktree ディレクトリへの絶対パス
worktree.branch worktree の git ブランチ名（例："worktree-my-feature"）。フックベースの worktree では不在
worktree.original_cwd worktree に入る前に Claude がいたディレクトリ
worktree.original_branch worktree に入る前にチェックアウトされた git ブランチ。フックベースの worktree では不在
完全な JSON スキーマ

ステータスラインコマンドは stdin 経由でこの JSON 構造を受け取ります：

{
"cwd": "/current/working/directory",
"session_id": "abc123...",
"session_name": "my-session",
"prompt_id": "550e8400-e29b-41d4-a716-446655440000",
"transcript_path": "/path/to/transcript.jsonl",
"model": {
"id": "claude-opus-5",
"display_name": "Opus"
},
"workspace": {
"current_dir": "/current/working/directory",
"project_dir": "/original/project/directory",
"added_dirs": [],
"git_worktree": "feature-xyz",
"repo": {
"host": "github.com",
"owner": "anthropics",
"name": "claude-code"
}
},
"version": "2.1.90",
"output_style": {
"name": "default"
},
"cost": {
"total_cost_usd": 0.01234,
"total_duration_ms": 45000,
"total_api_duration_ms": 2300,
"total_lines_added": 156,
"total_lines_removed": 23
},
"context_window": {
"total_input_tokens": 15500,
"total_output_tokens": 1200,
"context_window_size": 200000,
"used_percentage": 8,
"remaining_percentage": 92,
"current_usage": {
"input_tokens": 8500,
"output_tokens": 1200,
"cache_creation_input_tokens": 5000,
"cache_read_input_tokens": 2000
}
},
"exceeds_200k_tokens": false,
"prompt_cache": {
"warm": true,
"caching_observed": true,
"ttl": "1h",
"expires_at": 1738429200,
"requests": 14,
"misses": 2,
"expected_rebuilds": 1,
"hit_ratio": 0.91,
"cache_write_tokens": 352000,
"miss_recache_tokens": 310200,
"last_miss_at": 1738425230,
"last_miss_cause": {
"causes": ["tools_changed"],
"tools_added": 2,
"tools_removed": 0
},
"miss_causes": {
"tools_changed": 2
},
"recache_tokens_if_cold": 45000
},
"fast_mode": false,
"effort": {
"level": "high"
},
"thinking": {
"enabled": true
},
"rate_limits": {
"five_hour": {
"used_percentage": 23.5,
"resets_at": 1738425600
},
"seven_day": {
"used_percentage": 41.2,
"resets_at": 1738857600
},
"spend_limit": {
"used_percentage": 62.8,
"resets_at": 1740787200
}
},
"vim": {
"mode": "NORMAL"
},
"agent": {
"name": "security-reviewer"
},
"pr": {
"number": 1234,
"url": "https://github.com/anthropics/claude-code/pull/1234",
"review_state": "pending"
},
"worktree": {
"name": "my-feature",
"path": "/path/to/.claude/worktrees/my-feature",
"branch": "worktree-my-feature",
"original_cwd": "/path/to/project",
"original_branch": "main"
}
}

不在の可能性があるフィールド（JSON に存在しない）：

  • session_name：--name または /rename でカスタム名が設定されている場合、または AI が生成したセッションタイトルが存在する場合に表示されます。my-app-3f などのデフォルト表示名はこのフィールドに入力されません
  • prompt_id：最初のユーザー入力の後のみ表示
  • workspace.git_worktree：現在のディレクトリがリンク git worktree 内にある場合のみ表示
  • workspace.repo：git リポジトリ内で origin リモートが設定されている場合のみ表示
  • effort：現在のモデルが推論努力パラメータをサポートしている場合のみ表示
  • vim：vim モードが有効な場合のみ表示
  • agent：--agent フラグまたはエージェント設定が設定されている場合のみ表示
  • pr：現在のブランチのオープン PR または GitLab マージリクエストが見つかった場合のみ表示。PR またはマージリクエストがマージまたはクローズされると削除されます。pr.review_state と pr.kind は独立して不在の可能性があります
  • worktree：worktree セッション 中のみ表示。存在する場合、branch と original_branch もフックベースの worktree では不在の可能性があります
  • rate_limits：Claude.ai Pro および Max サブスクライバー、または支出制限を設定する Claude apps gateway の背後にある場合のみ表示。セッションの最初の API レスポンスの後のみ表示。各ウィンドウ（five_hour、seven_day、spend_limit）は独立して不在の可能性があり、Claude Code は resets_at 時刻が経過するとウィンドウを削除します。jq -r '.rate_limits.five_hour.used_percentage // empty' を使用して、不在を適切に処理します。
  • prompt_cache：メイン会話の最初の API レスポンスの後に表示。prompt cache フィールド を参照してください

null の可能性があるフィールド：

  • context_window.current_usage：セッションの最初の API 呼び出しの前は null。また /compact の直後は次の API 呼び出しが再度入力されるまで null
  • context_window.used_percentage、context_window.remaining_percentage：セッションの早期段階では null の可能性があります

スクリプトで条件付きアクセスと null 値のフォールバックデフォルトを使用して、不在のフィールドを処理します。

コンテキストウィンドウフィールド

context_window オブジェクトは、最新の API レスポンスからのライブコンテキストウィンドウを説明します。

  • 結合合計（total_input_tokens、total_output_tokens）：コンテキストウィンドウに現在あるトークン。total_input_tokens は input_tokens、cache_creation_input_tokens、および cache_read_input_tokens の合計です。total_output_tokens は最新レスポンスからの出力トークンです。両方とも最初の API レスポンスの前は 0 です。
  • コンポーネント別使用状況（current_usage）：カテゴリ別に分類された同じトークン数。キャッシュヒットを新規入力から分離する必要がある場合に使用します。

current_usage オブジェクトには以下が含まれます：

  • input_tokens：現在のコンテキストの入力トークン
  • output_tokens：生成された出力トークン
  • cache_creation_input_tokens：キャッシュに書き込まれたトークン
  • cache_read_input_tokens：キャッシュから読み取られたトークン

キャッシュフィールドの意味とそれらがどのように請求されるかについては、キャッシュパフォーマンスの確認 を参照してください。

used_percentage フィールドは入力トークンのみから計算されます：input_tokens + cache_creation_input_tokens + cache_read_input_tokens。output_tokens は含まれません。

current_usage から手動でコンテキスト割合を計算する場合、used_percentage と一致させるために同じ入力のみの式を使用します。

current_usage オブジェクトはセッションの最初の API 呼び出しの前は null です。また /compact の直後は null であり、次の API 呼び出しが再度入力されるまで null のままです。

Prompt cache フィールド

prompt_cache オブジェクトは、セッションのメイン会話が prompt cache をどのように使用しているかを要約します。Claude Code は API のレスポンスのキャッシュトークン数から計算するため、すべてのプロバイダーで機能します。

オブジェクトはメイン会話の最初の API レスポンスの後に表示されます。Claude Code はこれらの統計情報でサブエージェントリクエストをカウントしません。Claude Code v2.1.251 以降が必要です。

テーブルは各フィールドとその意味を示しています。タイムスタンプは Unix エポック秒で、rate_limits.*.resets_at と同じ単位です。短いステータスラインは通常、これらの 1 つまたは 2 つを表示します。warm と hit_ratio はキャッシュ状態を最も直接的に要約します。

フィールド 説明
warm キャッシュされたプレフィックスがまだ TTL 内にあるかどうか。最後のレスポンスがキャッシュトークンを報告しなかった場合は false。caching_observed が true の場合でも
caching_observed このセッションのレスポンスがキャッシュトークンを報告したかどうか。false は prompt caching がオフ、またはプロバイダーまたはゲートウェイがそれを報告しないことを意味します
ttl 現在のキャッシュされたプレフィックスの キャッシュライフタイム："5m" または "1h"
expires_at キャッシュされたプレフィックスが TTL を離れてコールドになる時刻（エポック秒）。最後のレスポンスがキャッシュトークンを報告しなかった場合は null
requests このセッションのメイン会話で記録された API リクエスト
misses キャッシュが既に保持していたコンテンツを再処理したリクエスト：キャッシュが読み取ることができた 5% 以上かつ少なくとも 2,000 トークン。コンパクション またはツール結果のクリアで不足を説明できない場合
expected_rebuilds コンパクションまたは古いツール結果のクリアに続いたキャッシュリビルド
hit_ratio キャッシュ読み取りトークンをこのセッションのすべての入力トークンの分数として表したもの。0～1 の範囲。分母はキャッシュ読み取り、キャッシュ書き込み、およびキャッシュされていない入力をカウントします。これらのカウントがすべてゼロの場合は null
cache_write_tokens このセッション中にキャッシュに書き込まれたすべてのトークン。最初のリクエストの初期書き込みを含む
miss_recache_tokens ミスとしてカウントされたリクエストによってキャッシュに書き込まれたトークン
last_miss_at 最後のミスが発生した時刻（エポック秒）。セッションにミスがない場合は null
last_miss_cause Claude Code が最後のミスの可能な原因として特定したもの。最後のミスの原因 で説明されています。Claude Code v2.1.260 以降が必要です
miss_causes このセッションの診断されたミスのうち、各原因を持つ数。last_miss_cause と同じ原因名でキー付けされています。Claude Code v2.1.260 以降が必要です
recache_tokens_if_cold キャッシュがそれまでにコールドになった場合、次のリクエストが再キャッシュするトークン。コンパクションまたは古いツール結果のクリアの直後は null。次のリクエストが書き直された会話のサイズを記録するまで null のままです

Claude Code はターミナルで同じ統計情報を表示します。/usage コマンドの Prompt cache (main) 行 を参照してください。

最後のミスの原因

last_miss_cause オブジェクトは、Claude Code が最新のミスの可能な原因として特定したものを報告します。その causes 配列は tools_changed、system_prompt_changed、ttl_expired_5m、または likely_server_side などの 1 つ以上の原因名を保持します。オブジェクトはセッションの最初のミスまで null であり、Claude Code が最新のミスの原因を特定できなかった場合は再び null になります。Claude Code v2.1.260 以降が必要です。

2 つの原因はオブジェクトにカウントを追加します：

  • tools_added と tools_removed：tools_changed を使用して、リクエストに追加または削除されたツールの数
  • system_char_delta：system_prompt_changed を使用して、システムプロンプトの長さの変化（文字数）

例

これらの例は一般的なステータスラインパターンを示しています。任意の例を使用するには：

  1. スクリプトを ~/.claude/statusline.sh（または .py/.js）などのファイルに保存します
  2. 実行可能にします：chmod +x ~/.claude/statusline.sh
  3. 設定 にパスを追加します

Bash の例は jq を使用して JSON を解析します。Python と Node.js には組み込みの JSON 解析があります。

コンテキストウィンドウの使用状況

現在のモデルとコンテキストウィンドウの使用状況を視覚的なプログレスバーで表示します。各スクリプトは stdin から JSON を読み取り、used_percentage フィールドを抽出し、塗りつぶされたブロック（▓）が使用状況を表す 10 文字のバーを構築します：

モデル名とパーセンテージ付きプログレスバーを表示するステータスライン 
#!/bin/bash
# stdin 全体を変数に読み込む
input=$(cat)

# jq でフィールドを抽出します。"// 0" は null のフォールバックを提供します
MODEL=$(echo "$input" | jq -r '.model.display_name')
PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)

# プログレスバーを構築します：printf -v はスペースを作成し、
# ${var// /▓} は各スペースをブロック文字に置き換えます
BAR_WIDTH=10
FILLED=$((PCT * BAR_WIDTH / 100))
EMPTY=$((BAR_WIDTH - FILLED))
BAR=""
[ "$FILLED" -gt 0 ] && printf -v FILL "%${FILLED}s" && BAR="${FILL// /▓}"
[ "$EMPTY" -gt 0 ] && printf -v PAD "%${EMPTY}s" && BAR="${BAR}${PAD// /░}"

echo "[$MODEL] $BAR $PCT%"

git ステータスと色

ステージングされたファイルと変更されたファイルのカラーコード化されたインジケーターを使用して git ブランチを表示します。このスクリプトはターミナルの色に ANSI エスケープコード を使用します：\033[32m は緑、\033[33m は黄、\033[0m はデフォルトにリセットします。

モデル、ディレクトリ、git ブランチ、ステージングされたファイルと変更されたファイルのカラーコード化されたインジケーターを表示するステータスライン

各スクリプトは現在のディレクトリが git リポジトリであるかどうかを確認し、ステージングされたファイルと変更されたファイルをカウントし、カラーコード化されたインジケーターを表示します：

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
DIR=$(echo "$input" | jq -r '.workspace.current_dir')

GREEN='\033[32m'
YELLOW='\033[33m'
RESET='\033[0m'

if git rev-parse --git-dir > /dev/null 2>&1; then
BRANCH=$(git branch --show-current 2>/dev/null)
STAGED=$(git diff --cached --numstat 2>/dev/null | wc -l | tr -d ' ')
MODIFIED=$(git diff --numstat 2>/dev/null | wc -l | tr -d ' ')

GIT_STATUS=""
[ "$STAGED" -gt 0 ] && GIT_STATUS="${GREEN}+${STAGED}${RESET}"
[ "$MODIFIED" -gt 0 ] && GIT_STATUS="${GIT_STATUS}${YELLOW}~${MODIFIED}${RESET}"

echo -e "[$MODEL] 📁 ${DIR##*/} | 🌿 $BRANCH $GIT_STATUS"
else
echo "[$MODEL] 📁 ${DIR##*/}"
fi

コストと期間の追跡

セッションの API コストと経過時間を追跡します。cost.total_cost_usd フィールドは現在のセッションのすべての API 呼び出しの推定コストを累積します。cost.total_duration_ms フィールドはセッション開始からの総経過時間を測定し、cost.total_api_duration_ms は API レスポンスを待つのに費やされた時間のみを追跡します。

各スクリプトはコストを通貨としてフォーマットし、ミリ秒を分と秒に変換します：

モデル名、セッションコスト、期間を表示するステータスライン 
#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
COST=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
DURATION_MS=$(echo "$input" | jq -r '.cost.total_duration_ms // 0')

COST_FMT=$(printf '$%.2f' "$COST")
DURATION_SEC=$((DURATION_MS / 1000))
MINS=$((DURATION_SEC / 60))
SECS=$((DURATION_SEC % 60))

echo "[$MODEL] 💰 $COST_FMT | ⏱️ ${MINS}m ${SECS}s"

複数行を表示する

スクリプトは複数の行を出力して、より豊かなディスプレイを作成できます。

最初の行にモデル名、ディレクトリ、git ブランチを表示し、2 番目の行にコンテキスト使用状況プログレスバー、コスト、期間を表示する複数行ステータスライン

この例は複数のテクニックを組み合わせています：閾値ベースの色（70% 未満は緑、70～89% は黄、90% 以上は赤）、プログレスバー、git ブランチ情報。各 print または echo ステートメントは別の行を作成します：

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
DIR=$(echo "$input" | jq -r '.workspace.current_dir')
COST=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)
DURATION_MS=$(echo "$input" | jq -r '.cost.total_duration_ms // 0')

CYAN='\033[36m'; GREEN='\033[32m'; YELLOW='\033[33m'; RED='\033[31m'; RESET='\033[0m'

# コンテキスト使用状況に基づいてバーの色を選択します
if [ "$PCT" -ge 90 ]; then BAR_COLOR="$RED"
elif [ "$PCT" -ge 70 ]; then BAR_COLOR="$YELLOW"
else BAR_COLOR="$GREEN"; fi

FILLED=$((PCT / 10)); EMPTY=$((10 - FILLED))
printf -v FILL "%${FILLED}s"; printf -v PAD "%${EMPTY}s"
BAR="${FILL// /█}${PAD// /░}"

MINS=$((DURATION_MS / 60000)); SECS=$(((DURATION_MS % 60000) / 1000))

BRANCH=""
git rev-parse --git-dir > /dev/null 2>&1 && BRANCH=" | 🌿 $(git branch --show-current 2>/dev/null)"

echo -e "${CYAN}[$MODEL]${RESET} 📁 ${DIR##*/}$BRANCH"
COST_FMT=$(printf '$%.2f' "$COST")
echo -e "${BAR_COLOR}${BAR}${RESET} ${PCT}% | ${YELLOW}${COST_FMT}${RESET} | ⏱️ ${MINS}m ${SECS}s"

この例は GitHub リポジトリへのクリック可能なリンクを作成します。Cmd（macOS）または Ctrl（Windows/Linux）を押しながらクリックして、ブラウザでリンクを開きます。

GitHub リポジトリへのクリック可能なリンクを表示するステータスライン

各スクリプトは git リモート URL を取得し、SSH 形式を HTTPS に変換し、リポジトリ名を OSC 8 エスケープコードでラップします。Bash バージョンは printf '%b' を使用します。これはバックスラッシュエスケープを異なるシェル間でより確実に解釈します：

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')

# git SSH URL を HTTPS に変換します
REMOTE=$(git remote get-url origin 2>/dev/null | sed 's/git@github.com:/https:\/\/github.com\//' | sed 's/\.git$//')

if [ -n "$REMOTE" ]; then
REPO_NAME=$(basename "$REMOTE")
# OSC 8 形式：\e]8;;URL\a その後 TEXT その後 \e]8;;\a
# printf %b はシェル間でエスケープシーケンスを確実に解釈します
printf '%b' "[$MODEL] 🔗 \e]8;;${REMOTE}\a${REPO_NAME}\e]8;;\a\n"
else
echo "[$MODEL]"
fi

レート制限の使用状況

Claude.ai サブスクリプションのレート制限使用状況をステータスラインに表示します。rate_limits オブジェクトには、ローリング five_hour ウィンドウと週間 seven_day ウィンドウが含まれます。各ウィンドウは used_percentage（0～100）とウィンドウがリセットされる Unix エポック秒の resets_at を提供します。

Claude アプリゲートウェイの背後にある支出制限を使用する場合、rate_limits は支出制限に対して同じ 2 つのフィールドを持つ spend_limit を含みます。ただし、その used_percentage は制限を超えると 100 を超える可能性があります。Claude Code v2.1.251 以降が必要です。

rate_limits オブジェクトは Claude.ai Pro および Max サブスクライバー、または支出制限を持つ Claude アプリゲートウェイの背後にある場合のみ存在し、最初の API レスポンスの後のみです。各スクリプトは不在のフィールドを適切に処理します：

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
# "// empty" は rate_limits が不在の場合、出力を生成しません
FIVE_H=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
WEEK=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')

LIMITS=""
[ -n "$FIVE_H" ] && LIMITS="5h: $(printf '%.0f' "$FIVE_H")%"
[ -n "$WEEK" ] && LIMITS="${LIMITS:+$LIMITS }7d: $(printf '%.0f' "$WEEK")%"

[ -n "$LIMITS" ] && echo "[$MODEL] | $LIMITS" || echo "[$MODEL]"

高コストな操作をキャッシュする

ステータスラインスクリプトはアクティブなセッション中に頻繁に実行されます。git status や git diff などのコマンドは、特に大規模なリポジトリでは遅い場合があります。この例は git 情報を一時ファイルにキャッシュし、5 秒ごとにのみ更新します。

キャッシュファイル名は、セッション内のステータスラインの呼び出し間で安定している必要がありますが、異なるリポジトリの同時セッションが互いのキャッシュされた git 状態を読み取らないように、セッション間で一意である必要があります。$$、os.getpid()、process.pid のようなプロセスベースの識別子は、呼び出しのたびに変わり、キャッシュを無効にします。代わりに JSON 入力から session_id を使用します：これはセッションの有効期間中は安定しており、セッションごとに一意です。

各スクリプトは git コマンドを実行する前に、キャッシュファイルが不在であるか 5 秒より古いかを確認します：

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
DIR=$(echo "$input" | jq -r '.workspace.current_dir')
SESSION_ID=$(echo "$input" | jq -r '.session_id')

CACHE_FILE="/tmp/statusline-git-cache-$SESSION_ID"
CACHE_MAX_AGE=5  # 秒

cache_is_stale() {
[ ! -f "$CACHE_FILE" ] || \
# stat -c %Y（Linux）または stat -f %m（macOS）はファイルの最終更新時刻を出力します。
# Linux フォームは最初に実行する必要があります：Linux では、macOS フォームは stdout にファイルシステムレポートを出力してから失敗し、その出力はコマンド置換によってキャプチャされ、算術を破壊します。
[ $(($(date +%s) - $(stat -c %Y "$CACHE_FILE" 2>/dev/null || stat -f %m "$CACHE_FILE" 2>/dev/null || echo 0))) -gt $CACHE_MAX_AGE ]
}

if cache_is_stale; then
if git rev-parse --git-dir > /dev/null 2>&1; then
BRANCH=$(git branch --show-current 2>/dev/null)
STAGED=$(git diff --cached --numstat 2>/dev/null | wc -l | tr -d ' ')
MODIFIED=$(git diff --numstat 2>/dev/null | wc -l | tr -d ' ')
echo "$BRANCH|$STAGED|$MODIFIED" > "$CACHE_FILE"
else
echo "||" > "$CACHE_FILE"
fi
fi

IFS='|' read -r BRANCH STAGED MODIFIED < "$CACHE_FILE"

if [ -n "$BRANCH" ]; then
echo "[$MODEL] 📁 ${DIR##*/} | 🌿 $BRANCH +$STAGED ~$MODIFIED"
else
echo "[$MODEL] 📁 ${DIR##*/}"
fi

Windows 設定

Windows では、Claude Code はステータスラインコマンドを Git Bash 経由で実行します。Git Bash がインストールされている場合、または Git Bash がない場合は PowerShell を通じて実行します。

Git Bash は引用符なしのバックスラッシュをエスケープ文字として扱うため、C:\Users\username\script.mjs のような Windows スタイルのパスはセパレーターが削除された状態でスクリプトランナーに到達し、目に見えるエラーなしでコマンドが失敗します。command 文字列のファイルパスを以下の例に示すようにフォワードスラッシュで記述します。~ 短縮形も機能し、Windows ホームディレクトリに展開されます。

PowerShell スクリプトをステータスラインとして実行するには、powershell 経由で呼び出します。これは Claude Code がコマンドを Git Bash または PowerShell を通じてルーティングするかどうかに関わらず機能します：

{
"statusLine": {
"type": "command",
"command": "powershell -NoProfile -File C:/Users/username/.claude/statusline.ps1"
}
}

または、Git Bash がインストールされている場合は、Bash スクリプトを直接実行します：

{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh"
}
}

サブエージェントステータスライン

subagentStatusLine 設定は、エージェントパネルに表示される各 サブエージェント のカスタム行本体をレンダリングします。デフォルトの name · description · token count 行を独自のフォーマットに置き換えるために使用します。

{
  "subagentStatusLine": {
    "type": "command",
    "command": "~/.claude/subagent-statusline.sh"
  }
}

コマンドは、すべての表示されているサブエージェント行が stdin で単一の JSON オブジェクトとして渡される各リフレッシュティックで実行されます。入力には 基本フックフィールド、使用可能な行幅を示す columns フィールド、および tasks 配列が含まれます。各タスクには id、name、type、status、description、label、startTime、model、effort、contextWindowSize、tokenCount、tokenSamples、cwd があります。

タスクごとの model フィールドは、タスクが実行される解決済みモデル ID です。contextWindowSize はそのモデルのコンテキストウィンドウ（トークン単位）で、メインステータスラインの context_window.context_window_size と同じ方法で計算されるため、tokenCount から行ごとのパーセンテージをレンダリングできます。両方のフィールドには Claude Code v2.1.205 以降が必要で、モデルがまだ解決されていないタスクでは省略されます。

タスクごとの effort フィールドは、そのサブエージェントに設定された推論努力で、その 定義フロントマター または個別の呼び出しで設定されます。値は、努力レベル文字列 low、medium、high、xhigh、max のいずれか、またはトークン予算の数値です。フィールドは、記述されたとおりに設定された値を報告します。モデルがそのレベルをサポートしていない場合、Claude Code が実際に適用する努力は異なる可能性があります。フィールドには Claude Code v2.1.214 以降が必要で、サブエージェントがセッションの努力レベルを継承する場合は存在しません。

オーバーライドしたい各行に対して stdout に 1 つの JSON 行を書き込みます。形式は {"id": "<task id>", "content": "<row body>"} です。content 文字列はそのままレンダリングされます。ANSI 色と OSC 8 ハイパーリンクを含みます。タスクの id を省略して、その行のデフォルトレンダリングを保持します。空の content 文字列を出力して、その行を非表示にします。

statusLine に適用される同じトラストと disableAllHooks および allowManagedHooksOnly ゲートが subagentStatusLine に適用されます。プラグインは、settings.json でデフォルトの subagentStatusLine を配布できます。ただし、フックとは異なり、プラグインが管理設定で強制的に有効化されている場合でも、プラグイン値は allowManagedHooksOnly の下で実行されません。

ヒント

  • モック入力でテストする：echo '{"model":{"display_name":"Opus"},"workspace":{"current_dir":"/home/user/project"},"context_window":{"used_percentage":25},"session_id":"test-session-abc"}' | ./statusline.sh
  • 出力を短く保つ：ステータスバーの幅は限られているため、長い出力は切り詰められたり、不適切にラップされたりする可能性があります
  • 遅い操作をキャッシュする：スクリプトはアクティブなセッション中に頻繁に実行されるため、git status などのコマンドは遅延を引き起こす可能性があります。これを処理する方法については、キャッシング例 を参照してください。

ccstatusline や starship-claude などのコミュニティプロジェクトは、テーマと追加機能を備えた事前構築設定を提供します。

トラブルシューティング

ステータスラインが表示されない

  • スクリプトが実行可能であることを確認します：chmod +x ~/.claude/statusline.sh
  • スクリプトが stdout に出力し、stderr に出力していないことを確認します
  • スクリプトを手動で実行して、出力を生成することを確認します
  • Windows で Git Bash がインストールされている場合、command パスのバックスラッシュはスクリプトが実行される前にエスケープ文字として消費される可能性があります。パスでは前方スラッシュを使用してください。Windows 設定を参照してください。
  • 設定の優先順位が適用された後、disableAllHooks が管理設定外で true の場合、Claude Code は管理設定からの statusLine のみを実行し、管理 statusLine がない場合はステータスラインが無効になります。この設定を削除するか、それを設定するファイルで false に設定して、再度有効にします。disableAllHooksを参照してください。
  • 組織が管理設定で allowManagedHooksOnly を設定している場合、カスタムステータスラインは警告なく消えます：これらの管理設定の statusLine 値からのみステータスラインを取得できます。allowManagedHooksOnly で実行される内容を参照して完全な動作を確認し、この設定があなたに適用されるかどうかを管理者に確認してください。
  • claude --debug を実行して、セッションの最初のステータスラインの呼び出しからの終了コードと stderr をログに記録します
  • Claude にスクリプトファイルを読み取り、statusLine コマンドを直接実行するよう依頼して、エラーを表示します

ステータスラインが -- または空の値を表示する

  • フィールドは最初の API レスポンスが完了する前は null の可能性があります
  • スクリプトで // 0 のようなフォールバックを使用して null 値を処理します
  • 複数のメッセージの後も値が空のままの場合は、Claude Code を再起動します

コンテキスト割合が予期しない値を表示する

  • 最も単純で正確なコンテキスト状態には used_percentage を使用します
  • コンテキスト割合は /context 出力と異なる場合があります。これは各が計算されるタイミングが異なるためです

OSC 8 リンクがクリック可能でない

  • ターミナルが OSC 8 ハイパーリンクをサポートしていることを確認します（iTerm2、Kitty、WezTerm）

  • Terminal.app はクリック可能なリンクをサポートしていません

  • リンクテキストが表示されているがクリック可能でない場合、Claude Code がターミナルのハイパーリンクサポートを検出できていない可能性があります。Claude Code を起動する前に FORCE_HYPERLINK 環境変数を設定して、検出をオーバーライドします：

    FORCE_HYPERLINK=1 claude

    PowerShell では、最初に現在のセッションで変数を設定します：

    $env:FORCE_HYPERLINK = "1"; claude

  • SSH と tmux セッションは設定に応じて OSC シーケンスをストリップする可能性があります

  • エスケープシーケンスが \e]8;; のようなリテラルテキストとして表示される場合は、echo -e の代わりに printf '%b' を使用して、より確実なエスケープ処理を行います

エスケープシーケンスでの表示の不具合

  • 複雑なエスケープシーケンス（ANSI 色、OSC 8 リンク）は、他の UI 更新と重複する場合、時々破損した出力を引き起こす可能性があります
  • 破損したテキストが表示される場合は、スクリプトをプレーンテキスト出力に簡略化してみてください
  • エスケープコード付きの複数行ステータスラインは、プレーンテキストの単一行よりもレンダリングの問題が発生しやすくなります

ワークスペーストラストが必要

  • statusLine はシェルコマンドを実行するため、Claude Code は設定ファイルのフックと同じワークスペーストラストルールの下で実行します。フォルダのダイアログを受け入れるか、その信頼がそれに拡張される親ディレクトリのダイアログを受け入れるだけで十分です。
  • それまでの間、ステータスラインは空白のままで、claude --debug は Status line command skipped: workspace trust not accepted をログに記録します。Claude Code を再起動し、トラストダイアログを受け入れて有効にします。

スクリプトエラーまたはハング

  • ゼロ以外のコードで終了するか、出力を生成しないスクリプトは、ステータスラインを空白にします
  • 遅いスクリプトは、完了するまでステータスラインの更新をブロックします。古い出力を避けるために、スクリプトを高速に保ちます。
  • 遅いスクリプトの実行中に新しい更新がトリガーされた場合、実行中のスクリプトはキャンセルされます
  • 設定する前に、モック入力を使用してスクリプトを独立してテストします

通知がステータスラインの行を共有する

フルスクリーンレンダリングの外では、Claude Code は通知をステータスラインと同じ行に表示します。フルスクリーンレンダリングでは、Claude Code は通知に独自の行を提供します。

  • MCP サーバーエラーおよび自動更新などのシステム通知は、ステータスラインと同じ行の右側に表示されます。コンテキスト低警告などの一時的な通知もこの領域を循環します。
  • 詳細モードを有効にすると、この領域にトークンカウンターが追加されます
  • 狭いターミナルでは、これらの通知がステータスラインの出力を切り詰める可能性があります