はじめに
現在 Claude Code は検証用として個人で Pro プランを契約して使っています。
7月から新しいチームに join してというのもあり既存のコードの分析に大活躍しています。
でも Pro プランだと結構簡単に limit にかかってしまって以下のようなメッセージが出てしまいます・・・。
Claude usage limit reached. Your limit will reset at 9pm (Asia/Tokyo).
まぁ Pro プランなんで制限にかかるのはしょうがないですがあとどれくらい使えるのか現在の使用量を確認したくなりました。
で、 perplexity で調べたところ ccusage と Claude Code Usage Monitor というツールが出てきたので今回はこの２つのツールを試してみようと思います。
ccusageコマンドラインツール（CLI）
ccusageは、~/.claude/projects/以下のログファイルから、現在または日別・月別・セッション別などのトークン使用量・料金を素早く可視化してくれるツールということです。
使い方
インストール不要で即実行できました。
npx ccusage@latest
初回実行してみたところ
% npx ccusage@latest
Need to install the following packages:
ccusage@15.5.1
Ok to proceed? (y) y
npm warn EBADENGINE Unsupported engine {
npm warn EBADENGINE package: 'ccusage@15.5.1',
npm warn EBADENGINE required: { node: '>=20.19.4' },
npm warn EBADENGINE current: { node: 'v18.20.5', npm: '10.8.2' }
npm warn EBADENGINE }
WARN Fetching latest model pricing from LiteLLM... ccusage 11:54:38 AM
ℹ Loaded pricing for 1248 models ccusage 11:54:38 AM
╭──────────────────────────────────────────╮
│ │
│ Claude Code Token Usage Report - Daily │
│ │
╰──────────────────────────────────────────╯
┌────────────┬───────────────┬───────────┬───────────┬───────────────┬─────────────┬───────────────┬─────────────┐
│ Date │ Models │ Input │ Output │ Cache Create │ Cache Read │ Total Tokens │ Cost (USD) │
├────────────┼───────────────┼───────────┼───────────┼───────────────┼─────────────┼───────────────┼─────────────┤
│ 2025-07-06 │ - sonnet-4 │ 67 │ 1,209 │ 44,838 │ 367,572 │ 413,686 │ $0.30 │
├────────────┼───────────────┼───────────┼───────────┼───────────────┼─────────────┼───────────────┼─────────────┤
│ 2025-07-14 │ - sonnet-4 │ 327 │ 39,240 │ 285,495 │ 3,084,434 │ 3,409,496 │ $2.59 │
├────────────┼───────────────┼───────────┼───────────┼───────────────┼─────────────┼───────────────┼─────────────┤
│ 2025-07-18 │ - sonnet-4 │ 2,849 │ 118,625 │ 1,204,673 │ 26,075,959 │ 27,402,106 │ $14.13 │
├────────────┼───────────────┼───────────┼───────────┼───────────────┼─────────────┼───────────────┼─────────────┤
│ 2025-07-21 │ - sonnet-4 │ 198 │ 5,104 │ 319,328 │ 4,245,685 │ 4,570,315 │ $2.55 │
├────────────┼───────────────┼───────────┼───────────┼───────────────┼─────────────┼───────────────┼─────────────┤
│ 2025-07-22 │ - sonnet-4 │ 20,710 │ 106,188 │ 1,033,573 │ 15,072,472 │ 16,232,943 │ $10.05 │
├────────────┼───────────────┼───────────┼───────────┼───────────────┼─────────────┼───────────────┼─────────────┤
│ Total │ │ 24,151 │ 270,366 │ 2,887,907 │ 48,846,122 │ 52,028,546 │ $29.61 │
└────────────┴───────────────┴───────────┴───────────┴───────────────┴─────────────┴───────────────┴─────────────┘
日付ごとの token 使用量とコストを表示してくれました🎉
Usage をみると色々とオプションがあるみたいですね。
# 基本的な使用方法
ccusage # 日次レポートを表示（デフォルト）
# レポートタイプ
ccusage daily # 日次トークン使用量とコスト
ccusage monthly # 月次集計レポート
ccusage session # 会話セッション別の使用量
ccusage blocks # 5時間課金ウィンドウ
# ライブ監視
ccusage blocks --live # リアルタイム使用量ダッシュボード
# フィルターとオプション
ccusage daily --since 20250525 --until 20250530 # 期間指定フィルター
ccusage daily --json # JSON形式での出力
ccusage daily --breakdown # モデル別コスト内訳
# プロジェクト分析
ccusage daily --instances # プロジェクト/インスタンス別にグループ化
ccusage daily --project myproject # 特定プロジェクトにフィルター
ccusage daily --instances --project myproject --json # 複合使用例
試しにライブ監視を実行してみたところ、以下の画像のようにリアルタイムでわかりやすく使用量を表示してくれました。
Claude Code Usage Monitor（リアルタイムダッシュボード型）
claude-monitor（Claude Code Usage Monitor）は、現在の5時間セッションごとのトークン使用量をリアルタイムで3秒ごとに自動更新。進捗バーや残トークン、警告表示まで備えています。
使い方
インストールと使い方
uv tool install claude-monitor
claude-monitor
インストールしてみた
% uv tool install claude-monitor
Resolved 16 packages in 1.50s
Prepared 14 packages in 3.71s
Installed 16 packages in 142ms
+ annotated-types==0.7.0
+ claude-monitor==3.0.4
+ markdown-it-py==3.0.0
+ mdurl==0.1.2
+ numpy==2.2.6
+ pydantic==2.11.7
+ pydantic-core==2.33.2
+ pydantic-settings==2.10.1
+ pygments==2.19.2
+ python-dotenv==1.1.1
+ pytz==2025.2
+ pyyaml==6.0.2
+ rich==14.0.0
+ tomli==2.2.1
+ typing-extensions==4.14.1
+ typing-inspection==0.4.1
Installed 5 executables: ccm, ccmonitor, claude-code-monitor, claude-monitor, cmonitor
warning: `/Users/xxxxx/.local/bin` is not on your PATH. To use installed tools, run `export PATH="/Users/xxxxx/.local/bin:$PATH"` or `uv tool update-shell`.
% uv tool update-shell
実行してみると・・・
Claude Code を動かしてみる
結構見やすくて良い感じですね🎉
オプションも色々あるみたいですが自分は Pro プランなのでこんなオプションで起動するのが良さそう！
claude-monitor --plan pro --timezone Asia/Tokyo
最後に
今回は Claude Code の現在の使用量がわかるツール２つを試してみました💪
自分の好みとしては Claude Code Usage Monitor でした🕺
ぜひ試してみてください！
Discussion