使用此外掛的指令碼建立一份本機 Claude Code 使用量報表。
此報表會讀取 Claude Code 的工作階段記錄以及保留在當地的歷史快照。 標題會顯示記錄到的提示計數:包含基礎輸入、快取建立與快取讀取。 其組合視圖是標記了 UTF-8 位元組庫存,而非 Claude 令牌歸屬。 此報表不會傳送任何資料,也不會安裝任何依賴套件。
需使用 Python 3.8 或更新版本。在 Windows 上執行:
python "${CLAUDE_SKILL_DIR}/scripts/report.py" --no-open
在 macOS 或 Linux 上執行:
python3 "${CLAUDE_SKILL_DIR}/scripts/report.py" --no-open
僅在使用者要求時才加入支援的選項:
--since YYYY-MM-DD及--until YYYY-MM-DD可選取包含特定日期的歷史快照。--session PREFIX可選取一個工作階段系列,包含其子代理與延續。--style clinical、--style matisse或--style nocturne可選擇報表的開頭風格。--json PATH可將詳細數值與資料品質計數器寫入 JSON 檔案。--metrics-only可跳過文字位元組庫存。--no-account可完全跳過帳戶檔案。--sessions-root PATH可選擇其他記錄根目錄及其獨立的本機狀態。--live-only僅顯示目前存在的記錄;歷史快照仍會保留。--no-cache可跳過一次性索引。--rebuild僅清除一次性索引,重新擷取即時檔案,並在不刪除歷史快照的情況下合併。--doctor可檢查路徑、解析支援與本機狀態,但不會寫入或傳送任何資料。--out PATH可選擇 HTML 目的地。
對於 Windows 的每個指令變體,請使用 python,而 macOS/Linux 則使用 python3。
保持腳本路徑與上述完全一致。
在描述結果前,請先閱讀終端機摘要與材料資料品質計數器。 提供生成之 HTML 與任何要求的 JSON 的連結。 解釋缺少或部分測量的原因。 將美元數值稱為 API 列表值,而非花費或帳單。區分記錄到的令牌計數與位元組組成、推論的圖片數量以及擬合的回應時間數據。
因為 Claude Code 可能會修剪記錄,因此預設會包含歷史快照。 請勿宣稱完整的帳戶或日曆使用量。請勿清除歷史記錄以修復索引。
本機頁面可能會根據允許清單中的電子郵件或組織元資料命名帳戶。 公開輸出與共享內容會省略該身分。歷史記錄僅保留帳戶方案欄位以及解析出來的訂閱建立日期。
歷史方案標籤使用所記錄的帳戶觀察結果。只有在觀察規則與訂閱建立日期檢查都通過時,指令碼才會提供方案;否則會使用 null。請勿自行編造方案標籤或日期宣告。
方案變更若未改變 subscriptionCreatedAt,則需等到後續執行觀察到新的層級才能偵測。因此,若視窗在該次執行之前結束,就可能帶有舊方案。該日期在升級或降級時是否會變更,目前尚未驗證。
絕對不要開啟 .credentials.json、其他憑證檔案、外部工具結果檔案或圖片網址。請勿檢查或重複提示、輸出、思考或工具內容。請勿擷取價格或安裝套件。
若要在 tokenusage.dev 上公開共享,請僅在使用者明確要求共享、發佈、更新或刪除其公開使用量時,才使用獨立的 token-share 技能。執行此報表本身並不授權共享。