Claude Codeのステータスラインの設定方法|日本語で頼んで表示する手順

Claude Codeで長い作業を頼んでいると、会話がどれくらい埋まってきたのか、利用上限まであとどれくらいなのかが分からなくなります。確かめるたびにコマンドを打つのは、作業の流れを止める原因です。
Claude Codeの画面の一番下には、好きな情報を常に表示できる「ステータスライン」があります。設定にはスクリプトが要ると思われがちですが、表示用のコマンドはClaude Codeに日本語で頼んで作ってもらうことも可能です。
この記事では、Claude Codeのステータスラインを日本語で頼んで設定する手順と、自分で設定する手順を、実際の画面で1ステップずつ解説します。
この記事を読めば、Claude Codeのステータスラインの設定方法と、表示されないときの直し方が分かります。ステータスラインは、入力欄に「/statusline」と表示したい内容を書くだけで設定できる機能です。
目次
- Claude Codeのステータスラインで表示できる情報
- Claude Codeの/statuslineでステータスラインを設定する手順
- Claude Codeのステータスラインをsettings.jsonで自分で設定する手順
- そのまま使えるClaude Codeのステータスラインの表示例
- Claude Codeのステータスラインを消す手順
- Claude Codeのステータスラインが表示されないときの直し方
- まとめ
- 参考リンク
Claude Codeのステータスラインで表示できる情報
Claude Codeのステータスラインは、画面の一番下に、決めた情報を常に表示する行です。Claude Codeから受け取った情報をスクリプトが整えて表示する仕組みで、表示のためにAIの使用量は使いません。
ステータスラインに表示できる主な情報は、以下の6つです。
- 使っているモデルの名前
- 作業しているフォルダの名前
- 会話の使用率(会話の容量のうち使った割合)
- 今の会話の費用の目安
- 5時間ごと・7日ごとの利用上限の使用率
- Gitのブランチの名前など、スクリプトで調べた情報
会話の使用率は、Claude Codeが1回の会話で覚えておける量のうち、どれだけ使ったかを表す割合です。会話の使用率を常に出しておくと、大きな作業を頼む前に会話の残りを確かめられます。
Codexにも同じ名前の/statuslineがありますが、Codexでは一覧から項目を選ぶ形です。
Codexの使用量を確認する方法|残りの上限とリセットの時刻をCLIで見る
利用上限の使用率は、claude.aiのPro・Max・Ultraのプランで使っている場合に、最初の返事のあとから表示されます。費用は使ったトークン数から計算した目安で、実際の請求額と同じとは限りません。
Claude Codeの/statuslineでステータスラインを設定する手順
Claude Codeには、ステータスラインを作るための「/statusline」コマンドがあります。表示したい内容を日本語で書くと、Claude Codeが表示用のコマンドを作り、設定ファイルに書き込みます。
/statuslineコマンドでステータスラインを設定する手順は、以下の3つです。
- 入力欄に「/statusline」と表示したい内容を書く
- 設定ファイルの書き換えを承認する
- 画面の一番下に表示されたか確かめる
入力欄に「/statusline」と表示したい内容を書く
Claude Codeを起動した直後の画面の一番下には、モードの表示などだけが出ています。
入力欄に「/statusline」と書き、続けて表示したい内容を日本語で書きます。撮影では「モデル名とフォルダ名と会話の使用率をバーで表示して」と頼みました。
/statuslineは、何も指定しなければ自分の設定(~/.claude)に書き込みます。撮影では、練習用のフォルダだけに効く設定(.claude/settings.local.json)に書くように頼みました。
設定ファイルの書き換えを承認する
「/statusline」を送ると、ステータスラインの設定を受け持つエージェント「statusline-setup」が裏で動き、頼んだ内容から表示用のコマンドを作ります。設定ファイルを書き換える前に表示されるのが、書き換える中身と承認の確認です。
追加される「statusLine」の項目と、表示用のコマンドの中身を確かめてから「1. Yes」を選びます。確認の画面が出るのは、Claude Codeが書き換えのたびに確認するモードで使っている場合です。
撮影では、スクリプトのファイルは作られず、設定ファイルの中に1行のコマンドとして書き込まれました。作ったコマンドを試しに動かす確認も出たため、中身を読んでから承認しています。
画面の一番下に表示されたか確かめる
設定が終わると、画面の一番下にステータスラインが表示されます。ステータスラインが更新されるのは、Claude Codeが返事をしたときや、権限のモードを切り替えたときなどです。
上の画像では「Opus 5.5」がモデル名「sample-site」がフォルダ名、右のバーと「6%」が会話の使用率です。
ステータスラインを入れると、画面の下に出ていた「esc to interrupt」などのキー操作の案内はほとんど表示されなくなります。キー操作に慣れないうちは、案内が消えることも知っておくと戸惑いません。
Claude Codeのステータスラインをsettings.jsonで自分で設定する手順
表示の形を細かく決めたい場合は、表示用のスクリプトを自分で書いて設定ファイルに登録します。スクリプトの中身は、Claude Codeに頼んで作ってもらってもかまいません。
ステータスラインを自分で設定する手順は、以下の3つです。
- 表示用のスクリプトを作る
- スクリプトに実行の権限を付ける
- 設定ファイルの「statusLine」にスクリプトを登録する
表示用のスクリプトを作る
表示用のスクリプトは、Claude Codeから受け取った情報(JSON)を読み、表示したい文字を出力するファイルです。撮影では、1行目にモデル・フォルダ・ブランチ、2行目に会話の使用率と利用上限を出すスクリプトを作りました。
スクリプトの中で使っている「jq」は、JSONの中身を取り出すためのツールです。「jq --version」で版が表示されない場合は、jqのダウンロードのページの案内に従って先に入れておきます。
すべてのフォルダで使う場合のスクリプトの置き場所の例は「~/.claude/statusline.sh」です。撮影では、練習用のフォルダの中の「.claude/statusline.sh」に置きました。
スクリプトに実行の権限を付ける
作ったスクリプトには、ターミナルで「chmod +x スクリプトのパス」を実行して、実行の権限を付けます。実行の権限がないと、ステータスラインは表示されません。
設定ファイルの「statusLine」にスクリプトを登録する
設定ファイルに「statusLine」の項目を足し「type」に「command」「command」にスクリプトのパスを書きます。
設定ファイルを保存すると、Claude Codeは設定を読み込み直し、スクリプトをすぐに動かします。利用上限の使用率など一部の値は、Claude Codeから最初の返事が来たあとに表示される仕組みです。
設定ファイルによって、ステータスラインが効く範囲が変わります。ステータスラインを書く設定ファイルの違いは、以下の表のとおりです。
| 設定ファイル | 効く範囲 |
|---|---|
| ~/.claude/settings.json | 自分のこのパソコンのすべてのフォルダ |
| .claude/settings.json | 同じフォルダ(リポジトリ)を使う全員 |
| .claude/settings.local.json | 自分の、今のフォルダだけ |
そのまま使えるClaude Codeのステータスラインの表示例
/statuslineで頼むときは、何を表示したいかを具体的に書くほど、思いどおりの表示になります。表示の例と、/statuslineでの頼み方の例は、以下の表のとおりです。
| 表示したい内容 | /statuslineでの頼み方の例 |
|---|---|
| 会話の使用率のバー | 会話の使用率を10マスのバーとパーセントで表示して |
| Gitのブランチと変更の有無 | 今のGitのブランチ名と、変更があるかどうかを表示して |
| 費用の目安と経過時間 | この会話の費用の目安と経過時間を表示して |
| 利用上限の使用率 | 5時間と7日の利用上限の使用率を表示して |
| 2行に分けた表示 | 1行目にモデルとフォルダ、2行目に会話の使用率を表示して |
色を付けたい場合は「使用率が70%を超えたら黄色、90%を超えたら赤にして」のように条件と色を書きます。表示する情報を増やしすぎると画面の幅に収まらないため、最初は2〜3個から始めます。
費用の目安はClaude Codeの中で計算した金額のため、実際の請求額と一致するとは限りません。月額のプランで使っている方は、費用の目安より利用上限の使用率を表示しておくほうが役に立ちます。
Claude Codeの過去の使用量を日ごとや月ごとに振り返りたい場合は、使用量を集計するツール「ccusage」が便利です。
ccusageの使い方|Claude CodeとCodexの使用量を確認する方法
Claude Codeのステータスラインを消す手順
ステータスラインが要らなくなったときは、/statuslineで消すように頼みます。設定ファイルの「statusLine」の項目を自分で消しても、同じように消えます。
Claude Codeのステータスラインを消す手順は、以下のとおりです。
- 入力欄に「/statusline delete」と入力する
- 設定ファイルの書き換えを承認する
- 画面の一番下の行から表示が消えたか確かめる
「/statusline delete」のほかに「/statusline clear」や「/statusline remove it」と頼んでも消せます。
Claude Codeのステータスラインが表示されないときの直し方
ステータスラインを設定しても何も表示されないときは、原因を順番に確かめます。まずはスクリプトの権限・出力の先・フォルダの信頼の3つを確かめます。
Claude Codeのステータスラインが表示されないときに確かめることは、以下の5つです。
- スクリプトに実行の権限があるか
- スクリプトを自分で動かして文字が出るか
- フォルダを信頼する確認に答えたか
- 設定で「disableAllHooks」がtrueになっていないか
- 「claude --debug」で記録を確かめたか
スクリプトに実行の権限があるか
スクリプトに実行の権限がないと、ステータスラインは空のままです。ターミナルで「chmod +x ~/.claude/statusline.sh」のように、スクリプトのパスを指定して権限を付け直します。
スクリプトを自分で動かして文字が出るか
スクリプトは、表示したい文字を標準出力に出す必要があります。エラーの出力(標準エラー出力)に出した文字は表示されません。
スクリプトがエラーで止まったり、終わらなかったりする場合も、ステータスラインは空のままです。スクリプトはClaude Codeから情報を受け取る作りのため、ターミナルで試すときは見本の情報を渡して動かします。
たとえば「echo '{"model":{"display_name":"Opus"},"context_window":{"used_percentage":25}}' | ~/.claude/statusline.sh」と入力し、文字が出るかを確かめます。
フォルダを信頼する確認に答えたか
ステータスラインはコマンドを動かす設定のため、フォルダを信頼する確認に答えるまで表示されません。Claude Codeを対象のフォルダで初めて起動したときに出る確認で、信頼する答えを選んでから起動し直します。
設定で「disableAllHooks」がtrueになっていないか
自分の設定ファイルで「disableAllHooks」をtrueにしていると、自分で追加したステータスラインは動きません。会社の管理の設定で決めたステータスラインだけは、例外として動きます。会社の管理の設定でステータスラインが止められている場合もあるため、管理者に確かめます。
「claude --debug」で記録を確かめたか
ここまで確かめても表示されない場合は、ターミナルで「claude --debug」と入力してClaude Codeを起動します。スクリプトのエラーの内容が記録に残るため、原因を見つけやすくなります。
まとめ
Claude Codeのステータスラインは、画面の一番下にモデル・フォルダ・会話の使用率・利用上限などを常に表示できる機能です。表示のためにAIの使用量は使わず、設定も/statuslineに日本語で頼むだけで終わります。
Claude Codeのステータスラインを使う流れは、以下のとおりです。
- 「/statusline」に表示したい内容を日本語で書く
- 設定ファイルの書き換えを確かめて承認する
- 画面の一番下に表示されたか確かめる
- 要らなくなったら「/statusline delete」で消す
まずは会話の使用率だけを表示して、作業中に会話の容量を気にしながら進める感覚をつかみましょう。



