---
id: gh-cost-tracking
name: "cost-tracking"
url: https://skills.yangsir.net/skill/gh-cost-tracking
author: affaan-m
domain: finance
tags: ["cost-tracking", "budget-management", "usage-analysis", "sqlite", "financial-reporting"]
install_count: 1200
rating: 4.30 (120 reviews)
github: https://github.com/affaan-m/everything-claude-code/tree/main/docs/ja-JP/skills/cost-tracking
---

# cost-tracking

> 此技能用于分析和报告Claude Code的令牌使用量、支出和预算，数据来源于本地SQLite成本追踪数据库。它能帮助用户了解成本构成，追踪项目、工具、会话或日期维度的支出，并识别使用趋势，从而有效管理和优化AI资源成本。

**Stats**: 1,200 installs · 4.3/5 (120 reviews)

## Before / After 对比

### 成本分析效率

**Before**:

在没有此技能之前，用户难以准确了解Claude Code的令牌使用量和相关支出，无法按项目、工具或会话细分成本，导致预算超支风险高，且难以优化AI资源的使用效率。

**After**:

此技能能让用户清晰掌握AI资源成本，按需查看详细支出报告，及时发现并解决成本异常，有效控制预算，显著提升AI项目成本管理的透明度和效率。

| Metric | Before | After | Change |
|---|---|---|---|
| 成本分析时间 | 120分钟 | 5分钟 | -96% |

## Readme

# コスト追跡

このスキルを使用して、ローカルSQLiteデータベースからClaude Codeのコストと使用履歴を分析します。これは、`~/.claude-cost-tracker/usage.db`に使用行を書き込むコスト追跡フックまたはプラグインをすでに持っているユーザーを対象としています。

出典: `MayurBhavsar`によるコミュニティのPR #1304から救済されました。

## 使用時期

- ユーザーが「いくら使いましたか？」「このセッションのコストは？」「トークン使用量は？」と尋ねる場合
- ユーザーが予算、支出制限、超過、またはコスト管理について言及する場合
- ユーザーがプロジェクト、ツール、セッション、モデル、または日付ごとのコスト内訳を求める場合
- ユーザーが今日と昨日を比較したい、または最近のトレンドを確認したい場合
- ユーザーが最近の使用記録のCSVエクスポートを求める場合

## 動作方法

まず前提条件を確認します：

```bash
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`を使用して手動で価格計算するよりも優先します。モデルの価格とキャッシュ価格は時間とともに変化し、トラッカーが各行の価格設定の信頼できる情報源であるべきです。

## 例

### クイックサマリー

```bash
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;
"
```

### プロジェクト別コスト

```bash
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;
"
```

### ツール別コスト

```bash
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日間

```bash
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;
"
```

### セッション詳細

```bash
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;
"
```

## レポートガイダンス

コストデータを表示する場合、以下を含めます：

1. 今日の支出と昨日の比較。
2. 追跡されたデータベース全体の合計支出。
3. コスト順にランク付けされた上位プロジェクト。
4. コスト順にランク付けされた上位ツール。
5. 十分なデータがある場合のセッション数とセッションごとの平均コスト。

少額の場合、通貨を小数点4桁でフォーマットします。大きな金額には2桁で十分です。

## アンチパターン

- `cost_usd`が存在する場合に生のトークン数からコストを推定しないこと。
- 確認せずにデータベースが存在すると仮定しないこと。
- 大規模なデータベースで無制限の`SELECT *`エクスポートを実行しないこと。
- ユーザー向けの回答で現在のモデル価格をハードコードしないこと。
- 任意のコードを実行する未審査のフックやプラグインのインストールを推奨しないこと。

## 関連

- `/cost-report` - 同じデータベースを使用するコマンド形式のレポート。
- `cost-aware-llm-pipeline` - モデルルーティングと予算設計のパターン。
- `token-budget-advisor` - コンテキストとトークン予算の計画。
- `strategic-compact` - 繰り返しのトークン支出を削減するためのコンテキスト圧縮。


---
*Source: https://skills.yangsir.net/skill/gh-cost-tracking*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-cost-tracking/markdown*