trickv/hass-claude-usage

说明与用途

**项目简介**
trickv/hass‑claude‑usage 是一款 Home Assistant 集成插件，可在 Home Assistant 仪表盘中实时监控 Anthropic Claude 的订阅使用量。只需在 HACS 中搜索 “Claude Usage” 即可安装。

**价值**

• **费用可视化**：把 Claude 的 token 消耗、费用等关键指标直接展示在 Home Assistant 中，帮助用户及时掌握成本。
• **自动化账单**：结合 HA 的自动化脚本，可在使用量达到阈值时触发提醒、暂停服务或自动生成账单，从而简化付费流程。
• **快速验证 PSP 流程**：在原型或内部工作流中快速接入计费、结算或支付服务（PSP），无需自行编写监控代码。

**典型接入方式**

1. 在 Home Assistant 的 HACS 中搜索并安装 “Claude Usage”。
2. 在 **配置 → 集成** 中添加 Claude 账户的 API Key（或使用已有的 Anthropic 集成），并设置监控的订阅 ID。
3. 配置仪表盘卡片或自动化规则，例如：

   automation:
     - alias: "Claude 使用量超限提醒"
       trigger:
         - platform: numeric_state
           entity_id: sensor.claude_usage
           above: 90  # 百分比阈值
       action:
         - service: notify.mobile_app
           data:
             message: "Claude 使用量已超过 90%，请检查或充值。"

1. 如需对接支付平台，可在自动化中调用自建的 checkout / billing API，实现 “使用量 → 计费 → 支付” 的闭环。

**生产可用性**

• **成熟度**：GitHub 32⭐、13 forks，最近一次提交于 2026‑06‑26，代码以 Python 为主，适合作为原型或内部工具使用。
• **准备度**：中等（Medium）。在生产环境部署前建议：
• 完整审阅 README 与配置示例，确保 API Key 管理符合安全规范。
• 检查依赖库的安全性与许可证兼容性。
• 进行一次小规模的 PoC，验证监控数据的准确性与自动化触发的可靠性。
• **运维要求**：定期关注上游更新，确保兼容最新的 Home Assistant 与 Anthropic API 版本；如有安全漏洞或依赖更新，及时升级。

总体而言，trickv/hass‑claude‑usage 适合作为费用监控和计费自动化的快速落地方案，经过少量验证后即可在生产环境中安全使用。

实际用途

trickv/hass-claude-usage helps integrate monetization, billing, or PSP flows faster.

• integrate billing or checkout
• evaluate PSP flows
• automate payment operations

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.