Community影像github.com

token-report

從本機 Claude Code 記錄檔產生令牌使用量、快取讀寫、API 列表值、配額讀取及回應時間的報表。

token-report 是什麼?

這是一個專為 Claude Code 設計的本機使用量報告工具,透過讀取本機的 Claude Code 工作階段記錄與保留的歷史快照,產出詳細的報告。報告的標題會顯示記錄到的提示計數(包含基礎輸入、快取建立與快取讀取),而其組態視圖則是以 UTF-8 位元組庫存呈現,而非直接對應 Claude 令牌。工具支援 Python 3.8 以上版本,無需安裝任何外部依賴,也不會上傳任何資料。它提供豐富的命令列選項,例如按日期範圍篩選 (`--since` / `--until`)、指定工作階段 (`--session`)、選擇報告風格 (`--style`)、輸出 JSON 詳細資料 (`--json`)、跳過位元組庫存 (`--metrics-only`)、指定其他記錄根目錄 (`--sessions-root`)、使用即時資料 (`--live-only`)、管理索引快取 (`--no-cache` / `--rebuild`) 以及執行診斷 (`--doctor`)。報告適合在終端機或輸出為 HTML 檔案使用,但**不能**用來宣稱完整的帳戶或日曆使用量,也**不應該**用來處理機密憑證、使用者提示、輸出或工具內容。若要將報告公開分享至 tokenusage.dev,必須使用獨立的 token-share 技能,且僅在使用者明確要求時才能執行。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/stdcmms-lang/token-counter/tree/main/plugins/token-counter-claude/skills/token-report

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

使用此外掛的指令碼建立一份本機 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 技能。執行此報表本身並不授權共享。

相關技能