claude-cost-cli

A CLI for querying Anthropic Admin API usage and cost data. Requires an Admin API key (sk-ant-admin...) from Claude Console → Settings → Admin Keys. Credentials are stored in macOS Keychain.

Installation

Requires Node.js >= 18 and macOS. The package is fully open source under the MIT license: https://github.com/cyberash-dev/claude-cost-cli

CODEBLOCK0

The npm package is published with provenance attestation, linking each release to its source commit via GitHub Actions. You can verify the published contents before installing:
CODEBLOCK1

Install from source (if you prefer to audit the code before running):
CODEBLOCK2

After installation the claude-cost command is available globally.

Quick Start

CODEBLOCK3

API Key Management

Store API key (interactive masked prompt, validates sk-ant-admin prefix):
CODEBLOCK4

Show stored key (masked):
CODEBLOCK5

Remove key from Keychain:
CODEBLOCK6

Usage Reports

CODEBLOCK7

JSON output (for scripting):
CODEBLOCK8

Output columns: Date, Model, Input Tokens, Cached Tokens, Output Tokens, Web Searches.

Cost Reports

CODEBLOCK9

JSON output (for scripting):
CODEBLOCK10

Output columns: Date, Description, Model, Amount (USD), Token Type, Tier.

Flag Reference

usage

Flag	Description	Default
INLINECODE4	Start date (YYYY-MM-DD or ISO)	7 days ago
INLINECODE5

End date (YYYY-MM-DD or ISO) | now |

cost

Flag	Description	Default
INLINECODE13	Start date (YYYY-MM-DD or ISO)	7 days ago
INLINECODE14

End date (YYYY-MM-DD or ISO) | now |

Security and Data Storage

The following properties are by design and can be verified in the source code:

• - Admin API key: stored exclusively in macOS Keychain (service: claude-cost-cli). By design, never written to disk in plaintext. See src/infrastructure/keychain-credential-store.ts for the implementation.
• No config files: all settings are passed via CLI flags. Nothing is stored on disk besides the Keychain entry.
• Network: by design, the API key is only sent to api.anthropic.com over HTTPS. No other outbound connections are made. See src/infrastructure/anthropic-usage-repository.ts and src/infrastructure/anthropic-cost-repository.ts.
• Scope: the Admin API key grants read-only access to organization usage and cost data. It cannot modify billing, create API keys, or access conversation content. This is a property of the Anthropic Admin API, not just this CLI.
• No caching: query results are not cached or persisted to disk. The CLI writes output to stdout only.

API Reference

This CLI wraps the Anthropic Admin API:

• - Usage: INLINECODE24
• Cost: INLINECODE25

Documentation: https://platform.claude.com/docs/en/build-with-claude/usage-cost-api