Ccusage cli cost tracking

Skill bokuwalily/claude-code-skills/skills/ccusage-cli-cost-tracking

75 battle-tested Claude Code skills from shipping 20+ apps solo — macOS, Next.js, Vercel, iOS/Expo, Cloudflare, Phaser, local AI media & more

Install

npx -y skills add bokuwalily/claude-code-skills --skill ccusage-cli-cost-tracking

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

非公式 ccusage CLI で Claude MAX クォータ消費を daily/weekly/blocks で集計・statusline 連携する設計。発火: token 5h block の残量確認 / 週次の出力 token 集計 / cost-guard hook 設計時 / Opus burn rate 警告

SKILL.md

1.7 KB, as published. Nobody here has run it

Procedure

インストール: npm install -g ccusage (Node 20+)
基本コマンド:
- ccusage daily — 当日の input/output/cost
- ccusage weekly --json — 週次 JSON
- ccusage blocks --active --json — 現在の 5h block 状態
statusline 連携 (~/.claude/scripts/statusline.sh):
- BLOCK_JSON=$(ccusage blocks --active --json)
- tokenCounts.outputTokens / projection.remainingMinutes / costUSD を抽出
キャッシュ戦略: blocks 30s / weekly 5min で statusline 高速化
cost-guard hook 連携: UserPromptSubmit で閾値超え警告 (500k/800k tokens / $80/hr burn)

Pitfalls

ccusage は非公式 → MAX plan の cost は API 換算値で実費ではない
session_id × transcript の重複加算で stop_cost_log と乖離 → ccusage の per-block 値を優先
node version 不一致で動かない → command -v ccusage で nvm fallback
weekly 集計は ISO week (月曜起点) なので、Anthropic billing と日付差あり
block 切り替わり時に projection.remainingMinutes が NaN → null check 必須

Verification