claude-usage-analyst

Claude Usage Analyst

概要

このスキルは、ローカルの ccusage データに基づいて、根拠のある利用状況の説明を作成するために使用します。観測された数値と解釈を分け、クォータの消費状況をわかりやすく説明します。

ワークフロー

1. ccusage が利用可能か確認します。

   ccusage --version
   

   見つからない場合は、npm install -g ccusage@latest でインストールまたは更新するか、npx ccusage@latest で実行します。

2. 指定された期間について、付属の分析ツールを実行します。

   python3 /path/to/claude-usage-analyst/scripts/analyze_claude_usage.py \
     --since YYYY-MM-DD --until YYYY-MM-DD --timezone Asia/Shanghai
   

   --since/--until のデフォルトは、選択したタイムゾーンでの今日です。 過去の期間と比較する場合は、月の初日など、より前の日付を --since に指定します。そうしない場合、ランキングや中央値の項目は対象日のみを示します。

3. ユーザーが特定のモデル同士の比較を求めている場合は、エイリアスを渡します。

   python3 scripts/analyze_claude_usage.py --model-a fable --model-b opus-4-8
   

4. 最終回答を作成する際は、references/explanation-guide.md を読みます。

根拠に関するルール

• 数値に関する主張は、ccusage の出力または付属の分析ツールの出力に基づけます。
• 対象範囲を明記します。ccusage claude が測定するのは、ローカルの Claude Code 利用ログです。ローカルログが存在する場合は、Claude Desktop の Claude Code セッションも含まれます。通常の Claude.ai チャット利用分を完全に網羅した請求額ではありません。
• 日付にはタイムゾーンを付記します。
• キャッシュについて明確に説明します。キャッシュ読み取りトークンは、ユーザーがその文言を入力していなくても、利用量やクォータに影響します。
• ユーザーからプランの詳細が提供されていない限り、ローカルのトークン数から Anthropic のプランのクォータルールを推測しないでください。正確なプラン上の計算方法が不明な場合は、「クォータ相当の負荷」または「ccusage による推定コスト／トークン消費」と表現します。
• モデルを比較する際は、トークン量と推定コストの両方を比較します。トークン量が同程度でも、モデルによってコストが高くなる場合があります。

出力形式

ユーザーから別の指定がない限り、次の構成を使用します。

1. 平易な言葉での簡潔な結論。
2. 根拠を示す表：合計トークン数、コスト、入力、出力、キャッシュ作成、キャッシュ読み取り。
3. モデル比較表。
4. クォータの枯渇について説明する場合は、5 時間ブロックの表。
5. 消費が発生した理由の説明。
6. 確信度と注意事項。

専門知識のないユーザーにも読みやすい回答にします。「キャッシュ読み取り」などの用語は、一文で意味を説明せずに使用しないでください。