quota-audit：按项目和 Skill 拆解 Claude Code 额度消耗的 Skill

撞到 Claude Code 5 小時或每週上限的時候，我最想知道的是哪個專案用掉的，但 /usage 答不出來。它只給帳號層級的百分比，再加幾個像「>150k context」、「4+ parallel sessions」的標籤，沒有拆到專案，那些百分比也沒辦法自己驗算。

Claude Code 本來就會把每則訊息的 token 用量寫進本機的 session transcript（~/.claude/projects/*/*.jsonl）。所以我寫了一個 skill 叫 quota-audit，讀這些檔案，按專案、按 skill 整理用量，也列出真正撞到上限的時間點和當下被擋的 repo。它只讀檔，不會寫入任何東西，資料也不會送出去。

報表長怎樣

開頭先放幾行算好的結論，接著每個視窗（5h、24h、7d）一列總覽，最後才是最長那個視窗的明細。節錄一段範例：

KEY FINDINGS (7d window)
  • Estimated cost $147.31, 65% of it in my-app ($95.20)
  • Top skill is ai-work at 54%
  • 11 sessions crossed 150k context, $88.40 combined (60% of window cost)
  • 3 rate-limit hits in 7d; 14 all-time, most often blocking my-app (9 times)

window     est. cost  sessions   >150k   hits   top project
5h            $12.40         5       2      0   my-app 81%
24h           $38.75        21       4      1   my-app 70%
7d           $147.31        99      11      3   my-app 65%

skill 是逐則訊息歸因的，不是只看 session 用哪個指令開頭，所以具名 skill 跟一般互動的切分比較可信。超過 150k context 的 session 會直接列出名字，依花費由高到低排，這通常是最值得先處理的地方。撞限紀錄則依 repo 和時段彙總。

另外還有一個異常偵測，抓那種瀏覽器分頁或腳本開著、每一兩分鐘打一次的輪詢迴圈。這類迴圈會讓 session 數暴增，卻沒有真的花到額度，先抓出來就不用追一個不存在的成本。想看每個視窗的明細和每一筆撞限紀錄，給 render.py 加 --full 就好。

怎麼裝

目前版本是 v1.3.0。在互動式 Claude Code session 裡：

/plugin marketplace add rosehsu47/claude-code-quota-audit
/plugin install quota-audit@rosehsu47

或非互動式：

claude plugin marketplace add rosehsu47/claude-code-quota-audit
claude plugin install quota-audit@rosehsu47

如果安裝結果顯示 Run /reload-plugins to activate，就跑一下那個指令。裝好之後直接問「額度都被誰用掉」或「token 都花在哪」就會觸發，也可以打 /quota-audit 明確呼叫。報表語言會依 shell 的 locale 自動選繁中或英文，想固定的話設 QUOTA_AUDIT_LANG=zh 或 QUOTA_AUDIT_LANG=en。

做不到的事

美金數字是用工具內建的定價快照估出來的，不是帳單。專案之間的比例比較可信，總額建議拿即時的 claude -p "/usage" 對照一下。每個專案各自的 subagent 花費目前拿不到。範圍也跟 /usage 一樣，只看這台機器，不包含其他裝置或 claude.ai 上的用量。

原始碼放在 github.com/rosehsu47/claude-code-quota-audit，很想聽聽大家平常都怎麼追額度花到哪裡去。