コスト追跡
このスキルを使用して、ローカルSQLiteデータベースからClaude Codeのコストと使用履歴を分析します。これは、~/.claude-cost-tracker/usage.dbに使用行を書き込むコスト追跡フックまたはプラグインをすでに持っているユーザーを対象としています。
出典: MayurBhavsarによるコミュニティのPR #1304から救済されました。
使用時期
- ユーザーが「いくら使いましたか？」「このセッションのコストは？」「トークン使用量は？」と尋ねる場合
- ユーザーが予算、支出制限、超過、またはコスト管理について言及する場合
- ユーザーがプロジェクト、ツール、セッション、モデル、または日付ごとのコスト内訳を求める場合
- ユーザーが今日と昨日を比較したい、または最近のトレンドを確認したい場合
- ユーザーが最近の使用記録のCSVエクスポートを求める場合
動作方法
まず前提条件を確認します：
データベースが見つからない場合、使用データを作成しません。ユーザーにコスト追跡が設定されていないことを伝え、信頼できるローカルコスト追跡フック/プラグインのインストールまたは有効化を提案します。
期待されるusageテーブルには通常、ツール呼び出しまたはモデルインタラクションごとに1行が含まれます。列名はトラッカーによって異なりますが、以下の例では次のように仮定します：
cost_usdを使用して手動で価格計算するよりも優先します。モデルの価格とキャッシュ価格は時間とともに変化し、トラッカーが各行の価格設定の信頼できる情報源であるべきです。
例
クイックサマリー
プロジェクト別コスト
ツール別コスト
過去7日間
セッション詳細
レポートガイダンス
コストデータを表示する場合、以下を含めます：
- 今日の支出と昨日の比較。
- 追跡されたデータベース全体の合計支出。
- コスト順にランク付けされた上位プロジェクト。
- コスト順にランク付けされた上位ツール。
- 十分なデータがある場合のセッション数とセッションごとの平均コスト。
少額の場合、通貨を小数点4桁でフォーマットします。大きな金額には2桁で十分です。
アンチパターン
cost_usdが存在する場合に生のトークン数からコストを推定しないこと。- 確認せずにデータベースが存在すると仮定しないこと。
- 大規模なデータベースで無制限の
SELECT *エクスポートを実行しないこと。 - ユーザー向けの回答で現在のモデル価格をハードコードしないこと。
- 任意のコードを実行する未審査のフックやプラグインのインストールを推奨しないこと。
関連
/cost-report- 同じデータベースを使用するコマンド形式のレポート。cost-aware-llm-pipeline- モデルルーティングと予算設計のパターン。token-budget-advisor- コンテキストとトークン予算の計画。strategic-compact- 繰り返しのトークン支出を削減するためのコンテキスト圧縮。
