Przejdź do treści
Biblioteka skilli
AI i agenci · Analiza

cost-tracking

/cost-tracking

Śledzi i raportuje zużycie tokenów, wydatki i budżety Claude Code z lokalnej bazy danych kosztów, z podziałem na projekt, narzędzie, sesję i datę.

Repozytorium
ECC ↗
Licencja
MIT
Ostatnia zmiana repozytorium
20.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 20.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Śledzi i raportuje zużycie tokenów, wydatki i budżety Claude Code z lokalnej bazy danych kosztów, z podziałem na projekt, narzędzie, sesję i datę.

Oryginalny opis (EN)

ローカルのコスト追跡データベースからClaude Codeのトークン使用量、支出、予算を追跡・レポートします。コスト、支出、使用量、トークン、予算、またはプロジェクト、ツール、セッション、日付によるコスト内訳について質問する場合に使用します。

Jak działa

  1. 使用時期
  2. 動作方法
  3. 例
  4. レポートガイダンス
  5. アンチパターン
  6. 関連
Sekcje z nagłówków SKILL.md, w oryginale · 133 linii, 321 słów
Podgląd SKILL.md
---
name: cost-tracking
description: ローカルのコスト追跡データベースからClaude Codeのトークン使用量、支出、予算を追跡・レポートします。コスト、支出、使用量、トークン、予算、またはプロジェクト、ツール、セッション、日付によるコスト内訳について質問する場合に使用します。
origin: community
---

# コスト追跡

このスキルを使用して、ローカル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` - 繰り返しのトークン支出を削減するためのコンテキスト圧縮。

Wersje

RepozytoriumWynikLicencja
Ta strona · affaan-m/ECC100MIT
ericrisco/rsc-harness100MIT
affaan-m/ECC100MIT
Habitat-Thinking/ai-literacy-superpowers100Apache-2.0
SHRIJANAGAIN/Nemo-Cli100Apache-2.0
ginaservice/ginaservice-skills100MIT
jbdamask/john-claude-skills100MIT
S3YED/appie-kit100MIT
aaione/everything-claude-code-zh100MIT

Migawka bazy z 13.11.2026 · wersja paczki f8dde89bfe37 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100hatch3r-cost-tracking
    Śledzi zużycie tokenów i szacuje koszty sesji agentów, przy monitorowaniu wydatków, zbliżaniu się do limitów budżetu i tworzeniu raportów kosztów.
  • 100cost-report
    Raportuje rzeczywiste zużycie tokenów i koszt w dolarach zleconej pracy, według agenta i łącznie, oraz wykrywa regresje kosztów po przeglądzie kodu lub orkiestracji.
  • 90session-budget
    Śledzi budżet tokenów i koszt sesji, monitorując zużycie API oraz koszty obliczeń.
  • 98agent-cost-budgeting
    Pilnuje kosztów agentów AI: ustawia limity zużycia tokenów, śledzi wydatki i zapobiega nieplanowanym rachunkom za API.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.