Claude Cost Cli_AI Agent skill-PHP中文网

Claude Cost Cli

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过命令行查询 Claude API 用量与费用报告。使用 macOS 钥匙串安全存储 Admin API 密钥。支持表格/JSON 输出。

用于查询 Anthropic Admin API 使用量和成本数据的 Claude-ccost-cli.

功能概述

用于查询 Anthropic Admin API 使用量和成本数据的 Claude-ccost-cli.是一项面向实际任务的技能，主要用于A CLI 用于查询 Anthropic Admin API 使用量和成本数据. 需要从 Claude Console → Sets → Admin Keys 中存储一个 Admin API 密钥( sk- ant-admin...).；Creditistics 存储在其中。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

使用与执行

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

claude-cost-cli

一款用于查询 Anthropic Admin API 使用量与费用数据的命令行工具（CLI）。需从 Claude Console → Settings → Admin Keys 获取 Admin API 密钥（格式为 sk-ant-admin...）。凭证将存储于 macOS Keychain 中。

安装

要求 Node.js 版本 >= 18，且仅支持 macOS。本项目完全开源，采用 MIT 许可证：https://github.com/cyberash-dev/claude-cost-cli

npm install -g claude-cost-cli

该 npm 包已通过来源证明（provenance attestation）发布，借助 GitHub Actions 将每次发布与其源代码提交记录绑定。你可在安装前验证已发布的包内容：

npm pack claude-cost-cli --dry-run

如需在运行前审计源码，也可选择从源码安装：

git clone https://github.com/cyberash-dev/claude-cost-cli.git
cd claude-cost-cli
npm install && npm run build && npm link

安装完成后，claude-cost 命令即可全局使用。

快速开始

claude-cost config set-key     # 交互式提示：输入 Admin API 密钥（掩码显示）
claude-cost usage              # 过去 7 天的 Token 使用量
claude-cost cost               # 过去 7 天的费用明细
claude-cost cost --sum         # 过去 7 天的总支出

API 密钥管理

存储 API 密钥（交互式掩码输入，自动校验前缀 sk-ant-admin）：

claude-cost config set-key

查看已存储的密钥（掩码显示）：

claude-cost config show

从 Keychain 中移除密钥：

claude-cost config remove-key

使用量报告

claude-cost usage                                    # 过去 7 天，按天统计，按模型分组
claude-cost usage --period 30d                       # 过去 30 天
claude-cost usage --from 2026-01-01 --to 2026-01-31 # 自定义日期范围
claude-cost usage --model claude-sonnet-4            # 按模型过滤
claude-cost usage --api-keys apikey_01Rj,apikey_02Xz # 按 API 密钥 ID 过滤
claude-cost usage --group-by model,api_key_id        # 按多个维度分组
claude-cost usage --bucket 1h                        # 按小时粒度聚合（支持 1d、1h、1m）

JSON 输出（适用于脚本调用）：

claude-cost usage --json
claude-cost usage --period 30d --json

输出字段：日期、模型、输入 Token 数、缓存 Token 数、输出 Token 数、网络搜索次数。

费用报告

claude-cost cost                                           # 过去 7 天，按描述分组
claude-cost cost --period 30d                              # 过去 30 天
claude-cost cost --from 2026-01-01 --to 2026-01-31        # 自定义日期范围
claude-cost cost --group-by workspace_id,description       # 按工作区 ID 和描述分组
claude-cost cost --sum                                     # 仅输出总费用

JSON 输出（适用于脚本调用）：

claude-cost cost --json
claude-cost cost --sum --json

输出字段：日期、描述、模型、金额（USD）、Token 类型、层级（Tier）。

参数参考

`usage`

参数	说明	默认值
`--from`	起始日期（YYYY-MM-DD 格式或 ISO 时间戳）	7 天前
`--to`	结束日期（YYYY-MM-DD 格式或 ISO 时间戳）	当前时间
`--period`	简写周期（如 7d、30d、90d）	7d
`--model`	按模型过滤（多个模型以英文逗号分隔）	全部
`--api-keys`	按 API 密钥 ID 过滤（多个 ID 以英文逗号分隔）	全部
`--group-by`	分组维度：model、api_key_id、workspace_id、service_tier	model
`--bucket`	聚合粒度：1d、1h、1m	1d
`--json`	以 JSON 格式输出	false

`cost`

参数	说明	默认值
`--from`	起始日期（YYYY-MM-DD 格式或 ISO 时间戳）	7 天前
`--to`	结束日期（YYYY-MM-DD 格式或 ISO 时间戳）	当前时间
`--period`	简写周期（如 7d、30d、90d）	7d
`--group-by`	分组维度：workspace_id、description	description
`--sum`	仅输出总费用	false
`--json`	以 JSON 格式输出	false

安全性与数据存储

以下特性均为设计使然，且均可在源码中验证：

Admin API 密钥：仅存储于 macOS Keychain（服务名：claude-cost-cli）。设计上绝不会以明文形式写入磁盘。实现详见 src/infrastructure/keychain-credential-store.ts。
无配置文件：所有设置均通过 CLI 参数传入；除 Keychain 条目外，不向磁盘写入任何其他内容。
网络通信：设计上，API 密钥仅通过 HTTPS 发送至 api.anthropic.com；不建立任何其他出站连接。详见 src/infrastructure/anthropic-usage-repository.ts 和 src/infrastructure/anthropic-cost-repository.ts。
权限范围：Admin API 密钥仅授予组织级用量与费用数据的只读访问权限，无法修改账单、创建 API 密钥，亦无法访问对话内容。此限制由 Anthropic Admin API 本身定义，并非本 CLI 独有。
无缓存机制：查询结果不会被缓存或持久化至磁盘；CLI 仅将输出写入 stdout。