status line (ステータスライン)

設定したシェルスクリプトを実行し、stdin で受け取ったセッションの JSON データをもとに、スクリプトが出力した内容をそのまま表示します。コンテキストの使用量、コスト、git の状態など、追いかけたい情報を常に一目で見られる場所に置けます。status line はローカルで動作し、API のトークンを消費しません。

status line は、組み込みのフッターバッジの上に独立した行として表示され、バッジを置き換えません。一方で、独自の status line を設定すると、フッターのキーボードヒントの大半 (esc to interrupt、? for shortcuts、hold space to speak など) は表示されなくなります。

スクリプトはセッションの開始時 (再開時を含む) に 1 回実行され、その後は新しいアシスタントのメッセージ、/compact の完了、権限モードの変更、vim モードの切り替えなどのイベントで再び実行されます。更新は 300ms でデバウンスされ、短い間に続いた変化はまとめられ、変化が止まった後に 1 回だけ実行されます。スクリプトの出力が表示されるのは、スクリプトが終了コード 0 で終了した後です。

スクリプトには、セッションの情報が JSON で渡されます。主なものは次のとおりです。

• cost.total_cost_usd：USD 建ての推定セッションコストです。クライアント側で計算され、実際の請求額と異なる場合があります。
• context_window.used_percentage：コンテキストウィンドウの使用率です。入力トークン (input_tokens + cache_creation_input_tokens + cache_read_input_tokens) だけから計算し、output_tokens は含みません。
• prompt_cache：メインの会話がプロンプトキャッシュをどう使っているかをまとめたオブジェクトです。サブエージェントのリクエストは数えません。キャッシュミスの推定原因 (ツール定義やシステムプロンプトの変更、TTL を超えたアイドルなど) も含みます。
• workspace.git_worktree：現在のディレクトリがリンクされた git worktree 内にあるときに設定されます。
• effort.level と thinking.enabled：effort のレベルと thinking の有効・無効です。
• GitHub のリポジトリと PR の情報：検出された場合に含まれます。
• rate_limits.spend_limit：支出上限のある Claude apps ゲートウェイを利用する開発者向けのフィールドです。

statusLine の設定には、次の任意のフィールドがあります。

• padding：内容に左右の余白 (文字数) を加えます。既定値は 0 です。
• refreshInterval：イベントによる更新に加えて、N 秒ごとにコマンドを再実行します。最小値は 1 です。
• hideVimModeIndicator：プロンプトの下に出る組み込みの -- INSERT -- 表示を消します。

subagentStatusLine の設定を使うと、プロンプトの下のエージェントパネルに表示される各サブエージェントの行を、既定の name · description · token count から独自の表示に置き換えられます。ペイロードには推論の effort が含まれ、モデルと effort を表示できます。

スクリプトを書く代わりに、/statusline コマンドに表示したい内容を自然言語で指示する方法もあります (例：/statusline show model name and context percentage with a progress bar)。Claude Code が ~/.claude/ にスクリプトを生成し、設定を自動で更新します。途中でファイル編集の許可を求められた場合は承認します。無効にするときは、/statusline delete のように /statusline に削除を依頼するか、settings.json から statusLine フィールドを削除します。

Windows では、Git Bash がインストールされていれば Git Bash 経由で、無い場合は PowerShell 経由で status line のコマンドを実行します。

• status line はローカルで動作し、API のトークンを消費しません。
• ワークスペースの信頼ダイアログを承認するまで、status line は空白のままです。
• status line のコスト見積もりは、データレジデンシーのワークスペース向けの 1.1 倍の US-only 推論の割増を含みます。見積もりはクライアント側の計算で、実際の請求額と異なる場合があります。

ここでは、スクリプトを自分で作って設定する流れを示します。

1. stdin から JSON を読み取って出力するスクリプトを作成し、~/.claude/statusline.sh に保存します。
2. chmod +x ~/.claude/statusline.sh を実行し、スクリプトを実行可能にします。
3. ~/.claude/settings.json に statusLine の設定を追加し、type を "command" に、command を作成したスクリプトに向けます。
4. 設定ファイルを保存すると、Claude Code が設定を自動で再読み込みし、すぐにスクリプトを実行します。