mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-18 23:03:06 +08:00
ec9ace9c54
Translate everything-claude-code repository to Japanese including: - 17 root documentation files - 60 agent documentation files - 80 command documentation files - 99 rule files across 18 language directories (common, angular, arkts, cpp, csharp, dart, fsharp, golang, java, kotlin, perl, php, python, ruby, rust, swift, typescript, web) - 199 skill documentation files Total: 455 files translated to Japanese with: - Consistent terminology glossary applied throughout - YAML field names preserved in English (name, description, etc.) - Code blocks and examples untouched (comments translated) - Markdown structure and relative links preserved - Professional translation maintaining technical accuracy This translation expands ECC accessibility to Japanese-speaking developers and teams. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
138 lines
5.7 KiB
Markdown
138 lines
5.7 KiB
Markdown
---
|
||
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` - 繰り返しのトークン支出を削減するためのコンテキスト圧縮。
|