AIツール活用

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

中島大介(なかじ)読了時間 約14分
Claude Codeのステータスラインの設定方法を解説する記事のアイキャッチ

Claude Codeで長い作業を頼んでいると、会話がどれくらい埋まってきたのか、利用上限まであとどれくらいなのかが分からなくなります。確かめるたびにコマンドを打つのは、作業の流れを止める原因です。

Claude Codeの画面の一番下には、好きな情報を常に表示できる「ステータスライン」があります。設定にはスクリプトが要ると思われがちですが、表示用のコマンドはClaude Codeに日本語で頼んで作ってもらうことも可能です。

この記事では、Claude Codeのステータスラインを日本語で頼んで設定する手順と、自分で設定する手順を、実際の画面で1ステップずつ解説します。

この記事を読めば、Claude Codeのステータスラインの設定方法と、表示されないときの直し方が分かります。ステータスラインは、入力欄に「/statusline」と表示したい内容を書くだけで設定できる機能です。

目次

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つです。

  1. 入力欄に「/statusline」と表示したい内容を書く
  2. 設定ファイルの書き換えを承認する
  3. 画面の一番下に表示されたか確かめる

入力欄に「/statusline」と表示したい内容を書く

Claude Codeを起動した直後の画面の一番下には、モードの表示などだけが出ています。

設定する前の画面。一番下の行には、モードの表示しかない

入力欄に「/statusline」と書き、続けて表示したい内容を日本語で書きます。撮影では「モデル名とフォルダ名と会話の使用率をバーで表示して」と頼みました。

表示したい内容は日本語で書いてよい。撮影では、書き込む先も指定した

/statuslineは、何も指定しなければ自分の設定(~/.claude)に書き込みます。撮影では、練習用のフォルダだけに効く設定(.claude/settings.local.json)に書くように頼みました。

設定ファイルの書き換えを承認する

「/statusline」を送ると、ステータスラインの設定を受け持つエージェント「statusline-setup」が裏で動き、頼んだ内容から表示用のコマンドを作ります。設定ファイルを書き換える前に表示されるのが、書き換える中身と承認の確認です。

書き換える中身を確かめて「1. Yes」を選ぶ。3つ目の選択肢は、画面の描き直しで文字が重なって「Nossion」と見えている(正しくは「No」)

追加される「statusLine」の項目と、表示用のコマンドの中身を確かめてから「1. Yes」を選びます。確認の画面が出るのは、Claude Codeが書き換えのたびに確認するモードで使っている場合です。

撮影では、スクリプトのファイルは作られず、設定ファイルの中に1行のコマンドとして書き込まれました。作ったコマンドを試しに動かす確認も出たため、中身を読んでから承認しています。

画面の一番下に表示されたか確かめる

設定が終わると、画面の一番下にステータスラインが表示されます。ステータスラインが更新されるのは、Claude Codeが返事をしたときや、権限のモードを切り替えたときなどです。

一番下の行に、モデル名・フォルダ名・会話の使用率のバーが表示された

上の画像では「Opus 5.5」がモデル名「sample-site」がフォルダ名、右のバーと「6%」が会話の使用率です。

ステータスラインを入れると、画面の下に出ていた「esc to interrupt」などのキー操作の案内はほとんど表示されなくなります。キー操作に慣れないうちは、案内が消えることも知っておくと戸惑いません。

Claude Codeのステータスラインをsettings.jsonで自分で設定する手順

表示の形を細かく決めたい場合は、表示用のスクリプトを自分で書いて設定ファイルに登録します。スクリプトの中身は、Claude Codeに頼んで作ってもらってもかまいません。

ステータスラインを自分で設定する手順は、以下の3つです。

  1. 表示用のスクリプトを作る
  2. スクリプトに実行の権限を付ける
  3. 設定ファイルの「statusLine」にスクリプトを登録する

表示用のスクリプトを作る

表示用のスクリプトは、Claude Codeから受け取った情報(JSON)を読み、表示したい文字を出力するファイルです。撮影では、1行目にモデル・フォルダ・ブランチ、2行目に会話の使用率と利用上限を出すスクリプトを作りました。

表示用のスクリプト。jqで必要な情報を取り出し、echoで2行を出力している

スクリプトの中で使っている「jq」は、JSONの中身を取り出すためのツールです。「jq --version」で版が表示されない場合は、jqのダウンロードのページの案内に従って先に入れておきます。

すべてのフォルダで使う場合のスクリプトの置き場所の例は「~/.claude/statusline.sh」です。撮影では、練習用のフォルダの中の「.claude/statusline.sh」に置きました。

スクリプトに実行の権限を付ける

作ったスクリプトには、ターミナルで「chmod +x スクリプトのパス」を実行して、実行の権限を付けます。実行の権限がないと、ステータスラインは表示されません。

「ls -l」の結果の「-rwxr-xr-x」のように「x」が含まれていれば、実行の権限が付いている

設定ファイルの「statusLine」にスクリプトを登録する

設定ファイルに「statusLine」の項目を足し「type」に「command」「command」にスクリプトのパスを書きます。

設定ファイルの「statusLine」の項目。「command」にスクリプトの場所を書く

設定ファイルを保存すると、Claude Codeは設定を読み込み直し、スクリプトをすぐに動かします。利用上限の使用率など一部の値は、Claude Codeから最初の返事が来たあとに表示される仕組みです。

自分で作った2行のステータスライン。撮影したアカウントでは、7日の枠の使用率だけが表示された

設定ファイルによって、ステータスラインが効く範囲が変わります。ステータスラインを書く設定ファイルの違いは、以下の表のとおりです。

設定ファイル効く範囲
~/.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のステータスラインを消す手順は、以下のとおりです。

  1. 入力欄に「/statusline delete」と入力する
  2. 設定ファイルの書き換えを承認する
  3. 画面の一番下の行から表示が消えたか確かめる
「/statusline delete」と入力したところ。撮影では、消す場所も書き添えた
「statusLine」の項目が消える書き換えを確かめて「1. Yes」を選ぶ(3つ目の選択肢は、画面の描き直しで文字が重なっている)
ステータスラインを消すと、一番下の行は元の表示に戻る(会話を/clearで新しくしたあとの画面)

「/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のステータスラインを使う流れは、以下のとおりです。

  1. 「/statusline」に表示したい内容を日本語で書く
  2. 設定ファイルの書き換えを確かめて承認する
  3. 画面の一番下に表示されたか確かめる
  4. 要らなくなったら「/statusline delete」で消す

まずは会話の使用率だけを表示して、作業中に会話の容量を気にしながら進める感覚をつかみましょう。

参考リンク

この記事の監修者

中島大介(なかじ)

中島大介(なかじ)

株式会社メリル 代表取締役 / 記事監修

株式会社メリル代表取締役。SEO歴20年以上。最新AIやセキュリティについて発信するYouTube「ウェブ職TV」は登録者15万人以上。著書「ChatGPT & Copilotの教科書」は10万部突破!

プロフィールを見る

関連する記事

Cursorのプラグイン「pstack」の使い方を解説する記事のアイキャッチ
AIツール活用

pstackの使い方|Cursor・Claude Codeへの入れ方と頼み方

pstackを使ってみたい方は必見!この記事では、pstackの入れ方と/poteto-modeでの頼み方を解説します。実は、pstackで最初に覚えるコマンドは2つだけです。記事を読めば、AIに確かめさせながら作業を任せられます。

中島大介(なかじ)監修 / Touch AI編集部25 分で読めます
MetaのAIエージェント「Muse」の使い方を解説する記事のアイキャッチ
AIツール活用

Museの使い方|Meta Museの始め方・初期設定・料金を解説

Museを使い始めたい方は必見!この記事では、Meta Museの始め方・初期設定・料金を解説します。実は、Museとのやり取りをAIの学習に使う設定は最初からオンです。記事を読めば、任せる範囲を決めてから使い始められます。

中島大介(なかじ)監修 / Touch AI編集部26 分で読めます
Claude Codeで複数ファイルを一括置換する方法を解説する記事のアイキャッチ
AIツール活用

複数ファイルの文字列を一括置換するには?Claude Codeで残す語を指定

製品名の変更で複数のファイルを直したい方は必見!この記事では、Claude Codeで複数のファイルの文字を一括置換する手順を解説します。実は、残す語を決めてから置き換えられます。記事を読めば、コピーから元に戻す方法も分かります。

中島大介(なかじ)監修 / Touch AI編集部19 分で読めます

次のステップ

最新動向を学びに変える

話題のAIアップデートを、現役講師が背景と実務への影響まで解きほぐします。Touch AI の最新講座で、変化に追いつくための視点を得てください。

受講できる講座を見る