claude-cost-cli
v0.1.1
Published
CLI for Claude API usage and cost reports
Maintainers
Readme
claude-cost-cli
CLI for Claude API usage and cost reports. Uses the Anthropic Admin API (Usage & Cost API).
Requirements
- Node.js 18+
- macOS (uses Keychain for credential storage)
Install
npm install -g claude-cost-cliOr run without installing:
npx claude-cost-cliCommands
config set-key
Store your Admin API key in macOS Keychain. Requires an Admin API key (starts with sk-ant-admin) from Claude Console → Settings → Admin Keys.
claude-cost config set-keyconfig show
Display masked API key.
claude-cost config showconfig remove-key
Remove API key from Keychain.
claude-cost config remove-keyusage
Retrieve usage report with token counts.
claude-cost usage
claude-cost usage --period 30d --model claude-opus-4
claude-cost usage --from 2025-01-01 --to 2025-01-31 --json
claude-cost usage --api-keys apikey_xxx --group-by model,api_key_idOptions: --from, --to, --period (7d/30d/90d), --model, --api-keys, --group-by, --bucket (1d/1h/1m), --json
cost
Retrieve cost report in USD.
claude-cost cost
claude-cost cost --period 30d --group-by workspace_id,description
claude-cost cost --sum
claude-cost cost --jsonOptions: --from, --to, --period, --group-by, --sum (output total only), --json
