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 环境中使用时严格限制密钥权限范围。

核心用法

claude-cost-cli 是一款面向 macOS 的命令行工具，用于查询 Anthropic Claude API 的组织级用量与费用数据。用户需从 Claude Console 获取 Admin API key（sk-ant-admin... 前缀），通过交互式命令 claude-cost config set-key 安全存储至 macOS Keychain，全程无明文落盘。

主要功能模块：

• 用量查询：claude-cost usage 支持按日期范围（--from/--to）、周期简写（--period 30d）、模型过滤（--model）、API key 过滤（--api-keys）、多维度分组（--group-by）及时间粒度（--bucket 1h/1d/1m）查询消息级 token 消耗
• 费用报表：claude-cost cost 提供成本明细与汇总（--sum），支持按 workspace 和 description 分组
• 输出格式：默认表格展示，支持 --json 用于脚本集成与自动化分析

显著优点：
1. 安全设计优先：密钥存储于 macOS Keychain（服务名 claude-cost-cli），无配置文件、无磁盘缓存、无数据持久化，网络请求仅限 api.anthropic.com HTTPS
2. 权限最小化：Admin API key 仅授予只读权限，无法修改账单、创建密钥或访问对话内容
3. 供应链透明：MIT 开源协议，npm 包附带 provenance attestation，可溯源至 GitHub Actions 构建提交
4. 企业友好：支持多维度分组（model/api_key_id/workspace_id/service_tier）和细粒度时间桶，便于成本归属与预算监控

潜在局限与风险：

• 平台限制：仅支持 macOS，依赖 Node.js ≥ 18，Windows/Linux 用户无法使用
• 单点依赖：功能完全依赖 Anthropic Admin API 可用性与数据延迟
• 无历史缓存：每次查询实时拉取，大规模数据请求可能受 API 速率限制
• 密钥管理责任：虽使用 Keychain，但 key 泄露风险仍存在于用户设备层面

适合人群：

• Claude API 企业用户与组织管理员
• 需要自动化成本监控与用量分析的 DevOps/SRE 团队
• 注重 CLI 效率与安全密钥管理的 macOS 开发者

常规风险：Admin API key 若被窃取，攻击者可获取组织级用量与费用敏感信息（虽无法操作账单），建议定期轮换密钥并监控异常查询模式。