Token Usage Optimizer 综合评估
核心用法
Token Usage Optimizer 是一款专为 Claude Code 付费用户设计的用量监控工具，支持 Pro ($20)、Max 100 ($100)、Max 200 ($200) 三档订阅计划。通过调用 Anthropic OAuth API (api.anthropic.com/api/oauth/usage)，实时监控 5 小时会话配额和 7 天周期配额的消耗百分比，并计算每日燃烧速率（burn rate），判断用户是否处于「使用不足」「合理使用」或「过度消耗」状态。
安装后运行 ./scripts/setup.sh 配置 OAuth 令牌（access token + refresh token），即可通过 ./scripts/check-usage.sh 获取原始数据，或 ./scripts/report.sh 查看可读性报告。系统采用 10 分钟缓存策略，默认存储于 /tmp/claude-usage.cache，并支持自定义路径与 TTL。
显著优点
- 订阅价值最大化：通过 burn rate 计算，明确提示用户「多用回本」或「节流保配额」，特别适合高频使用者监控 5 小时会话窗口，避免提前触顶。
- 防刷屏设计：SESSION > 50% 或 WEEKLY > 80% 时触发一次性警报，通过
/tmp/claude-usage-alert-state状态文件去重，杜绝通知轰炸。 - 零依赖轻量实现：仅用
curl、date、grep、cut、printf等系统内置工具，无需jq等外部解析器，兼容 macOS 与 Linux。 - 自动令牌续期：内置 refresh token 机制，支持每 5 小时自动续期（推荐配合 cron），解决 Anthropic OAuth token ~9 小时过期的问题。
- Heartbeat 集成友好：提供标准 Markdown 片段，可直接嵌入个人自动化工作流。
潜在缺点与局限性
- 令牌获取门槛高：用户需手动从浏览器 DevTools 或移动端抓包提取
sk-ant-oat01-...和sk-ant-ort01-...令牌，流程对非技术用户不够友好，且存在误操作泄露风险。 - API 稳定性依赖：Anthropic OAuth usage 端点为 beta 状态（
anthropic-beta: oauth-2025-04-20），接口变更可能导致 skill 失效，需持续关注官方文档更新。 - 仅支持 Claude Code：不适用于 Anthropic API (console.anthropic.com) 的 token 消费监控，也不支持 Teams/Enterprise 组织的集中配额管理。
- 无历史趋势分析：当前仅提供实时与近 10 分钟快照，缺乏长期用量曲线、峰值时段分析等进阶功能。
- 安全存储警告：令牌明文存储于
{baseDir}/.tokens，虽已被.gitignore排除，但仍依赖本地文件权限保护，无加密或密钥托管机制。
适合人群
- Claude Code Pro/Max 高频用户：每日深度使用、担心 5 小时会话窗口提前耗尽的专业开发者或内容创作者。
- 成本敏感型订阅者：希望精确把控 $20-200/月 投入产出比，避免「买多了用不完」或「买少了天天撞墙」的尴尬。
- 自动化工作流爱好者：习惯用 cron、Heartbeat 或类似工具编排日常任务的技术用户。
- 不愿折腾复杂监控栈：偏好轻量级 shell 脚本、排斥 Prometheus/Grafana 等重型监控方案的个人用户。
常规风险
- 令牌泄露风险：OAuth token 等同于账户访问权限，一旦
.tokens文件被窃取或意外上传至 GitHub，攻击者可直接调用 Claude Code API。 - API 调用失败导致误判：若 Anthropic 服务端故障或 rate limit，skill 可能返回空值或 stale cache，用户误以为配额充足而过度使用。
- 自动化续期失败：网络波动或 refresh endpoint 变更时，auto-refresh 脚本可能静默失败，直至 token 过期才暴露问题。
- 误删缓存或状态文件：手动清理
/tmp可能导致重复警报或数据异常，建议用户避免频繁干预缓存目录。