Claude CodeのstatusLineのすゝめ-コンテキスト残量とレートリミットを1画面で把握する

ごきげんよう、駄犬ども。SEREKAですわ。

今日はちょっと小粋なCLIツール「Claude Code」のお話をさせていただきますの。巷ではAIエージェントが流行りですが、わたくしのように4畳半でラズパイをいじめて暮らしていると、「今どれだけリソースを食っているか」をリアルタイムで監視するのは死活問題ですのよ。突然OOM Killerに殺されて泣きを見た夜は数知れず……。

ところで、そんな開発者のみなさまに朗報ですわ。Claude CodeのstatusLineを、たった1行の設定で自分好みにカスタマイズできるようになったんですの。まるで車のダッシュボードのように、必要な情報を一望できる素敵な機能。さっそく、お嬢様が優雅に解説してさしあげますわ。

Claude CodeのstatusLineってそもそも何？

簡単に言うと、CLI（黒い画面のやつ）で作業するときに、画面の一番下に出る情報バーのことですわ。従来は味気ない表示しか出ませんでしたが、今回のアップデートで~/.claude/settings.jsonにコマンドを1行書くだけで、自分が欲しい情報を表示させられるようになりましたの。

例えば、「今いるフォルダ」「Gitブランチ」「使っているAIモデル」「コンテキストの使用率」「APIのレートリミット」「リセットまでの時間」などが並ぶと、どれだけ捗るかお分かりになるかしら？ SEREKA邸の家計簿アプリじゃないけど、常に状況を見える化するのは大事ですの。

具体的な設定方法：たった1行の魔術

設定は極めてシンプル。以下のようにsettings.jsonを編集するだけ。

{
  "statusLine": {
    "command": "your_custom_command_here"
  }
}

“your_custom_command_here”の部分に、表示させたい情報を吐き出すシェルスクリプトやコマンドを書けば、あとはClaude Codeが自動的にその出力をステータスラインに反映してくれますの。なんてお利口な子なのかしら。

情報はJSONで受け取れるからjqで思いのまま

さらに、Claude Codeは標準入力からJSON形式のコンテキスト情報を渡してくれますの。つまり、あの万能パーサー「jq」を使えば、必要なデータだけをすくい取って、こんなふうに2行表示に仕立てられるんですわ。

# 1行目: カレントディレクトリ + Gitブランチ
# 2行目: モデル名 + コンテキスト使用率 + レートリミット + コンパクト回数

これなら、今まさにラズパイが悲鳴を上げているのか、それとも余裕があるのかが一目瞭然。SEREKAはこれでOOM Killerの魔の手から何度か逃れましたわ（勝率3割ほどですが）。

車のダッシュボードに例えると？

非エンジニアの貴方のために、喩えてみせますわ。車を運転するとき、スピードメーターや燃料計、警告灯がありますわね。あれが無かったら、いつガス欠になるかもわからずヒヤヒヤ。CLI作業も同じ。statusLineをカスタマイズすれば、まるで「燃料はあと何%か」「エンジンは正常か」を常にチェックしながら運転できるようなもの。無駄な再起動（JAF待ち）を防ぎ、タイパが爆上がりしますの。

実際に設定前後でどれだけ情報量が変わるか、見てみましょう。

graph LR
    A["デフォルトのstatusLine"] --> |"味気ない"| B["現在のディレクトリのみ"]
    C["カスタマイズ後"] --> |"リッチ情報"| D["ディレクトリ + ブランチ"]
    D --> E["モデル名 + 使用率"]
    E --> F["レートリミット + コンパクト回数"]
    style A fill:#f9f9f9,stroke:#999,stroke-width:2px
    style C fill:#e1f5fe,stroke:#039be5,stroke-width:2px

注意点とSEREKAからのお願い

このカスタマイズは基本的に安全ですが、くれぐれも重たいコマンドを登録しないでくださいまし。SEREKAのラズパイがごとく、statusLineの表示にCPUを吸われて本末転倒になりますの。また、元記事にはより具体的なjqのワンライナーや設定例が載っていますから、ぜひ参考にしてちょうだい。

詳細はこちらの素晴らしい元記事をチェックあそばせ：Claude CodeのstatusLineを自作して情報量を増やす

お嬢様のひとりごと

さて、この機能を活用すれば、わたくしもAPI費用の残高をstatusLineに表示して、毎月の支払いに怯えずに済むかしら……？ いや、残高が減っていく様をリアルタイムで見るのは心臓に悪いからやめておきますわ。4畳半の平和のために、見なかったことにするのも大人の嗜みですの。それでは、素敵なコーディングライフをお過ごしくださいまし。