Token Receipt — AI skill for Claude Code

token-receipt

把某一天的 AI 编程用量打成一张小票：Claude Code、Codex、WorkBuddy 按模型列出 token、缓存读写、按 API 标价折算的金额，以及订阅额度用满的次数。输出是一个自包含的静态 HTML（任何人打开即看），并可截成 PNG。

A receipt for a day of AI coding usage: tokens by model (Claude Code, Codex, WorkBuddy), cache reads and writes, API-list-price estimates, and plan-limit hits. Outputs a self-contained static HTML page and a PNG screenshot. Chinese and English, six scenes.

案例

下面是 `--demo` 生成的一天虚构用量（不读取任何本机日志）。六种场景各一张，版面与真实输出一致：

打印机出纸 · 木桌 · 软木板

手账胶带 · 账单夹板 · 纯净背景

英文版（`--lang en`）：

**怎么读这张小票**

• 每个模型一栏：请求数，以及输入、输出、缓存读、缓存写的 token 数和按 API 标价折算的金额。
• 「小计」是该来源的 token 与金额合计；「TOTAL TOKEN」「API equivalent」是全部来源的合计。
• 「5 小时额度用满 × 3」表示当天 Claude Code 撞了 3 次 5 小时限额，后面的时间是各次的重置点。
• 「Weekly limit used 36%」是 Codex 记录的周额度占用，以及下一次重置的时间。
• 标「not priced」的 WorkBuddy 没有公开单价，只列 token。

运行 `python3 receipt.py --demo --lang all --scene all` 可以在自己机器上生成这十二份样例。

特点

• 只读本机：读取 ~/.claude/projects、~/.codex/sessions、~/.workbuddy/projects 下的会话记录，只取 token 数、模型名、时间和额度信息，不保存提问与回答。
• 不联网出数据：数据全部来自本机日志。只有 --price 与 --check-prices 会访问 OpenRouter 的公开价目表。
• 只用标准库：一个 Python 3 文件，无需安装依赖。
• 六种场景：热敏打印机（纸从出纸口吐出）、木桌、软木板、手账（胶带）、账单夹板、纯净。底纹与动画全部是 CSS，不含图片文件。
• 中英文：--lang zh|en|all。

安装

需要 Python 3.10+。PNG 需