用途：usage-view 用于查看 Claude Code 的用量与花费情况，生成一个自包含的交互式 HTML 看板，展示成本明细、token 用量以及 5 小时窗口时间线，覆盖所有会话。
主要能力：支持按项目、时间范围、语言和套餐筛选；可只查看当前 5 小时窗口，或分析最近 N 天、全部时间；可选择跳过 AI 分析以加快渲染并避免 LLM 成本，也可强制启用 AI 分析。输出为独立 HTML 文件，内联 CSS/JS，Chart.js 走 CDN，可分享或随时重新打开。
使用方式：以斜杠命令形式调用，例如 /usage-view、/usage-view current、/usage-view current ai、/usage-view last 7 days、/usage-view locale ja、/usage-view current locale fr。参数会映射为脚本标志，如 --days N、--days all、--days 1 --current、--locale XX、--plan XX、--project X、--all、--no-ai、--ai。未提供套餐时会先询问当前 Claude 套餐（Pro、Max 5x、Max 20x、Team Standard、Team Premium、Enterprise、Amazon Bedrock、Microsoft Foundry、Google Vertex AI），再映射为 --plan 值。执行时启动单个后台 Agent 运行完整流程（分析 → AI 洞察 → 构建 → 打开浏览器），用户可继续工作。
限制与注意：Claude Code 会删除约一个月前的会话记录，--days all 只能加载 ~/.claude/cc-token-saver-data/ 中已缓存的 timeline CSV 与会话摘要，未分析过的会话不会出现。分析脚本内部使用流式读取，不应以 fs.readFileSync 读取 JSONL。缓存位于 ~/.claude/cc-token-saver-data/{projectName}/{sessionId}/，可用 --force 强制重新分析。遇到 model-pricing.json 中缺失的模型时脚本以退出码 2 失败并输出 ERROR:UNKNOWN_MODEL，需按既定流程处理。日期时间按用户本地时区显示。费用按 scripts/model-pricing.json 的每模型定价计算，未知模型回退到默认模型。重定向 stdout 时应使用 2>/dev/null，不要用 2>&1。Agent 不应直接运行 analyze-usage.js 或 build-report.js，而应通过 scripts/run-usage-view.js 执行。