1实现原理 · 为什么它能做到
数据源是本地 ccusage：analyze_claude_usage.py 不自己解析日志，而是 subprocess 调 `ccusage claude daily/blocks --json` 取 JSON 再提炼——技能的价值在‘读 ccusage 数字并用人话解释’。
daymade-claude-code/claude-usage-analyst/scripts/analyze_claude_usage.py
proc = subprocess.run( ["ccusage", "claude", *args, "--json"],
注：run_ccusage 先 shutil.which('ccusage')，缺失即报错并提示 npm install -g ccusage@latest。
窗口语义：默认 --since/--until 为所选时区（默认 Asia/Shanghai）的今天；历史对比需显式给 --since，否则 rank/median 只描述单日。
daymade-claude-code/claude-usage-analyst/SKILL.md
Default `--since/--until` is today in the selected timezone.
注：summarize() 里 daily[-1]/按 date==until 取 target 日，before 列表用于‘目标日前历史中位数’对比。
模型对比支持别名：--model-a/--model-b 在目标日 modelBreakdowns 里做子串匹配（默认 fable vs opus-4-8），输出 token 比与成本比，纠正‘token 多≠贵’。
daymade-claude-code/claude-usage-analyst/SKILL.md
python3 scripts/analyze_claude_usage.py --model-a fable --model-b opus-4-8
注：find_model 用 needle.lower() in name.lower()；SKILL 明言‘token 量相近但成本更高’要指出单价差异。
5 小时 block 由 ccusage blocks 命令提供（近似配额窗口分组），脚本跳过 isGap、只留目标日 block，输出起止/模型数/entries/token/成本/cache 占比。
daymade-claude-code/claude-usage-analyst/SKILL.md
4. 5-hour block table when quota exhaustion is discussed.
注：explanation-guide.md 强调 5-hour block 是 ccusage 分组近似，不是订阅配额契约。
解释层与证据层分离：SKILL 规定数字结论必须基于 ccusage/analyzer 输出，cache 要解释（read 也算用量压力），不知计划规则时用‘quota-like pressure/ccusage estimated’措辞，最终答案按 explanation-guide.md 的结构写。
daymade-claude-code/claude-usage-analyst/SKILL.md
Explain cache clearly: cache read tokens are still usage/quota pressure even though the user did not type those words.
注：evidence rules 全部指向‘别把本地 token 数外推成官方计费’。
2核心能力
01单日/区间用量统计：total tokens、estimated cost、input/output/cache create/cache read + 成本/用量在窗口内排名
02模型混合明细与双模型对比（token 比 + 成本比，别名子串匹配）
035 小时 block 视角解释配额烧尽（起止/模型/entries/tokens/cost）
04时区正确性：--timezone（zoneinfo 全名）作用于日期窗口与 block 起止时间换算
05输出双形态：人读 Markdown 表 / --json 结构化数据
06面向非技术用户的人话解释（explanation-guide：cache read>80% 意味着 agent 反复读上下文而非用户打字多）
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | ccusage（第三方 npm CLI，用量统计） |
| package | ccusage@latest（npm 全局安装） |
| cli | python3（zoneinfo 需系统 tz 数据） |
4风险提醒 风险提醒：黄色 · 留意使用
风险提醒：黄色 · 留意使用
- 第三方依赖供应链 — ccusage 为 npm 第三方包且 SKILL 建议装 @latest；包行为（是否上传统计/读更多文件）不在本仓可审计——建议固定版本并首次审查
- 数据边界易被误读 — ccusage 只覆盖生成本地日志的会话；Claude.ai 网页/桌面聊天大多不在内，若 agent 忘记 scope 声明会高估/低估
- 成本是估算 — 价格数据来自 ccusage 本地定价表，非官方账单；数字差异可能误导用户对配额的理解（SKILL 要求注明 estimated）
- 默认值时间敏感 — 默认模型别名 fable/opus-4-8 与默认时区 Asia/Shanghai 是写死的假设；模型代际变化后默认对比可能失效
风险提醒：黄色，留意使用。技能自身脚本只 subprocess 调本地 ccusage 并解析公开用量指标（token 数/估算成本/模型名/时间块），零网络、零凭证读取、零写文件——不触碰 ~/.claude/settings/.claude.json 等含密钥文件。黄色来自两层：① 依赖第三方 npm 包 ccusage（供应链：安装自 registry.npmjs.org，其包内行为不在本仓可审计，建议固定版本再装）；② 读取对象是本地会话 usage 记录（隐私面，但非凭证面）。若使用中 ccusage 出现向网络上传或读 key 的行为（本仓无法验证），应按橙色处理。
5第二遍独立确认
- [ok] 无网络外发（脚本自身） — 无 urllib/requests/socket；唯一外部动作是 npm install ccusage 的安装提示（用户/agent 执行）
- [ok] 无凭证读取 — 无 environ/getenv/settings/.claude.json 读取；ccusage 侧读取范围不可在本仓审计（已在 reason 注明）
- [ok] 无写文件 — 脚本只 print（stdout），无文件写入
- [ok] 数字字段映射准确 — cacheCreationTokens/cacheReadTokens/cost 等字段名与 ccusage JSON 语义一致；model_total 明确含 cache 系 token
- [ok] ‘ccusage 不是官方账单’边界 — SKILL evidence rules 与 explanation-guide caveats 双重声明 estimated/quota-like 措辞要求
6结论
适合：适合 Claude Code 用户自查‘今天 token/钱花哪了、是不是某模型特别贵、5 小时配额怎么烧完的’；ccusage 已装的用户开箱即用，分析结果可直接用于调模型路由/缓存策略。
不适合：不适合需要官方账单级精度的财务场景（应查 Anthropic console）；不适合未装 ccusage 且不允许装 npm 包的受限环境；不适合分析 Claude.ai 网页聊天（不在本地日志内）或非 Claude 系的用量。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-09
方式 A · 人下载镜像包下载 claude-usage-analyst.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent009defcb5a1b30df…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库daymade / daymade/claude-code-skills
原始 GitHubdaymade/claude-code-skills ↗
Stars1385
最近推送2026-09-09
本 skill commit
d5c4678cb5许可MIT（仓库根 LICENSE：Copyright (c) 2025 daymade；GitHub API spdx MIT）
本站信息
收录日期2026-09-06
分类基础工具与工作流
侦查报告2026-09-06 · 2 遍
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。