ステータスラインとは何か
ドキュメントでは、次の一文で説明されています。「ステータスラインは、Claude Code の下部にあるカスタマイズ可能なバーで、設定した任意のシェルスクリプトを実行します。stdin で JSON セッションデータを受け取り、スクリプトがプリントした内容を表示します」。
利用される主な理由は以下の通りです:
- 「作業中にコンテキストウィンドウの使用状況を監視する」。
- 「セッションコストを追跡する」。
- 「複数のセッションで作業する」際にセッションを区別する。
- git のブランチやステータスを常に表示しておく。
構築前に知っておくべき詳細が2つあります。第一に、モデルの使用料はかかりません。「ステータスラインはローカルで実行され、API トークンを消費しません」。第二に、組み込みのフッターを置き換えるのではなく、その横に配置されます。ただし、カスタムステータスラインを使用すると、Claude Code は一部のフッターヒントの表示を停止するとドキュメントに記されています。
設定方法
2つの方法があります。
Claude に書かせる。 ドキュメントには次のようにあります。「/statusline コマンドは、表示したい内容を説明する自然言語の指示を受け付けます。Claude Code は ~/.claude/ にスクリプトファイルを生成し、設定を自動的に更新します」。モデル名やコンテキストバーなど、希望する内容を伝え、ファイルの編集を承認します。
自分で書く。 ~/.claude/settings.json のユーザー設定、またはプロジェクト設定に statusLine フィールドを追加します。タイプを command に設定し、コマンドでスクリプトまたはインラインのシェルコマンドを指定します。
出力を調整する3つのオプションフィールドがあります:
- padding: 水平方向の余白を追加します。
- refreshInterval: 後述するタイマーでコマンドを再実行します。
- hideVimModeIndicator: スクリプトで表示している場合に、組み込みの vim モードテキストを非表示にします。
ステータスラインを削除するには、/statusline を実行して削除やクリアを依頼するか、設定からフィールドを削除します。
スクリプトが受け取るセッションフィールド
実行されるたびに、スクリプトは stdin で1つの JSON オブジェクトを受け取ります。ドキュメントの表は長く、フィールドはいくつかのグループに分かれます。
モデルとエフォート。 model.id と model.display_name、さらに effort.level と thinking.enabled。
現在地。 workspace.current_dir、workspace.project_dir(Claude Code が起動されたディレクトリ)、追加されたディレクトリ、origin リモートからのリポジトリ ID、およびワークツリー内にいる場合はその詳細。
セッション ID。 「一意のセッション識別子」である session_id と、設定したカスタム名または AI が生成したセッションタイトルを使用する session_name。また、処理中のプロンプトの prompt_id や、「会話のトランスクリプトファイルへのパス」である transcript_path もあります。
コンテキスト。 次のセクションで説明する context_window オブジェクト。
コストと時間。 cost.total_cost_usd(ドキュメントではクライアント側で計算された推定値であり「実際の請求額とは異なる場合があります」と説明されています)、さらに合計時間、追加・削除された行数。
制限。 レート制限ウィンドウとそのリセットタイミングに関するフィールド、およびキャッシュがウォーム状態かどうかを含むプロンプトキャッシュオブジェクト。
プルリクエスト。 現在のブランチのオープンな PR 番号、URL、およびレビュー状態。
一部のフィールドは、適用されるまで存在しません。ドキュメントのトラブルシューティングセクションには、「最初の API レスポンスが完了するまでフィールドが null になる可能性があるため、スクリプトでフォールバックを使用して null 値を処理してください」とあります。
コンテキストウィンドウ使用率の表示方法
コンテキストの監視はドキュメントに記載されている最初の用途であり、その内容についても正確に説明されています。
それは「最新の API レスポンスからのライブコンテキストウィンドウ」を表します。これには、最大ウィンドウサイズ、入力と出力の合計、カテゴリ別の内訳、および2つの事前計算済みフィールド used_percentage と remaining_percentage が含まれます。
重要なルールは何をカウントするかです。ドキュメントには次のようにあります。「used_percentage フィールドは入力トークンのみから計算されます:input_tokens + cache_creation_input_tokens + cache_read_input_tokens。これに output_tokens は含まれません」。
内訳から自分で数値を計算する場合、ドキュメントは「used_percentage と一致させるために、同じ入力のみの数式を使用する」よう指示しています。ほとんどのスクリプトに対する推奨事項はよりシンプルです。「最もシンプルで正確なコンテキスト状態を得るには、used_percentage を使用してください」。
注意が必要なフィールドが1つあります:exceeds_200k_tokens です。ドキュメントによると、これは最新のレスポンスの合計カウントが 200k を超えているかどうかを反映するもので、「実際のコンテキストウィンドウサイズに関係なく固定のしきい値」です。これはウィンドウが満杯に近いことを示す警告ではありません。
/context との違い
ステータスラインと /context は、わずかに異なるタイミングを測定しています。ステータスラインは最後の API レスポンスを使用します。/context はそれ以降に追加されたメッセージの推定値を加算します。そのため、大きなファイルを貼り付けた直後や Claude が複数のファイルを読み取った直後は、次のレスポンスが届くまで /context の方がステータスラインよりも大きな値を表示することがあります。
コンパクション(圧縮)はデータの一部をリセットします。ドキュメントによると、current_usage オブジェクトは「セッションの最初の API コールの前、および /compact の直後から次の API コールで再入力されるまで null になります」。コンパクション直後にコンテキストセグメントが空白またはダッシュになるのは想定内であり、スクリプトにフォールバックを用意しておくことで可読性を維持できます。
ステータスラインが更新されるタイミング
更新はクロックではなくイベントによって駆動されます。ドキュメントによると、スクリプトはセッションの開始時または再開時に一度実行され、その後以下のタイミングで再実行されます:
- 「新しいアシスタントメッセージが届いたとき」。
- 「
/compactが終了したとき」。 - 「パーミッションモードが変更されたとき」。
- 「Vim モードが切り替わったとき」。
- 設定でコマンドを変更したとき。
- 設定している場合、リフレッシュインターバルが経過したとき。
- 最新データのレート制限ウィンドウまたはウォームプロンプトキャッシュがリセットまたは期限切れの時間に達したとき。
更新はバッチ処理されます。「Claude Code は 300ms で更新をデバウンスするため、急速な変更はまとめられ、変更が止まった後にスクリプトが一度実行されます」。また、スクリプトの実行中に新しい更新がトリガーされた場合、Claude Code は実行中のスクリプトをキャンセルします。
バックグラウンドエージェント実行中に更新が止まる理由
これは冒頭の例で挙げた挙動です。更新はメインセッションのイベントに従うため、そのセッションで長い待機が発生すると、他の場所で作業が進んでいても更新がほとんど、あるいは全く行われません。
ドキュメントはこのケースを直接挙げています。「イベント駆動型のトリガーは、メインセッションがアイドル状態のとき(例:コーディネーターがバックグラウンドのサブエージェントを待機している間など)に静止することがあります」。その解決策は、refreshInterval を設定して「固定タイマーでコマンドを再実行する」ことです。最小値は1秒です。
ドキュメントでは、時計のようにセッション外で変化するセグメントや、「メインセッションがアイドル状態の間にバックグラウンドサブエージェントが git の状態を変更したとき」のためにもこの設定に言及しています。マルチエージェント作業中にステータスラインで git ステータスを表示する場合、リフレッシュインターバルを設定することで最新の状態を保てます。
リフレッシュインターバルはスクリプトを再実行するだけであり、新しいコンテキストデータを作成するわけではありません。コンテキストフィールドは依然としてメインセッションの最新の API レスポンスに基づいています。
消えてしまう原因
トラブルシューティングセクションには、ステータスラインが空白になる原因がいくつか挙げられています:
- フォルダが信頼されていない。 「ワークスペースの信頼ダイアログを承認するまで、ステータスラインは空白のままです」。ステータスラインはシェルコマンドを実行するため、フックと同じ信頼ルールに従います。
- スクリプトが失敗する。 「ゼロ以外のコードで終了したり、出力を生成しなかったりするスクリプトは、ステータスラインを空白にします」。
- フックが無効化されている。 管理設定以外で
disableAllHooksが true の場合、管理されたステータスラインのみが実行されます。 - 組織がフックを制限している。 管理設定で
allowManagedHooksOnlyが設定されている場合、「カスタムステータスラインは警告なしに消えます」。
何が起きているかを確認するために、ドキュメントは claude --debug の実行を推奨しています。これにより、セッションの初回実行時にスクリプトの stderr と終了コードがログに記録されます。
速度も重要です。「遅いスクリプトは、完了するまでステータスラインの更新をブロックします」。git status などのコマンドについては、結果をキャッシュすることをドキュメントは提案しています。
Codex が独自のコンテキスト残量をどのように計算するか(新しいチャットで最大値から始まる理由を含む)については、Codex のコンテキスト残量に関するガイドで解説しています。
よくある間違い
ステータスラインを /context と比較する。 これらは異なるタイミングを測定しています。/context は次のレスポンスまで高い値を表示することがあります。
長時間のバックグラウンド作業中の更新を期待する。 メインセッションがアイドルの間、イベントトリガーは静止します。リフレッシュインターバルを設定してください。
exceeds_200k_tokens をウィンドウ満杯の警告として扱う。 これは固定のしきい値です。
コンテキストの数値に出力トークンを加算する。 used_percentage は入力トークンのみをカウントします。
信頼されていないフォルダで空白行をデバッグしようとする。 まず信頼ダイアログを承認してください。
解決策:ステータスラインでコンテキスト保存のタイミングを知る
ステップ 1: used_percentage を表示する
これは、最もシンプルで正確なコンテキスト状態を示すためにドキュメント化されたフィールドです。
ステップ 2: null 値のフォールバックを追加する
最初のレスポンス前や /compact 後は、フィールドが空になる可能性があります。
ステップ 3: エージェント作業用にリフレッシュインターバルを設定する
メインセッションが待機している間もセグメントを最新に保ちます。
ステップ 4: ウィンドウが満杯になる前に決定事項を保存する
数値が上昇してきたら、後で必要になるセッション中の決定事項や事実を書き留めておきましょう。
MemoryLake でのセットアップ
ステータスラインはコンテキストウィンドウがどれくらい満たされているかを教えてくれますが、何も保存はしません。セッションが圧縮されたり終了したりすると、そこでなされた決定事項の耐久性は、要約やトランスクリプトと同程度でしかありません。何を決定したか、どのアプローチが失敗したか、どの制約が適用されるかといった、セッションをまたいで重要なコンテキストは、自分で書いたノートとして保管するのが最適です。
MemoryLake は、そのようなプロジェクトコンテキスト(過去のセッションからの決定、制約、教訓など)のためのメモリレイヤーです。一箇所で管理し、ChatGPT、Claude Code、Codex などの接続したアシスタントから利用できます。
エントリーは自分の言葉で自分で書きます。Claude Code のセッション、トランスクリプト、ステータスラインのスクリプト、設定ファイル、あるいはベンダーのストレージから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。ステータスラインは Anthropic が説明している通りに機能します。
ステップ 1: API キーを作成する
サインインしてダッシュボードからキーを生成します。他の認証情報と同様に、リポジトリの外に保管してください。

ステップ 2: 最初のメモリをアップロードする
解決策のステップ 4 で書いた内容、つまり長いセッションから残しておく価値のある決定事項や事実から始めましょう。1つのエントリーにつき1つのトピックにします。

ステップ 3: AI とエージェントを接続する
Claude Code、Codex、および使用している他のアシスタントを接続します。新しいセッションを同じノートから開始できます。

実践で何が変わるか
第一の違いはタイミングです。ステータスラインは単なるゲージではなく、コンテキストを保存するためのシグナルになります。
第二に、コンパクションがスムーズになります。要約が詳細を置き換える前に、必要なことはすでに書き留められています。
第三に、ツール間の一貫性です。同じノートが Claude Code でも他のアシスタントでも利用可能になります。
Claude Code ステータスラインのベストプラクティス
/statusline から始める。 欲しい内容を説明して、Claude Code にスクリプトを書かせます。
used_percentage を使用する。 設計上、入力トークンのみをカウントします。
null を処理する。 最初のレスポンス前やコンパクション後は空の値になることを想定してください。
長時間のエージェント作業には refreshInterval を追加する。 イベントトリガーが静止することがあります。
スクリプトを高速に保つ。 git status などの遅いコマンドはキャッシュします。
セッション名を表示する。 複数のセッションを実行しているときに役立ちます。
空白の場合は信頼設定とフック設定を確認する。 どちらも表示を消す原因になります。
結論
Claude Code のステータスラインは、設定したシェルスクリプトを実行し、stdin で JSON セッションデータを渡し、スクリプトがプリントした内容を表示します。API トークンは消費しません。データには、モデル、ワークスペース、セッション ID と名前、トランスクリプトのパス、コスト見積もり、レート制限、および入力トークンのみをカウントする used_percentage を含む context_window オブジェクトが含まれます。
新しいアシスタントメッセージや /compact などのイベントで更新され、300ms のデバウンスが行われます。メインセッションがバックグラウンドサブエージェントを待っている間はこれらのトリガーが静止することがあるため、refreshInterval で最新の状態を維持します。ステータスラインは最後の API レスポンスを報告するため、/context の方が高い値を読み取ることがあります。ウィンドウが満杯になる前に、重要なことを保存するためのシグナルとして活用してください。