cost-tracking

name cost-tracking description ローカルのコスト追跡データベースからClaude Codeのトークン使用量、支出、予算を追跡・レポートします。コスト、支出、使用量、トークン、予算、またはプロジェクト、ツール、セッション、日付によるコスト内訳について質問する場合に使用します。 origin community コスト追跡 このスキルを使用して、ローカルSQLiteデータベースからClaude Codeのコストと使用履歴を分析します。これは、 ~/.claude-cost-tracker/usage.db に使用行を書き込むコスト追跡フックまたはプラグインをすでに持っているユーザーを対象としています。 出典: MayurBhavsar によるコミュニティのPR #1304から救済されました。 使用時期 ユーザーが「いくら使いましたか？」「このセッションのコストは？」「トークン使用量は？」と尋ねる場合 ユーザーが予算、支出制限、超過、またはコスト管理について言及する場合 ユーザーがプロジェクト、ツール、セッション、モデル、または日付ごとのコスト内訳を求める場合 ユーザーが今日と昨日を比較したい、または最近のトレンドを確認したい場合 ユーザーが最近の使用記録のCSVエクスポートを求める場合 動作方法 まず前提条件を確認します： command -v sqlite3 >/dev/null && echo "sqlite3 available" || echo "sqlite3 missing" test -f ~/.claude-cost-tracker/usage.db && echo "Database found" || echo "Database not found" データベースが見つからない場合、使用データを作成しません。ユーザーにコスト追跡が設定されていないことを伝え、信頼できるローカルコスト追跡フック/プラグインのインストールまたは有効化を提案します。 期待される usage テーブルには通常、ツール呼び出しまたはモデルインタラクションごとに1行が含まれます。列名はトラッカーによって異なりますが、以下の例では次のように仮定します： 列 意味 timestamp 使用イベントのISOタイムスタンプ project プロジェクトまたはリポジトリ名 tool_name ツールまたはイベント名 input_tokens 記録された場合の入力トークン数 output_tokens 記録された場合の出力トークン数 cost_usd USDで事前計算されたコスト session_id Claude Codeセッション識別子 model イベントに使用されたモデル cost_usd を使用して手動で価格計算するよりも優先します。モデルの価格とキャッシュ価格は時間とともに変化し、トラッカーが各行の価格設定の信頼できる情報源であるべきです。 例 クイックサマリー sqlite3 ~/.claude-cost-tracker/usage.db " SELECT 'Today: $' || ROUND(COALESCE(SUM(CASE WHEN date(timestamp) = date('now') THEN cost_usd END), 0), 4) || ' | Total: $' || ROUND(COALESCE(SUM(cost_usd), 0), 4) || ' | Calls: ' || COUNT(*) || ' | Sessions: ' || COUNT(DISTINCT session_id) FROM usage; " プロジェクト別コスト sqlite3 -header -column ~/.claude-cost-tracker/usage.db " SELECT project, ROUND(SUM(cost_usd), 4) AS cost, COUNT(*) AS calls FROM usage GROUP BY project ORDER BY cost DESC; " ツール別コスト sqlite3 -header -column ~/.claude-cost-tracker/usage.db " SELECT tool_name, ROUND(SUM(cost_usd), 4) AS cost, COUNT(*) AS calls FROM usage GROUP BY tool_name ORDER BY cost DESC; " 過去7日間 sqlite3 -header -column ~/.claude-cost-tracker/usage.db " SELECT date(timestamp) AS date, ROUND(SUM(cost_usd), 4) AS cost, COUNT(*) AS calls FROM usage GROUP BY date(timestamp) ORDER BY date DESC LIMIT 7; " セッション詳細 sqlite3 -header -column ~/.claude-cost-tracker/usage.db " SELECT session_id, MIN(timestamp) AS started, MAX(timestamp) AS ended, ROUND(SUM(cost_usd), 4) AS cost, COUNT(*) AS calls FROM usage GROUP BY session_id ORDER BY started DESC LIMIT 10; " レポートガイダンス コストデータを表示する場合、以下を含めます： 今日の支出と昨日の比較。 追跡されたデータベース全体の合計支出。 コスト順にランク付けされた上位プロジェクト。 コスト順にランク付けされた上位ツール。 十分なデータがある場合のセッション数とセッションごとの平均コスト。 少額の場合、通貨を小数点4桁でフォーマットします。大きな金額には2桁で十分です。 アンチパターン cost_usd が存在する場合に生のトークン数からコストを推定しないこと。 確認せずにデータベースが存在すると仮定しないこと。 大規模なデータベースで無制限の SELECT * エクスポートを実行しないこと。 ユーザー向けの回答で現在のモデル価格をハードコードしないこと。 任意のコードを実行する未審査のフックやプラグインのインストールを推奨しないこと。 関連 /cost-report - 同じデータベースを使用するコマンド形式のレポート。 cost-aware-llm-pipeline - モデルルーティングと予算設計のパターン。 token-budget-advisor - コンテキストとトークン予算の計画。 strategic-compact - 繰り返しのトークン支出を削減するためのコンテキスト圧縮。