Claude Code 使用量モニター – 使用量制限回避のためのリアルタイムトラッカー

 (github.com/Maciek-roboblog)
12 ポイント 投稿者 GN⁺ 2025-06-21 | 2件のコメント | WhatsAppで共有
  • Claude AIのトークン使用量、消費速度、消費予測など多様な情報をリアルタイムでターミナルに表示するモニタリングツール
  • 3秒ごとに更新されるカラフルなプログレスバー、スマートなトークン消費予測
  • 基本プランの上限を超えた場合、セッション記録を分析して実際の上限に即座に切り替え
  • Pro/Max5/Max20/custom_max などの使用量プランを自動検出してサポート
  • セッションごとのトークン上限接近・超過、セッションリセット前の消費リスクをリアルタイムで通知
  • 実際のClaude使用フローに最適化されたインターフェースを実装
  • npm, pip でインストール可能、仮想環境（venv/virtualenv）の利用を推奨、Mac/Linux/Windowsをすべてサポート

Claudeセッションを理解する

  • 5時間ローリングウィンドウ方式
    • 最初のメッセージを送った時点からセッションは5時間継続
    • セッションごとに上限が適用され、複数を同時に有効化可能
    • 実際のリセットは自分のメッセージ基準で5時間ごとに発生
  • セッション/トークンのリセット時刻基準を自分のスケジュールに合わせて指定可能

活用シナリオ

  • 出勤/午前開発者: 業務開始時刻（例: 9時）に合わせてトークンリセットのスケジュールを調整し、効率的に計画可能
  • 夜間作業者: 深夜0時など自分のスケジュールに合わせたトークンリセットを利用
  • 可変上限ユーザー: custom_maxモードで実際の環境に合った上限を自動検出
  • グローバル/リモート開発者: 複数タイムゾーンの移動やチーム単位でのリセット時刻指定により、協業を最適化
  • 素早い状態確認: 単純実行（設定不要）

環境構築のベストプラクティス

  • セッション開始と同時にモニタリング開始
    • Claudeでの作業を始めるときにすぐモニターを実行 (./ccusage_monitor.py)
    • 対応プラン
      • pro: 約7,000トークン（テストおよび軽量利用）
      • max5: 約35,000トークン（日常的な開発）
      • max20: 約140,000トークン（大規模プロジェクトおよび中〜高強度の利用）
      • custom_max: 自動検出モード（実際の利用履歴に基づく最大値を使用）
    • セッション全体のトークン追跡精度が向上
    • トークン消費速度の計算と、上限接近時の早期警告が可能
  • Python仮想環境（venv）を使用
    • 依存関係の衝突防止、環境の分離、プロジェクトごとの再現性を保証
    • インストールと実行: 
      python3 -m venv venv  
source venv/bin/activate  
pip install pytz
    • 削除時は仮想環境フォルダだけ消せばクリーンにアンインストール可能
  • シェルAliasをカスタム登録
    • 繰り返し使うコマンドを1行で短縮実行 
      alias claude-monitor='cd ~/Claude-Code-Usage-Monitor && source venv/bin/activate && ./ccusage_monitor.py'
    • .bashrc または .zshrc などに追加すれば、1回の入力ですぐにモニターを起動可能

使用方法のベストプラクティス

  • Burn Rate（消費速度）を常時モニタリング
    • トークン使用量が急激に跳ね上がる場合は注意
    • 残り時間・残トークン量に応じて作業強度を調整
    • セッションリセット（トークン初期化）の前後に、大規模リファクタリングなど大きな作業の予定を調整
  • 戦略的なセッションスケジューリング
    • 大規模作業はトークンリセット直後に開始し、上限接近時には軽い作業を実施 
      ./ccusage_monitor.py --reset-hour 9
    • セッションごとの5時間ルールを活用して複数セッションを重ねて運用可能
  • タイムゾーンを明確に指定
    • 実際の勤務/協業時間帯を反映し、正確なトークンリセット予測とスケジュール管理を実現 
      ./ccusage_monitor.py --timezone Asia/Seoul
    • 複数の国・チームと協業する際の時差ミスを防ぎ、セッション満了時刻の混乱を最小化

最適化のヒント

  • ターミナル環境の設定
    • 最低80文字幅のターミナルを推奨
    • カラー対応で視覚的フィードバックを最大化
    • 専用ウィンドウで常時モニタリングする運用を推奨
  • ワークフロー統合
    • tmux などのターミナルマルチプレクサを活用し、開発と同時にモニタリング可能 
      tmux new-session -d -s claude-monitor './ccusage_monitor.py'  
tmux attach -t claude-monitor
  • マルチセッション戦略
    • セッションごとに5時間固定で、重複セッションの同時管理が可能
    • 長時間作業は複数セッションに分散し、各セッションの上限/満了に注意

実際のワークフロー例

  • 大規模プロジェクト開発 
    ./ccusage_monitor.py --plan max20 --reset-hour 8 --timezone America/New_York
    • 午前8時にトークンリセット → 主要機能の開発を開始
    • 10時にBurn Rateを確認して作業速度を調整
    • 12時に午後の予定を確認・調整
    • 14時に新しいセッションを開き、複雑な課題に対応
    • 16時に軽作業/夜のセッション準備
  • 学習/実験中心の利用 
    ./ccusage_monitor.py --plan pro
    • 軽い学習や実験的なコード作成に適している
  • スプリント集中開発 
    ./ccusage_monitor.py --plan max20 --reset-hour 6
    • 集中的に大量のトークン消費が見込まれる開発向けに最適化した設定

関連記事

2件のコメント

 
fanotify 2025-06-21

同じものですね: https://ja.news.hada.io/topic?id=21560
 
GN⁺ 2025-06-21
Hacker Newsの意見

  • Claudeの透明性不足にもどかしさを感じており、このアイデアはとても気に入ったという意見 Claude Codeの中核的な価値は、デスクトップアプリと比べてコンテキストや制限をより適切に管理できること（例: compactモード、残量%表示）にあるが、まだ十分ではないと感じる 追加の感想として、プロジェクトのREADMEで絵文字が多用されているのは個人的にかなりプロらしくなく見え、AIが適切に管理されないまま「雰囲気」だけでコーディングされたプロジェクトのように思えて不安になるという意見

    • 自分がソフトウェア業界に入った頃は、コードベースで絵文字を使っているのが見つかったら精神病院送りにされるくらいの空気だった 今では時代が大きく変わり、絵文字を視覚的な文脈整理のためによく使っている いまや自分のコードには、自分を幸せにしてくれるくらいたくさんの絵文字が入っている

    • 最近のスタートアップや若い会社では、こういう絵文字スタイルをよく見かける おそらくNotionの影響が大きい うちの会社では、リストやページ、カレンダー招待を1つ作るときでさえ、いつも絵文字を選ぶのが特徴になっている

    • AIコーディング向けに作られたソフトウェアにこういうコメントが付くのは、なんとも皮肉だという感想

    • 実際にコードを見ると、400行のPythonファイル1つが単に ccusage をラップしているだけ だからそう感じるのも無理はないと思う

    • AIが作るPR説明やREADMEには、プロンプトに「簡潔に、派手な修飾や絵文字なしで」と必ず入れる そうすると散漫だった絵文字パーティーが、きちんとしたドキュメントに変わる 状況次第ではある

  • 自分はccusageの作者だと名乗りつつ、人々が自分たちのオープンソースをいろいろな形で使ってくれてうれしいという感想 Happy vibe coding! という前向きなメッセージを残す

    • 不思議なことに、ccusageのShow HNにはコメントが1つもないのに、このスレッドはとても活発なのが面白い 関連スレッドへのリンク

  • 参考までに、過去の自分のセッションでの最大トークン上限は約337,492で、Max20プランとOpusを99%くらい使っているという体験談 5月27日からClaude Codeを使っていて、これまでに使った総トークン数は1,374,439,311、金額にすると約3,397ドル

    • 自分はMax20プランで約2,100ドル分ほど使った APIでとてつもないマージンが出ているのか、それとも赤字なのか気になる 毎日使っているが、使いすぎだとは思っていない

    • Opusで頻繁にレート制限に当たらないのか、Sonnetより遅いと感じないのか気になる

  • これまでに使ったトークン量から、リミットにどれだけ近いかを直感的に把握できる 会話自体が上限に達しそうな瞬間も察知でき、そのときは最後に残ったリソースで要約を作ってから新しい会話に引き継いで作業を続ける こうしたAIツールが、今では自分の体内時計の一部になったように感じる 毎週水曜日にChatGPTの週間リミットがリセットされるので、水曜日が新しい日曜日のように感じられるという体験

  • トークン使用量は、時間ウィンドウが過ぎても100%に到達していないとリセットされないことに気づいた たとえば90%使った状態で次のウィンドウに入り、残り10%をすぐ使い切ると、長時間待たされる問題がある

  • 自分は複数のClaude Codeセッションを同時に使えるようにするUIツール（crystal）を作った 複数の機能を並行して作業するので、アカウントの上限に頻繁に達してしまう たいていはリセット時間の近くで上限に当たるが、いつ休むべきか事前にわかるともっといいと感じる

    • Claude Codeをものすごく多用しているが、worktreeや複数セッション作業のためのツールを自作する自信は、gitの理解が足りないので持てない 正直このツールを使うのも少し怖いが、理想を言えば各worktreeをコンテナで回したい ただ、Crystalほどスムーズに動くものを作るのは難しそうだという感想

    • このツールは好きだが、Crystalは以前からあるプログラミング言語の名前でもあるので紛らわしい

    • GitHubにissueを残してくれれば（こちら）、自分のusage monitorとの連携も試してみることができる

    • すごい、という感嘆 自分もプロジェクト単位ではなく、同時進行の5つのプロジェクト向けにこういうツールがあればいいのにと、Laudeに作らせそうになったことがあるという体験 活用の機会が多いことに共感

  • とても興味深いが、Proプランのトークン制限は本当に7,000しかないのか気になる つまり7,000語にも満たないことになるが、実際にはもっとずっと使える感じがする それだと会話が少し長くなっただけですぐ上限に達しそうだが、自分はまだ一度もぶつかったことがない もしかしてClaude Codeにだけ適用される制限なのか、 まだClaude Codeをあまり使っていないのでよくわからないという意見

    • Proプランは月額$20。最近claude codeへのアクセスが可能になった ただ、数回のクエリだけで一部ユーザーはリミットに達するという話を聞いた なので、そのくらいの数値でもおかしくない気がする チャットインターフェースの制限とClaude Codeの制限は別物

  • 素晴らしい出来だと感心し、作ってくれたことに感謝 uvでインストールできるか気になる uv のリンク共有とともに、インストール手順を1行ずつ整理したシェルコマンド例を共有

    • もしそのリポジトリがproject.tomlなどのパッケージ構造になっていれば、pipx（pipx）で次のようにもっと手早くインストールできたはずだという説明

pipx install git+https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor ccusage_monitor uvにもこれに似たコマンド（uvx）があるはずだが、pipxと同じ機能・目的なのかはよくわからないという意見

  • ちなみに、pipでインストールできるほぼすべてのものはuvでもインストールできるので、uvでもより簡単にできるという補足

  • このツールには、ccusage をシェル呼び出しして実行する以外に何か有用な点があるのか気になる 正直こういうタイプのプロジェクトには少しがっかりしていて、AIツールで一発で作って終わらせたようにも見える Show HNでは、実際の作業のすべてが別ツールで処理されていることに一切触れられていないのが残念

  • 昨日Claude Codeで妙な体験をした 古いPHPで書かれたphtmlのテーブルページを新しいdivレイアウトに変換しようとして失敗し、4ドルほど消費したという経験 WSLの問題かもしれないが、こういうことが頻繁に起きないことを願っている

    • Claude Codeにはかなり学習コストがある 要件を十分に議論し、モデルが明確な質問を返せるように導きながら長い対話セッションを進める必要がある それでも時々こうした失敗は起こり得るので、非常に高価なツールだという点は忘れないほうがいい YouTuberやブロガーが言うような魔法ではない、という指摘