概述
claude-usage-cli 是一款命令行工具，用于查询 Anthropic Claude API 的组织用量与成本数据。该工具面向需要监控团队或企业级 Claude API 消耗的管理员和开发者。
核心用法
安装后通过 claude-usage 命令操作，主要功能分为三块：
1. 密钥配置：config set-key/show/remove-key 管理 Admin API 密钥（sk-ant-admin... 格式），密钥安全存储于 macOS Keychain
2. 用量查询：usage 命令支持按时间段（7d/30d/自定义）、模型、API 密钥 ID 等多维度筛选，输出包含输入 Token、缓存 Token、输出 Token、搜索次数等
3. 成本查询：cost 命令提供费用明细与汇总，支持按工作空间、描述字段分组
输出格式支持表格（默认）和 JSON（--json），便于人工查看或自动化脚本集成。
显著优点
- 安全设计：API 密钥仅存储于 macOS Keychain，无配置文件落盘，传输仅使用 HTTPS 直连 Anthropic 官方 API
- 权限最小化：Admin API 密钥为只读权限，无法修改账单、创建密钥或访问对话内容
- 灵活查询：支持小时/天/月级粒度、多维度分组、自定义日期范围
- 开源可审计：代码公开托管于 GitHub，支持从源码构建安装
局限性与风险
⚠️ 关键提示：该工具已被标记为弃用（DEPRECATED），官方推荐迁移至 `claude-cost-cli`。
- 平台限制：仅支持 macOS，Linux/Windows 用户无法使用
- 依赖 Node.js：需 >= 18 版本，环境配置增加使用门槛
- 无数据缓存：每次查询均实时请求 API，大数据量场景效率受限
- 密钥管理风险：虽使用 Keychain，但命令行工具仍面临剪贴板泄露、进程列表暴露等侧信道风险
- 网络依赖：纯在线工具，无离线数据导出/备份机制
适合人群
- macOS 环境下的 Claude 企业/团队管理员
- 需要定期生成用量报告的技术运营人员
- 偏好命令行工作流、需将数据集成至现有监控体系的开发者
常规风险
| 类别 | 说明 |
|------|------|
| 供应链 | npm 包可能存在依赖污染，建议优先从源码构建安装 |
| 凭证泄露 | Admin API 密钥权限高于普通 API key，一旦泄露可读取组织全部用量数据 |
| 合规 | 用量数据可能包含敏感业务信息，JSON 输出需注意管道传输安全 |
| 维护状态 | 已弃用，未来可能存在安全补丁缺失风险，建议尽快迁移 |