Community图像github.com

token-report

从本地 Claude Code 转录文件中报告 token 使用量、缓存读写次数、API 列表值、配额读取次数以及响应时间。

token-report 是什么?

该技能通过一个 Python 脚本构建本地 Claude Code 使用报告。它读取 Claude Code 会话转录文件和保留的本地捕获历史记录,生成一个包含提示计数(基础输入、缓存创建、缓存读取)的标题,并以 UTF-8 字节清单形式展示构成视图,而非 Claude token 归因。脚本无需安装额外依赖,也不会发送任何数据。支持通过命令行选项灵活过滤日期范围、选择特定会话、调整输出风格(临床、马蒂斯、夜曲)以及导出 JSON 或 HTML 文件。它支持 Windows(使用 python)和 macOS/Linux(使用 python3)平台,并包含多种调试与维护选项,如 `--doctor` 检查路径与解析支持、`--rebuild` 重建索引。报告不会打开凭证文件、外部工具结果或图片 URL,也不会检查或重复提示、输出、推理或工具内容。当用户明确要求分享时,应使用独立的 token-share 技能上传到 tokenusage.dev,而不是通过此报告授权分享。

兼容平台✓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 的新对话。

文档

token-report 是做什么的?

使用此插件的脚本构建本地 Claude Code 使用报告。

该报告读取 Claude Code 会话转录文件和保留的本地捕获历史记录。 其标题使用记录的提示计数:基础输入加上缓存创建加上缓存 读取。其构成视图是一个带标签的 UTF-8 字节清单,而非 Claude token 归属。它不发送任何内容,也不安装任何依赖。

使用 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 写入详细数字和数据质量计数器。
  • --metrics-only 跳过文本字节清单。
  • --no-account 完全跳过账户文件。
  • --sessions-root PATH 选择另一个转录根目录及其独立的本地状态。
  • --live-only 显示当前存在的转录;保留的历史记录仍会被捕获。
  • --no-cache 绕过一次性索引。
  • --rebuild 仅清除一次性索引,重新提取实时文件,并合并而不删除保留的历史记录。
  • --doctor 检查路径、解析支持和本地状态,不进行写入或发送。
  • --out PATH 选择 HTML 输出目标。

对于 Windows 命令变体使用 python,对于 macOS/Linux 使用 python3。 保持脚本路径的引号完全如图所示。

在描述结果之前,先读取终端摘要和材料数据质量计数器。 链接生成的 HTML 和任何请求的 JSON。解释缺失或部分测量结果。 将美元数字称为 API 列表值,而非支出或账单。区分记录的 token 计数与字节组成、推断的图像计数和拟合的响应时间数字。

默认包含捕获的历史记录,因为 Claude Code 可能会修剪转录。 不要声称完整的账户或日历使用情况。不要清除历史记录来修复索引。

本地页面可能根据允许列出的电子邮件或组织元数据命名账户。 公开输出和分享隐藏该身份。历史记录仅保留账户计划字段 和解析的订阅创建日期。

历史计划标签使用捕获的账户观察结果。脚本仅在观察到规则和订阅创建守卫通过时提供计划;否则使用 null。不要虚构计划标签或日期声明。

如果订阅创建日期保持不变,计划变更在后续运行观察到新等级之前是无法检测的。因此,在此运行之前结束的时间段可能携带旧计划。该日期在升级或降级时是否变化尚未验证。

切勿打开 .credentials.json、其他凭证文件、外部工具结果文件或图片 URL。切勿检查或重复提示、输出、推理或工具内容。 不要获取价格或安装包。

如需在 tokenusage.dev 上公开分享,请仅在用户明确要求分享、发布、更新或删除其公开使用数据时使用单独的 token-share 技能。运行此报告不授权分享。

相关技能