cost-status

cost-status — Claude Code 即時コスト表示

cost-monitor plugin の即時表示 skill。今日のコスト累計を1コマンドで返す。期間指定 (week/month) と model 別内訳もサポート。

実行手順

1. デフォルト (今日のコスト) — 引数なしで起動された場合:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/dashboard-generator.sh" --period today --format markdown
   

2. 期間指定 — ユーザーが week / month を要求した場合:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/dashboard-generator.sh" --period week --format markdown
   bash "${CLAUDE_PLUGIN_ROOT}/scripts/dashboard-generator.sh" --period month --format markdown
   

3. 特定日付範囲 — --since / --until で範囲指定:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/dashboard-generator.sh" --since 2026-05-01 --until 2026-05-08
   

4. エクスポート (受講者向け、サニタイズ済み) — 共有用に paths/tokens を redact:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/dashboard-generator.sh" --period week --export ./share-dir
   

   出力ファイルパスが stdout に表示される。

5. 出力 markdown をそのままユーザーに表示する。--format html も可能 (HTML 単一ファイル出力)。

データソース

• ccusage CLI が PATH に存在 → 自動連携 (ccusage daily --json)
• 不在時 → 自前 JSONL parser (~/.claude/projects/**/*.jsonl 直読)
• どちらでも同じ schema を返す

既知 issue: ccusage v18.x は cache cost 計算に~60%の誤差 (upstream #899)。精密 cache 計測が必要なら CCUSAGE_PATH=disabled で bundled parser に切替。

表示内容

• 期間 (start → end)
• Totals: input / output / cache_write_5m / cache_write_1h / cache_read tokens、合計 cost (USD)
• By model: model 別内訳 (cost 降順)
• By day: 日別内訳
• Warnings: 未知 model / cache 計算注意

注意

• skill は read-only。書き込み・送信なし
• 価格表は plugin 同梱 scripts/price-table.json (last update 2026-05、Anthropic 公開価格)
• 価格変更時は PRICE_TABLE_PATH env で override 可能