Show HN: Claude Code 使用モニター – 使用制限を回避するためのリアルタイムトラッカー

325日前原文(github.com)

概要

Claude Code Usage Monitorは Claude AIのトークン使用量 をリアルタイムで監視するツール
美しい進捗バー や警告機能、予測機能を搭載
複数プラン対応、自動プラン検出やカスタムリセット時間も設定可能
ローカル動作 でセキュリティ・プライバシーも安心
GitHubで オープンソース として公開、導入・運用が簡単

Claude Code Usage Monitor 概要

Claude AIのトークン消費量 をリアルタイムで監視するターミナルツール
進捗バーや警告表示 で視覚的にトークンや残り時間を把握可能
消費速度（Burn Rate）解析 により、トークン枯渇予測
Pro/Max5/Max20/カスタム自動検出 など複数プランに対応
ローカル実行型 で認証不要、セキュリティ重視の設計

主な特徴

3秒ごと のリアルタイム更新で最新状況を即時反映
色分けされた進捗バー でトークン・時間の消費状況を一目で確認
消費速度から枯渇時刻を予測、リセット前の警告も自動表示
プラン自動検出機能 で実際の上限値を自動反映
リセット時刻やタイムゾーン を柔軟にカスタマイズ可能
複数セッション同時監視 や、セッションごとの消費傾向分析

インストール手順

クイックテスト用（非推奨）
- npm install -g ccusage
- pip install pytz
- git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git
- cd Claude-Code-Usage-Monitor
- python ccusage_monitor.py
本番運用推奨セットアップ
- Python 3.6+、Node.jsのインストール
- 仮想環境（venv/virtualenv）利用推奨
  - 依存関係の分離・再現性・クリーンなアンインストール・チーム共通環境
- 仮想環境作成例:
  - python3 -m venv venv
  - source venv/bin/activate（Linux/Mac）
  - venv\Scripts\activate（Windows）
- 必要パッケージのインストール
  - pip install pytz
- 実行: python ccusage_monitor.py

基本的な使い方・設定

標準（Proプラン）で起動: ./ccusage_monitor.py
プラン指定起動:
- Pro: ./ccusage_monitor.py --plan pro
- Max5: ./ccusage_monitor.py --plan max5
- Max20: ./ccusage_monitor.py --plan max20
- カスタム自動検出: ./ccusage_monitor.py --plan custom_max
リセット時刻指定: ./ccusage_monitor.py --reset-hour 3
タイムゾーン指定: ./ccusage_monitor.py --timezone Asia/Tokyo
終了方法: Ctrl+C

対応プランとトークン上限

| プラン名 | 上限トークン数 | 用途例 | |:--------------|:--------------|:----------------------------| | pro | 約7,000 | 軽めの利用・テスト | | max5 | 約35,000 | 通常開発・中規模プロジェクト | | max20 | 約140,000 | 大規模開発・ヘビーユース | | custom_max | 自動検出 | 上限が不明な場合・変動時 |

主要機能・仕組み

リアルタイム監視: 3秒ごとに最新消費量を取得、画面を滑らかに更新
進捗バー: トークン進捗・時間進捗を色分け表示、消費速度も可視化
予測機能: 現在の消費ペースから枯渇時刻を算出、リセット前警告
自動プラン切替: Pro上限超過時にcustom_maxへ自動スイッチ
セッション理解:
- Claudeは 5時間ローリングウィンドウ制 （初回メッセージから5時間有効）
- セッションごとに 複数同時進行 も可能
- リセット参考時刻（タイムゾーン依存）: 04:00, 09:00, 14:00, 18:00, 23:00
消費速度計算: 過去1時間の全セッションからトレンド・消費量を分析

代表的な利用シナリオ

朝型開発者: 出社時刻に合わせてリセット（例: 9時にリセット）
夜型コーダー: 深夜作業に合わせてリセット（例: 0時や23時）
上限不明ユーザー: custom_maxで自動検出・実態把握
海外/出張ユーザー: タイムゾーン指定でどこでも正確なリセット管理
とりあえず現状確認: ./ccusage_monitor.py で即座に状況把握

ベストプラクティス・運用Tips

開始時から監視: セッション開始直後から監視で精度向上
仮想環境利用: 依存関係トラブル防止・再現性確保
シェルエイリアス活用: alias claude-monitor='cd ~/Claude-Code-Usage-Monitor && source venv/bin/activate && ./ccusage_monitor.py'
消費速度の監視: 急増時はコーディングペース調整
リセット直後に重作業: セッションリセットを活用した効率的な作業計画
タイムゾーン正確設定: ローカル時間に合わせて運用最適化
ターミナル幅80文字以上推奨: カラー表示や見やすさ向上

補足・連絡先

GitHubリポジトリ: https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor
フィードバック・バグ報告・PR歓迎
完全ローカル動作 でプライバシー安心、認証・外部通信不要
JSON編集でプランカスタマイズ も可能

まとめ

Claude Codeのトークン上限問題 に悩む開発者に最適な監視ツール
簡単導入・多機能・高い柔軟性 であらゆる利用パターンに対応
オープンソース・ローカル完結型 で安心して運用可能
日々の作業効率とトラブル防止 に大きく貢献する実用的なユーティリティ

Hackerたちの意見

これいいね！同時にClaude Codeのセッションを動かすためのUIツールを作ったんだけど（https://github.com/stravu/crystal）、複数の機能を同時に進めてたら、アカウントの上限に達しちゃったんだ。リセットの直前になることが多いけど、いつ休憩を取るべきか分かるといいな。

└

GitHubで書いてくれるか、ここに問題を作ってくれたら嬉しいな。https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor... 君のツールを使用モニターと統合する方法を考えてみよう。

└

すごいね！ちょうどLaudeにこんなのを書いてもらおうと思ってたんだ。プロジェクトの中だけじゃなくて、同時に開いてる5つのプロジェクトについてもね。良いものが多すぎるって感じかな。

└

これ素晴らしいね。私はかなりの量のクラウドコードを使ってるけど、ワークツリーや複数のセッション周りのツールを自分で作るのがちょっと怖いんだ。Gitを十分に理解してないからね。正直、これを使うのも少し怖い。理想的には、各ワークツリーもコンテナで動かすべきだと思うけど、これほどスムーズに動かすのはかなり難しそうだね。

└

これいいけど、クリスタルってもう別のプログラミング言語の名前なんだよね…

このアイデアすごく好き！Claudeの透明性がイライラするから。Claude Codeのキラーフィーチャーは、デスクトップアプリに比べてコンテキストや制限を管理するためのより良いツールにあるけど（コンパクト化と自動コンパクトまでの残り%）、それだけじゃ足りないんだ。もしアドバイスできることがあれば、プロジェクトのREADMEに絵文字を多用するのは（少なくとも私にとっては）プロフェッショナルに見えなくて心配になるってこと。AIがちゃんと管理されてなかったんじゃないかって思っちゃうんだよね。でも、これは私の意見ね。

└

私がソフトウェアに入った頃は、コードベースで絵文字を使ってるのが見つかったら精神病院に送られる時代だったんだ。時代は変わったね…今は絵文字を使うことで、もっと視覚的にコンテキストを整理できるから、定期的に使ってるよ。コードには今、私をハッピーにするためのたくさんの絵文字があるんだ。

└

すごくプロっぽくなくて、プロジェクトが「バイブコード」されたんじゃないかって心配になる。AIがちゃんと監視されてない気がするから。まあ、これは私の意見だけどね。AIコーディング専用のソフトウェアに対するこういうコメントの皮肉…

└

若い企業や小さなスタートアップの今の美学って感じがするな。Notionの影響を受けてるかも。今の会社では、誰もリストやページ、カレンダーの招待を作るときに絵文字を選ばないといけないんだ。

└

AI生成のPR説明やREADMEには、このプロンプトの追加が定番だね：簡潔に、無駄な表現なし、絵文字なし。それで、だらだらした絵文字の祭りが適切なドキュメントに変わるよ。人によって違うかもだけど。

└

コードを実際に見ると、たったの400行のPythonファイルで、https://github.com/ryoppippi/ccusage をラップしてるだけだから、可能だよ。

すごく neat！Proの制限って本当に7000トークンだけなの？つまり7000単語未満ってこと？もっと使える気がするんだけど。継続的なチャットだとすぐに上限に達しそうだけど、私はそれに達したことはないんだ。これってClaude Code特有の制限なのかな？まだClaude Codeをあまり使ってないから。

└

プロプランは最近、クラウドコードへのアクセスを許可し始めた月額20ドルのプランなんだけど、ユーザーが数回のクエリでレート制限に引っかかるって聞いたよ。だから、個人的にはそれが妥当だと思う。チャットインターフェースにはクラウドコードとは別の制限があるからね。

こんなのがCursorにあったらいいな。今月のクレジットがどれくらい残ってるのか、Maxコールがどれくらいのコストになってるのか全然わからないんだ。

└

こんなのがCursorにあったらいいな。今月のクレジットがどれくらい残ってるのか、Maxコールがどれくらいのコストになってるのか全然わからないんだ。これは設計上そうなってると思うよ。

いい船だね！OTelを使ってチームのトレンドを観察する方法についてブログを書いたけど、個人の成長には君の方法の方が好きだな！

└

この解決策いいね！OTelをいじって、非公開のプロンプトやレスポンスを得ようとしたけど、うまくいかなかったんだ。もしかして、どんなデータが役に立ったかもっと深く掘り下げた？

参考までに、過去の最大セッション制限は約337,492トークンで、Max20プランを使ってて99%はOpusを利用してるよ。5月27日からクラウドコードを使い始めてからの総トークン使用量は1,374,439,311で、約3397.34ドル相当だよ。

└

Max20プランで約2100ドル相当使ってるんだけど、APIのマージンってめっちゃ大きいの？それともただお金を失ってるだけ？毎日使ってるけど、使いすぎてる感じはしないんだよね。

すごい、これ作ってくれてありがとう！uvでインストールできるのかな？ https://github.com/astral-sh/uv 編集: # uvをインストール curl -LsSf https://astral.sh/uv/install.sh | sh # 必要なCLIツール（Node.js）をインストール npm install -g ccusage # クローンしてセットアップ git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git cd Claude-Code-Usage-Monitor # uvでPythonの依存関係をインストール uv add pytz chmod +x ccusage_monitor.py # 実行 uv run python ccusage_monitor.py --plan max20 --timezone America/New_York

└

これには感謝だけど、参考までに言うと、pipでインストールできるものは基本的にuvでインストールするのも簡単（むしろ簡単かも）だよ。

トークンの使用量が時間ウィンドウの後にリセットされないのに気づいた。100%に達しない限りリセットされないみたい。例えば、90%使ってウィンドウを過ぎて、残りの10%をすぐに使い切ったら、長い間待たなきゃいけないのは問題だよね。

昨日、Claude Codeでちょっと変な体験をした。古いPHPのシンプルなphtmlテーブルページを新しいdivレイアウトに変換しようとしたけど、うまくいかなくて4ドル消費しちゃった。WSLの問題かもしれないけど、これ以上は起こらないでほしいな。

└

Claude Codeはちょっと学習曲線が急だね。セッションでは、要件についてかなり長いやり取りをして、モデルに明確な質問をするように促すべきだよ。それでも、たまにこういうことが起こるから注意が必要。YouTuberやブロガーが言うように、これは魔法のツールじゃないってことを忘れないで。

うーん、これってhttps://github.com/ryoppippi/ccusageに出す以外に何か役に立つことあるの？よくわからないけど、こういうのはちょっとがっかりするな。AIツールで一発で作った感じもするし、show hnでも実際の作業は他のツールがやってるってことには触れないんだね。

ハクソク