成本追踪

使用本技能来分析 Claude Code 的成本与使用历史，数据来自 ECC 的 stop:cost-tracker 钩子写入的指标日志。

数据存储位置

追踪器在每次会话结束时，向 ~/.claude/metrics/costs.jsonl 追加一个 JSON 对象。每一行都是该会话的累计快照，因此要计算总支出，需要先取每个 session_id 的最新一行，再在会话之间求和——对所有行求和会造成重复计数。

行结构：

字段	含义
timestamp	快照的 ISO 时间戳
session_id	Claude Code 的会话标识符
transcript_path	会话 transcript 的路径
model	使用的模型
input_tokens / output_tokens	token 计数
cache_write_tokens / cache_read_tokens	提示缓存的 token 计数
estimated_cost_usd	该会话预计算的累计成本（美元）

请优先使用 estimated_cost_usd，而不是手动计算价格——模型价格和缓存价格会变化，追踪器才是权威数据源。

何时使用

• 用户询问"我花了多少钱？"、"这个会话花了多少？"或"我的 token 使用量是多少？"
• 用户提及预算、支出上限、超支或成本控制。
• 用户希望按模型、会话或日期查看成本细分，或导出 CSV。

工作原理

首先验证日志是否存在（使用 node 而不是 sqlite3——追踪器写入的是 JSONL，且 node 是跨平台的）：

node -e 'const fs=require("fs"),os=require("os"),p=require("path");const f=p.join(os.homedir(),".claude","metrics","costs.jsonl");console.log(fs.existsSync(f)?"cost log found":"cost log not found: "+f)'

如果日志不存在，不要伪造使用数据。告知用户在启用 stop:cost-tracker 钩子后，需要等待第一个会话结束才会填充成本追踪数据。

示例——按模型汇总最近 7 天

node -e '
const fs=require("fs"),os=require("os"),path=require("path");
const f…