Claude Usage

Claude Usageバージョン 1.0.0

Claude の使用上限を、いつも視界に

プロンプトの下のステータスラインと、デスクトップのガラス調ウィジェットが、5時間・週間の上限、リセットの時刻、各セッションの費用を表示します。

Windows 10/11 · macOS 13 以降 · zip 1つにインストーラー2つ

折りたたんだウィジェット:5時間の使用量は62%でオレンジ、上限に達する警告つき。週間の使用量は38%で緑。

見守る2つの方法

ステータスラインで

Claude Code のプロンプトの下に、コンテキストの使用量、セッションが使ったトークンと費用、2つの上限とリセットまでの残り時間を表示します。Claude Code が動く場所ならどこでも使えます。

デスクトップで

小さなフローティングカードが2つの上限を緑・オレンジ・赤で示し、現在の期間がどこまで進んだかも目印で表します。このペースだとリセット前に上限に達する場合は、その時刻も教えてくれます。

  • まだ余裕あり
  • 上限が近づく
  • ほぼ使い切り

地味だけれど効く工夫

支出とモデル

統計ビューを開くと全体が見えます。セッションを API 料金で換算した日・週・月ごとの費用と、モデル別の内訳を確認できます。

日別直近2週間を、1本ずつ。
統計ビューの「日」タブ:直近2週間の1日ごとの支出を棒グラフで表示し、下にモデル別の割合を表示。
週別忙しかった週と静かな週が一目瞭然です。
統計ビューの「週」タブ:週ごとの支出を棒グラフで表示。
月別長い目で、ひと月ずつ。
統計ビューの「月」タブ:月ごとの支出を棒グラフで表示。

スクリーンショット:Windows 版ウィジェット(デモデータ)。 macOS 版ウィジェットも同じ機能を備えています。インストール時にお使いの Mac でビルドされるため、ここにはスクリーンショットがありません。

セッションを1件ずつ

Claude Code のセッションを1行ずつ、新しい順に表示します。タイトル、プロジェクト、時刻、トークン、費用。高くついたものがひと目で分かります。

統計ビューの「セッション」タブ:直近のセッションをプロジェクト、時刻、トークン、費用つきで一覧表示。

1分でインストール

1つの zip に両方のインストーラーが入っています。お使いのシステム用を実行してください。

Windows 10 / 11お使いのシステム

  1. zip をダウンロードして展開し、claude-usage フォルダーを開きます。
  2. install.cmd をダブルクリックするか、PowerShell で次を実行します。
    powershell -ExecutionPolicy Bypass -File install.ps1
  3. Claude Code を再起動してください。プロンプトの下にステータスラインが現れ、最初のセッションとともにウィジェットが開きます。上限は最初の返信のあとに表示されます。

macOS 13 以降お使いのシステム

  1. 初回のみ:Xcode Command Line Tools をインストールします。ウィジェットはインストール中にお使いの Mac でビルドされます。
    xcode-select --install
  2. ダウンロードした zip を展開し、claude-usage フォルダーでターミナルから次を実行します。
    bash install.sh
  3. Claude Code を再起動してください。プロンプトの下にステータスラインが現れ、最初のセッションとともにウィジェットが開きます。上限は最初の返信のあとに表示されます。

必要なものだけ

ステータスラインだけで十分ですか?ウィジェットなしでインストールできます。すでにインストール済みなら、ウィジェットのメニューでステータスラインをオフにするか、Claude Code と一緒に起動しないようにできます。もう一方は動き続けます。

Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -NoWidget
macOS
bash install.sh --no-widget

ウィジェットを手動で開くには、スタートメニュー(Windows)またはアプリケーション(macOS)の Claude Usage を探します。隠れている場合は、トレイまたはメニューバーのアイコンをクリックしてください。

更新とアンインストール

更新

ウィジェットは1日1回、このサイトに新しいバージョンがあるか問い合わせます。あれば更新ボタンに点が付き、メニューに更新項目が現れます。送るのはバージョンとシステムだけで、メニューからオフにできます。

  1. このページから新しい zip をダウンロードします。
  2. インストーラーをもう一度実行します。履歴と設定は引き継がれます。

アンインストール

mod、ウィジェット、ショートカットを削除します。

Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -Uninstall
macOS
bash install.sh --uninstall

履歴を残すには -KeepHistory(Windows)または --keep-history(macOS)を付けます。

すべてローカルで完結

上限はステータスラインがお使いのコンピューターに書き出すファイルから、支出の履歴は Claude Code 自身のセッションログから読み取ります。何もアップロードされず、アカウントやサインインもありません。ウィジェットが送信するのは更新の確認だけです。

必要なもの

  • Windows 10 または 11、あるいは macOS 13 以降
  • mod に対応した Claude Code(2.1.296 で動作確認)。mod API は早期アクセス段階で、リリース間で変わる可能性があります。
  • Pro または Max のサブスクリプション:上限はアカウントから取得します。
  • 支出履歴には Node.js が必要です。なくても上限は表示されます。
  • macOS では Xcode Command Line Tools が必要です。ウィジェットはインストール中にお使いの Mac でビルドされます。

数字の読み方

  • 上限は、Claude が返信のたびに報告する割合です。そのため、どのセッションでも Claude Code を使うと更新されます。
  • 費用は、同じトークンを API 料金で換算した額です。サブスクリプションはこの方式では課金されません。どれだけ使い倒せているかの目安です。
  • 履歴は Claude Code のローカルのセッションログから読み取ります。ウィジェットは初回起動から自前の台帳を持ち、それ以前の期間は推定値として薄く描かれます。

使い切る前に、先に知る。

無料のオープンソースで、静かに動作。見るまでは隅っこでじっとしています。

Windows 10/11 · macOS 13 以降 · zip 1つにインストーラー2つ