核心用法
TokenWatch 是一款面向 AI 重度用户的本地化令牌成本监控工具。用户通过 Python SDK 记录每次 API 调用（手动或自动捕获 Anthropic/OpenAI 响应），即可实时追踪支出。核心功能包括：多级预算设置（日/周/月/单次调用）与自动告警、调用前模型成本对比、费用预估、可视化仪表盘、智能优化建议（如推荐降级模型以节省费用）以及 JSON 报告导出。
显著优点
- 完全本地化：零网络遥测、零外部依赖，数据仅存于
.tokenwatch/目录 - 隐私友好：无需 API 密钥、无需账号、MIT 开源可审计
- 实用性强：覆盖成本追踪全流程——从预估、监控到优化建议
- 易集成：提供 Anthropic/OpenAI SDK 的自动记录钩子，一行代码接入
- 预算管控：支持多维度阈值告警，防止账单失控
潜在缺点与局限性
- 手动维护成本：定价表需用户手动更新（2026年2月数据），新型号或价格调整需同步
- 仅限事后分析：无法拦截调用，仅能做记录与告警
- 无多用户支持：本地单用户设计，团队协作需自行解决数据同步
- 优化建议通用性：基于规则的建议可能不适用于特定业务场景
适合人群
- 频繁调用多厂商 API 的开发者与团队
- 对成本敏感且需精细化预算控制的 AI 应用运营者
- 注重数据隐私、偏好本地工具的技术用户
常规风险
- 定价数据过期风险：若未及时更新，成本估算与实际账单可能出现偏差
- 本地数据丢失：无云备份，设备故障可能导致历史记录丢失
- 告警依赖本地运行：需保持进程活跃才能触发预算告警