从本地日志估算Claude Code的5小时用量窗口

作者为Claude Code构建了一个常驻Windows用量仪表，通过读取~/.claude/projects/下每会话的JSONL日志估算剩余额度。助手消息中的message.usage包含input_tokens、output_tokens、cache_creation_input_tokens和cache_read_input_tokens；日志为追加写入，因此按文件记录上次字节偏移做增量读取，刷新成本很低，且不读取登录数据或令牌。作者指出cache_read_input_tokens在长对话中可达10万以上，是“用量”的主要部分。该估算非官方口径。

AI推荐理由 文章说明如何从Claude Code本地JSONL会话日志的message.usage字段估算5小时用量窗口，采用按文件记录字节偏移的增量读取方式，并指出cache_read_input_tokens占用量大头；对重度Claude Code用户有实用价值，但估算方法未经官方验证，且为个人工具经验。