用途:读取 Claude Cowork / Claude Code 在 ~/.claude/projects/ 下生成的 JSONL 会话记录,汇总真实 token 用量,并按 Anthropic 列表价(含 prompt-cache 折扣)计算这些对话若改用按 token 计费的 Claude API 会花多少钱,用于对比订阅与 API 计费。
主要能力:给出当前对话或全部历史对话的 token 数;统计重放同一多轮、含工具调用对话所需的精确 token;按缓存命中情况计算美元与欧元成本。
使用方式:worker 为技能目录下的 cost.py,用系统 Python 运行。模式:current(默认,当前对话)、history(全部对话,含每段与总计)。示例:python "C:\Users\massimo.olivieri.claude\skills\cost\cost.py" --mode current --json;python "C:\Users\massimo.olivieri.claude\skills\cost\cost.py" --mode history --json。选项:--rate-eur 0.92 指定欧元汇率;--include-subagents 计入子代理调用。输出 JSON 后自行渲染为简短报告,展示 token 明细(未缓存输入/缓存读取/缓存写入/输出/总计)及美元、欧元成本;history 模式按费用从高到低排序并给出 TOTAL 行。金额固定两位小数,直接使用 usd_display 与 eur_display 字符串,欧元用逗号作小数分隔符。
限制:若返回 {"status": "unavailable"},说明未找到记录,通常是在 Cowork / Claude Code 之外运行,此时不要编造数字,应友好说明记录仅存在于会话内并建议在其中运行。数据为实际 API 调用按列表价(缓存读取约 0.1×、5 分钟写入 1.25×、1 小时写入 2× 基础输入)计算,非估算;这是 API 按量成本,订阅账单方式不同,仅作对比而非实际账单。若输出含 unknown_models,这些调用计入 token 但因费率表缺失按 $0 计价,可在 cost.py 的 PRICES 中补充。