Claude Codeのステータスラインとは？表示の設定方法

公開 更新 著者 永上裕之導入とルール
#Claude Code#ステータスライン#statusline#設定#コンテキスト
画面の下に、使っているモデルと残りの容量が1行で表示されるイメージ

この記事の要点

  • ステータスラインは Claude Code の画面の下に出る1行で、自分で決めたスクリプトの出力を表示する
  • /statusline に「何を出したいか」を書くと、Claude がスクリプトと設定を作ってくれる
  • 残りの容量・費用・利用枠・ブランチなどを出せて、表示はローカルで動くのでトークンを使わない

Claude Code を長く使っていると、「いまどれくらい記憶の容量を使っているか」「この会話でいくらかかったか」が気になってきます。それを 画面の下に常に出しておける のが ステータスライン です。

この記事では、公式ドキュメント（2026年10月24日確認）にもとづいて、ステータスラインの作り方と、表示できる項目をまとめます。

結論：まずは /statusline に頼むのがいちばん早い

ステータスラインは、Claude Code の画面の下に出る1行で、自分で決めたスクリプトの出力をそのまま表示する 仕組みです。Claude Code は会話の情報を JSON でスクリプトに渡し、スクリプトが出した文字が表示されます。

作り方は2通りあります。

  1. /statusline に頼む：出したい内容を言葉で書くと、Claude がスクリプトを作り、設定まで直してくれる
  2. 手で設定する：自分でスクリプトを書き、設定ファイルに登録する

公式ドキュメントによると、表示は 自分のパソコンの中だけで動き、APIのトークンを使いません。

方法1：/statusline に頼む

次のように、出したい内容をふつうの言葉で書きます。

/statusline モデル名と、記憶の容量を何％使ったかを棒グラフで出して

Claude Code が自分の設定フォルダにスクリプトを作り、設定を自動で更新します。途中でファイルを直してよいかの確認が出たら許可します。やめたいときは /statusline delete のように頼めば外れます。

方法2：手で設定する

手で作る場合は、次の3ステップです。

  1. JSON を読んで1行を出すスクリプトを作る（公式の例では jq で項目を取り出す）
  2. スクリプトに実行の権限を付ける
  3. 自分の設定ファイル（settings.json）に statusLine を足す
{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

command はシェルで動くので、短い処理ならスクリプトのファイルを作らずに1行で書くこともできます。保存すると設定は自動で読み直され、すぐに表示されます。設定ファイルの置き場所やルールの書き方は Claude Codeの権限設定入門 でも触れています。

表示できる主な項目

スクリプトには、次のような情報が JSON で渡されます。

知りたいこと項目の例
使っているモデルmodel.display_name
記憶の容量をどれだけ使ったかcontext_window.used_percentage（残りは remaining_percentage）
この会話のおよその費用cost.total_cost_usd（定価での見積もり）
利用枠の消費rate_limits.five_hour.used_percentage など（5時間・7日）
作業中のフォルダworkspace.current_dir
worktree で作業中かworktree.name・worktree.branch
選んでいる出力スタイルoutput_style.name

記憶の容量（コンテキスト）が残り少ないか がひと目で分かると、区切りのよいところで会話を分ける判断がしやすくなります。CLAUDE.md に書く内容を絞る話は CLAUDE.mdの書き方とは？ で解説しています。

いつ表示が更新されるか

スクリプトは会話を始めたとき（再開したときも）に1回動き、その後は次のタイミングで動き直します。

時計のように時間で変わるものを出したいときは、refreshInterval で「何秒ごとに動き直すか」を指定できます（最小1秒）。

気をつけること

仕事での使い方の例

困りごと出しておくと便利な項目
会話が長くなって返答が遅い記憶の容量の使用率
いくつも画面を開いて混乱するフォルダ名・ブランチ・worktree の名前
利用枠が足りなくなる5時間・7日の利用枠の消費

いくつものセッションを並べて使う方法は Claude Codeのworktreeとは？ で解説しています。

まとめ

出典

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール＆コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事

Claude Codeの出力スタイルとは？返答の口調と長さを変える2026-10-24・導入とルール
Claude Codeのプラグインとは？入れ方と作り方の基本2026-10-23・導入とルール
Claude Codeの/rewindとは？AIの変更を巻き戻す方法2026-10-23・導入とルール