プログラミング
Show HN: Claudeのクォータが10分で枯渇したので、その理由を見つけるツールを作成しました
Show HN: My Claude quota ran out in 10 minutes, so I made a tool to find out why (github.com)
要約
このツール「tare」は、Claude Codeのログを読み取り、ユーザーがトークン使用量の内訳を理解できるようにします。クォータ超過の原因、どのプロジェクトがトークンを消費しているか、どのモデルが最もコストがかかるかなどを、自然言語で質問することで明らかにできます。プライバシーを重視し、すべての処理はローカルマシンで行われ、データは外部に送信されません。
全文翻訳
tare Ask Claude Codeで、どこで利用状況が発生したかを確認してください。
利用制限に達したが、理由がわからない。
クォータが以前より速く消費される。
バックグラウンドで何かがトークンを消費していると疑っている。
これらすべてに答えるレコードは、すでにあなたのコンピュータ上にあります — Claude Codeは、それが生成するすべてのリクエストのログを保持しています。
tareはClaude Codeに自身のログを読むように教えるため、あなたはただ尋ねるだけで済みます。ダッシュボードも、覚えるべきコマンドもありません。
一度インストールすれば、プレーンな英語で質問できます。
Tare: コンテナの重さ、中身を見つけるために差し引かれたもの。
セッションのコストの大部分はコンテナ — 何度も再送信されるコンテキスト — であり、これらのツールがまさに差し引くものです。
インストール
任意のターミナルで1つのコマンドを実行します。
npx skills add kelviq/tare -g -y --copy --agent claude-code
これで完了です。他にセットアップする必要はありません — アカウント、パッケージ、設定も不要です。
新しいClaude Codeセッションを開始すると、ライブで利用可能になります — /を入力して、tareが表示されるか確認してください。表示されない場合は、トラブルシューティングのノートを参照してください — Claude Codeがスキルを一度もインストールしたことのないマシンでは、インストーラが失敗することがあります。(手動、チーム全体、またはClaude Codeプラグインとしてのインストール方法については、INSTALL.mdを参照してください。)
その後、ただ質問するだけです。
Claude Codeを開き、人に話しかけるように質問してください。これらはすべて機能します — 言葉が一致する必要はありません。制限について不満を言うだけで十分です。
制限に達したとき
昨日、なぜ利用制限に達したのですか?
夜のセッション開始10分でロックアウトされました — どうしてですか?
5時間の制限に達しましたか、それとも週ごとの上限ですか?
今週、なぜクォータの消費がこんなに速いのですか?
トークンがどこへ行くか
今週、私のトークンは実際どこへ行きましたか?
私のどのプロジェクトがクォータを消費していますか?
どのモデルが最もコストがかかっていますか?
Claudeが再読し続けている最も高価なファイルは何ですか?
昨日の巨大なセッションは実際いくらかかりましたか?
私のMCPサーバーはコンテキストにかなりのオーバーヘッドを追加していますか?
サブエージェントとスキルはどれくらいのオーバーヘッドを追加しますか?
大きなことを始める前に
私の5時間ウィンドウは現在どれくらい埋まっていますか?
大きなリファクタリングを開始しても安全ですか、それともウィンドウがクリアされるのを待つべきですか?
忘れたものをチェックする
バックグラウンドでClaude Codeを実行しているものはありますか?
私が眠っている間にClaude Codeはアクティブでしたか?
1ヶ月前に自動化を設定しました — それはいくらかかっていますか?
設定の調整
タスク間に/clearを使用し始めました — 本当に役立ちましたか?
今週と先週を比較してください。
最新のClaude Codeアップデートは私の利用状況を変更しましたか?
APIで直接支払うとしたら、私の利用状況はいくらになりますか?
どの1つの変更が最も節約になりますか?
レポートと共有
ブラウザで開ける利用状況レポートを作成してください。
公開できる要約を作成してください — プライベートなものは何も含めないでください。
私の利用状況をスプレッドシートにエクスポートしてください。
コマンド入力の方が好きですか?
/tareは完全な診断を実行し、一般的な質問に対するバリアントも取ります — 自然言語での質問も常に機能します。
/tare full diagnosis — トークンがどこへ行き、なぜか
/tare usage at-a-glance panel — /usageのように、帰属表示付き
/tare window 5時間ウィンドウはどれくらい埋まっているか — 開始しても安全か?
/tare report [days] HTMLレポートをビルドして開く
/tare tools [days] コンテキストを埋めているものは何か
/tare week 今週と先週を比較
/tare share [days] 公開可能な匿名化された要約
/tare why did I hit the limit yesterday どんな質問でも引数として機能します
返ってくるもの
数字の羅列ではなく — 原因です。
「昨日、なぜ利用制限に達したのですか?」という質問への回答は次のようになります。
昨日の利用状況の99%は、あなたからではなく、あなたが実行しているツールから来ていました。あなたのウェブサイトプロジェクトで、何かが1,553回の短いClaude Codeセッションを生成しました — 9,022リクエスト、同時に最大51セッション実行。その日のあなたの直接の作業は93リクエストでした。各新しいセッションはコンテキストをゼロから再構築するため、トークンを消費する最も高価な方法です...
...それに続く証拠、確認すべきこと、変更すべきことです。そして、すべてが実際には問題ない場合、それは次のように述べています:利用状況は比例しており、異常はなく、これがあなたにとっての通常の状態です。
実際の出力はexamples/にあります — /tare shareによって生成される共有可能な要約と、HTMLレポートです。
生のトークン数ではわからないこと
正確な合計値。Claude Codeのログ形式は各API応答を数回繰り返します。単純なカウントは合計値を誇張します(このデータでは86%増加)。tareは適切に重複排除します。
コンテキストの真のコスト。長いセッションの早い段階で読み込まれたファイルは、後続のすべてのメッセージで再送信されます。tareは、ツールが返しただけでなく、原因となったものに対しても料金を請求します — これにより、早い段階での1つの大きなファイル読み込みが1週間を静かに支配することがあります。
ローリングウィンドウ。制限は、あなたが離れてもリセットされません。4時間前の作業もカウントされます。tareは、ロックアウトされた瞬間にウィンドウがどれだけ満たされていたかを教えてくれます。
自動化の形状。数百回の短い並列セッションはスクリプトであり、人ではありません。tareはそのシグネチャを認識し、それを伝えます。
プライバシー重視
すべてはあなたのマシン上で実行され、何もそこから出ません。スクリプトはネットワーク接続を一切行いません。共有可能な要約を要求した場合、合計値、日付、ツール名のみが含まれます — プロンプト、ファイルパスや内容、コマンド、セッションやアカウント識別子は含まれません — そのため、公開したり同僚に送信して「何を見落としていますか?」と尋ねることができます。それを鵜呑みにしないでください:SECURITY.mdには、各ファイルが何を読み取り、書き込み、送信するかを正確に記載しており、grep1つでそのすべての主張を自分で検証する方法を示しています。
要件
macOSまたはLinux上のClaude Code
Python 3.9+ — すべてのMacに既に存在します。インストールするパッケージはありません
現在、Claude Codeのログのみを読み取ります。他のコーディングエージェントのログは読み取りません。
デモ
tare-screen-recording.mp4
開発者向け
スキルが行うすべてのことは、手動でも実行できます。依存関係のない3つのPythonスクリプトがあり、スクリプト作成、cron、CSVエクスポート、ライブリクエストごとのテレメトリなどのレシピが含まれています — CLI.mdを参照してください。
IssueとPRは歓迎です。
有用な方向性:ライブTUI、Windowsパス、単一の個人では見つけられないパターンを発見するために匿名化された要約を集計すること、およびツール結果のより良いトークン推定。
MITライセンス。