claude-usage-cli

claude-usage-cli 是一款面向开发者和运维团队的命令行工具，专为查询 Anthropic Claude API 的用量和成本数据而设计。通过调用 Anthropic Admin API，用户可以快速获取组织级别的 token 使用详情和费用 breakdown，支持按日期范围、模型类型、API key ID 等多维度筛选和分组。工具采用 macOS Keychain 安全存储 Admin API 密钥，确保凭证不会以明文形式写入磁盘，同时仅通过 HTTPS 与 api.anthropic.com 通信，保障数据传输安全。

该工具的核心优势在于其简洁高效的命令行交互体验和灵活的数据输出格式。用户可通过 claude-usage usage 和 claude-usage cost 命令分别查询用量和成本，支持表格和 JSON 两种输出格式，便于集成到自动化脚本或数据分析流程中。时间维度支持从小时级到月级的灵活配置（通过 --bucket 参数），且提供 --sum 选项快速获取总成本。此外，工具仅申请只读权限的 Admin API key，无法修改配置或访问对话内容，从权限层面降低了安全风险。

然而，用户需特别注意该工具已被官方标记为 DEPRECATED，不再维护，建议使用 claude-cost-cli 替代。功能层面，该 CLI 仅支持 macOS 系统，且依赖 Node.js 运行环境（>= 18），跨平台兼容性受限。对于需要长期稳定支持的生产环境，当前弃用状态构成了显著风险。此外，虽然工具本身不缓存数据，但 Admin API key 涉及组织级财务敏感信息，一旦泄露可能导致用量数据被恶意获取。

该技能主要适合以下群体：使用 Claude API 进行产品开发的技术团队、需要监控 AI 支出的财务管理员、以及负责成本优化的 DevOps 工程师。对于希望快速了解 API 消耗模式或生成定期成本报告的用户尤为实用。但鉴于其已弃用状态，建议仅作为参考文档了解 Anthropic Admin API 的功能边界，实际生产使用应迁移至替代方案。

使用风险方面，除上述维护状态风险外，还包括：Node.js 运行时和 npm 包的供应链安全风险（尽管可从源码审计后安装）；Admin API key 的管理责任完全落在用户端，需确保 Keychain 安全；网络层面的单点依赖（仅支持 Anthropic 官方 API）。建议用户在非生产环境测试验证后再考虑使用，并严格遵循最小权限原则管理 API 密钥。