cost-report

cost-report — Claude Code コスト期間別ダッシュボード

cost-monitor plugin のダッシュボード生成 skill。任意期間の利用コストを構造化レポート (markdown / HTML) として出力する。cost-status が即時表示なのに対し、cost-report は 共有用 / 保管用 ファイル成果物 に重点。

実行手順

1. ユーザーから期間を聞き取る (なければ確認):

   • today / week / month / all のいずれか
   • もしくは YYYY-MM-DD ~ YYYY-MM-DD の任意範囲

2. 出力フォーマット確認:

   • markdown (デフォルト、コピペ・リポジトリ追加に最適)
   • html (ブラウザ閲覧用、単一ファイル)

3. レポート生成:

   # 週次 markdown レポート
   bash "${CLAUDE_PLUGIN_ROOT}/scripts/dashboard-generator.sh" \
     --period week \
     --format markdown \
     > weekly-cost-report.md
   
   # 月次 HTML レポート
   bash "${CLAUDE_PLUGIN_ROOT}/scripts/dashboard-generator.sh" \
     --period month \
     --format html \
     > monthly-cost-report.html
   
   # 任意期間
   bash "${CLAUDE_PLUGIN_ROOT}/scripts/dashboard-generator.sh" \
     --since 2026-04-01 --until 2026-04-30 \
     --format markdown
   

4. 共有用エクスポート (サニタイズ済み) — paths / tokens / repo 名を redact:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/dashboard-generator.sh" \
     --period month \
     --format markdown \
     --export ./share-dir
   # → stdout に出力ファイルパスを返す (例: ./share-dir/cost-report-20260508T080000Z.md)
   

   サニタイズ規則 (5 軸):

   • 絶対パス (/Users/..., /home/..., /Volumes/...)
   • 認証情報 (sk-..., ghp_..., AKIA... 等)
   • email アドレス
   • UUID (session ID)
   • GitHub owner/repo slug

5. 生成されたファイルパスをユーザーに伝える。markdown はそのまま貼り付けて確認可能。

レポート構成

# Claude Code cost report

_source_: jsonl-parser | ccusage-bridge
_period_: YYYY-MM-DD → YYYY-MM-DD

## Totals
| metric | value |
| input / output / cache_w_5m / cache_w_1h / cache_read tokens | ... |
| **cost (USD)** | **$X.XX** |

## By model
| model | tokens... | cost (USD) |
(cost 降順)

## By day
| date | tokens... | cost (USD) |

## Warnings (任意)
- 未知 model 検出 / cache 計算注意 等

用途別ガイド

用途	推奨コマンド
個人の週次レビュー	--period week --format markdown
月次予算確認	--period month --format markdown
チーム共有 (Slack 等)	--period week --format markdown --export ./share/
受講者向け配布	--period month --format markdown --export ./course-materials/
ブラウザ確認	--period month --format html > report.html && open report.html

依存

• bash, jq, sed, awk
• ~/.claude/projects/**/*.jsonl への read 権限
• (option) ccusage CLI

既知制限

• 価格表は plugin 同梱 (last update 2026-05)。Anthropic 価格変更時は PRICE_TABLE_PATH env で override
• ccusage v18.x の cache cost ~60% 誤差 (upstream #899)。精密 cache 計測は CCUSAGE_PATH=disabled で bundled parser を使う
• HTML 出力は単一ファイル、外部 CSS/JS 依存なし。markdown のサブセット rendering (table / heading / code 程度)