核心用法
Token Usage Optimizer 是专为 Claude Code 付费用户设计的订阅额度管理工具，通过 Anthropic OAuth API 实时拉取用量数据，帮助 $20-200/月 的订阅者最大化利用每一分投入。
三步上手：
1. 配置：运行 setup.sh 输入 Access Token 和 Refresh Token
2. 查用量：check-usage.sh 返回 SESSION/WEEKLY 百分比及 BURN_RATE 状态
3. 看报告：report.sh 生成人性化日报，含乌克兰语等多语言支持
关键特性：
- 双周期监控：5小时会话窗口 + 7天周配额双轨追踪
- 燃耗速率计算：UNDER（使用不足）/ OK（ pace 正常）/ OVER（即将超限）三档状态
- 智能防刷机制：SESSION>50% 或 WEEKLY>80% 时触发一次性告警，状态文件避免重复打扰
- 10分钟缓存 + OAuth 自动续期：平衡实时性与 API 调用成本
显著优点
1. 经济导向设计：直接回应"花钱买配额却用不完/不够用"的痛点，输出明确的"多用点"或"省着点"建议
2. 零依赖轻量：仅用 curl/date/grep，无需 jq 等外部工具，兼容 macOS/Linux
3. 多计划自适应：自动识别 Pro/Max 100/Max 200 档位，统一按 ~14%/周、~2%/天 计算预算基线
4. 工程化细节：缓存 TTL 可覆盖、告警状态持久化、多刷新端点容错、cron 集成模板
潜在局限
- 令牌获取门槛高：需手动从浏览器 DevTools 提取 OAuth token，无官方 CLI 支持，对非技术用户不友好
- 9小时令牌有效期：虽有自动续期机制，但依赖用户正确配置 cron，否则频繁需手动重登
- API 端点非公开：
anthropic-beta: oauth-2025-04-20为内部接口，存在随时变更或废弃风险 - 无历史趋势：仅有当前快照，无法查看周/月用量曲线或预测未来消耗
- 单用户设计：令牌绑定个人账户，不支持团队多成员用量聚合
适合人群
- Claude Code 付费订阅者（尤其是 Max 档位高频用户）
- 用量焦虑型用户：总担心"今天用多了明天不够用"
- 成本优化型用户：希望确认 $200/月 是否物尽其用
- 自动化爱好者：愿意配置 cron 和 shell 环境的效率极客
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 令牌泄露 | **中** | `.tokens` 文件存储明文 OAuth 凭证，误提交或权限宽松可导致账号被盗 |
| API 端点变更 | **中** | Beta 接口无稳定性承诺，可能导致工具突然失效 |
| 误操作风险 | **低** | 过度依赖燃耗建议可能反而限制正常使用，影响工作效率 |
| 缓存数据滞后 | **低** | 10分钟缓存可能导致告警延迟，错过最佳调整窗口 |