Claude Code ステータスバーは素晴らしい:CC statuslineがターミナルを瞬時に美しく効率的にする
Claude Code ステータスバーは素晴らしい:CC statuslineがターミナルを瞬時に美しく効率的にする
モデル、Git、コンテキスト、コストをリアルタイムで表示するClaude Codeステータスバー、ゼロ設定のTUI入門ガイド。
デフォルトのClaude Codeステータスバーは忘れてください。CCstatuslineこそがターミナルを美しく、かつ機能的にする魔法のツールです。モデル情報、Gitブランチ、トークン使用量、セッションコスト、タイマー、Powerline矢印をすべてカスタムステータスバーに詰め込むことができ、全てグラフィカルに設定可能で、ファイルを変更する必要もありません。
CCstatuslineとは?
これはClaude Code向けのオープンソースnpmパッケージで、リアルタイム指標の設定可能なステータスバーを提供し、Powerline、内蔵TUI設定、複数のテーマをサポートしています。
起動後、Liveプレビューが表示されます:Ctx: 18.6k | ⎇ main | (+42,-10)。設定後はさらに華やかになります。
何を表示できるか
コンポーネント(Widgets)を自由に組み合わせ:モデル名、コンテキストの長さ、Gitブランチ/変更、セッションの長さ、5時間のブロックタイマー、セッションコスト、作業ディレクトリ、任意のカスタムテキストやコマンド出力……複数のステータスバーをそれぞれレイアウトすることもできます。
全てTUI設定、設定ファイルを変更する必要なし
npx ccstatusline@latestを実行するとインタラクティブインターフェースに入ります。7つのメニュー:ラインの編集、色の変更、Powerline設定、ターミナルオプション、グローバルスタイル、Claude Codeへのインストール、保存して終了。上部は随時変更を確認できます。
Powerlineを開くと、見た目が一気に向上
まずPowerlineメニューでiを押してNerd Fontをインストールし、次にtを押して矢印区切りを有効にします。Windowsユーザーは、ボックスが表示された場合、Nerd Fontをインストールしてターミナルフォントに設定すれば大丈夫です。
クイックインストール手順
- ターミナルで実行:
npx ccstatusline@latest
または bunx ccstatusline@latest
- TUIに入ったら、まずPowerlineを開き、必要に応じてコンポーネント、色、グローバルスタイルを調整します。
- 「Install to Claude Code」を選択して設定を書き込み、保存して終了します。
コンポーネント設定のヒント
- 「Edit Lines → Line 1」に入り、↑↓でコンポーネントを選択し、
aで追加、dで削除、←→でタイプを切り替え、rで元の値を表示、mでマージします。 - 3つの独立したステータスバーを作成し、リアルタイムプレビューが可能です。
推奨するコンポーネント:モデル、ブロックタイマー、セッションコスト、Gitブランチ、コンテキストの長さ。
色とターミナルオプション
「Edit Colors」で←→で色を選択し、fで前景/背景、bで太字、aで256色に切り替え、rでリセットします。「Terminal Options」では16色/256色/Truecolorを選択できます。
Claude Codeへのインストールと実行例
保存後、Claude Codeを開くと、ステータスバーがすぐに有効になり、テーマはPowerlineテーマで切り替え可能です。
TUIに戻って再度変更
いつでもnpx ccstatusline@latestを再実行して調整を続けることができます。
私のお気に入りのコンポーネントの組み合わせ
Gitブランチ + 変更、ブロックタイマー、セッションコスト、コンテキストの長さ、作業ディレクトリ、現在のモデル。
ブロックタイマー
Claude Codeは5時間ごとにセッションブロックを作成します。このタイマーは、残りの時間を常に把握するのに役立ちます;pを押すとプログレスバー表示に切り替えられます。
セッションコスト
リアルタイムでコストを表示し、rを押すとラベルを閉じて数字だけを見ることができます。Claude Code 1.0.85+が必要です。
Gitブランチと変更
ブランチは常に表示され、変更行数も一目瞭然で、git worktreeの小コンポーネントも選択可能です。
コンテキストの長さ
リアルタイムのトークンカウントで、長いセッションでの超過を防ぎます。
カスタムコマンド
任意のシェルコマンドを実行し、その出力をステータスバーに挿入できます。ネットワークコマンドは5000ms+のタイムアウトを設定することを忘れないでください。例:
date +%H:%M node -v git rev-parse --short HEAD curl -s wttr.in?format="%t" npx -y ccusage@latest statusline
まとめ & 注意事項
- Powerline矢印にはNerd Fontが必要です。
- セッションコストはClaude Code 1.0.85+が必要で、/resume時に更新されない場合があります。
- 設定を変更したい場合は、いつでも
npx ccstatusline@latestを実行してください。


