claude-cost-cli

claude-cost-cli 是一款专为 Anthropic Claude API 用户设计的命令行成本监控工具，通过封装官方 Admin API，为开发者和组织提供精确的 Token 使用量与成本分析能力。该工具采用 TypeScript 开发并以 MIT 协议开源，支持通过 npm 全局安装或从源码构建，确保使用过程的透明性与可审计性。

核心用法围绕三个主要命令展开：安装后通过 claude-cost config set-key 交互式配置 Admin API 密钥（自动验证 sk-ant-admin 前缀并存储于 macOS Keychain），随后可使用 claude-cost usage 查询 Token 消耗明细（支持按模型、API 密钥 ID、时间粒度分组），或使用 claude-cost cost 获取成本报表（支持多维度聚合与总和计算）。所有查询均支持 --json 参数输出，便于集成至自动化脚本或数据管道。

显著优点体现在安全架构与功能灵活性的结合。安全层面，工具强制使用 macOS Keychain 存储敏感凭证，避免磁盘明文存储风险；网络通信仅限于 HTTPS 访问 api.anthropic.com，无第三方数据传输。功能层面，支持 1 小时至月度级的时间粒度分析，可按模型、工作区、API 密钥等多维度透视数据，满足精细化成本管控需求。开源特性允许用户审计代码逻辑，npm 发布的包附带来源证明（provenance attestation），确保供应链可信。

潜在缺点与局限性需引起注意。首先，该工具仅支持 macOS 系统，且依赖 Node.js >= 18 运行时环境，跨平台兼容性受限。其次，作为 T3 来源的个人开发者项目，虽然代码开源可审计，但长期维护稳定性与官方工具相比存在不确定性。此外，工具本身仅为查询客户端，实际成本优化仍需依赖用户的业务逻辑调整。

适合的目标群体主要包括：使用 Claude API 进行产品开发的技术团队（需监控模型调用成本）、负责 AI 预算管理的财务运维人员（需定期生成成本报表）、以及需要集成成本数据至内部 BI 系统的后端开发者。对于仅需偶尔查看账单的非技术用户，官方网页控制台可能更为便捷。

使用该技能存在的常规风险包括：API 密钥管理风险（尽管使用 Keychain，但初始输入环节仍需确保终端环境安全）、外部依赖风险（npm 生态的供应链安全问题，尽管可通过 --dry-run 或源码构建缓解）、以及数据隐私风险（查询结果包含组织级使用数据，需防止 JSON 输出被不当记录或泄露）。建议用户定期轮换 Admin API 密钥，并在 CI/CD 环境中使用时严格限制密钥权限范围。