claude-usage-cli
Query Claude API usage and cost reports from the command line. Secure macOS Keychain storage for Admin API key. Table/JSON output.
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- claude-usage-cli
- metadata
- { "clawdbot": { "os": [ "macos" ], "emoji": "📊", "source": "https://github.com/cyberash-dev/claude-usage-cli", "install": [ { "id": "npm", "bins": [ "claude-usage" ], "kind": "shell", "label": "Install claude-usage-cli via npm", "command": "npm install -g claude-usage-cli" } ], "requires": { "bins": [ "claude-usage", "node" ] } } }
- description
- Query Claude API usage and cost reports from the command line. Secure macOS Keychain storage for Admin API key. Table/JSON output.
03 SKILL.md 正文
claude-usage-cli
⚠️ DEPRECATED — This skill is no longer maintained. Please use claude-cost-cli instead, which provides the same functionality with active support.
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 open source: https://github.com/cyberash-dev/claude-usage-cli
npm install -g claude-usage-cli
Install from source (if you prefer to audit the code before running):
git clone https://github.com/cyberash-dev/claude-usage-cli.git
cd claude-usage-cli
npm install && npm run build && npm link
After installation the claude-usage command is available globally.
Quick Start
claude-usage config set-key # Interactive prompt: enter Admin API key (masked)
claude-usage usage # Token usage for the last 7 days
claude-usage cost # Cost breakdown for the last 7 days
claude-usage cost --sum # Total spend for the last 7 days
API Key Management
Store API key (interactive masked prompt, validates sk-ant-admin prefix):
claude-usage config set-key
Show stored key (masked):
claude-usage config show
Remove key from Keychain:
claude-usage config remove-key
Usage Reports
claude-usage usage # Last 7 days, daily, grouped by model
claude-usage usage --period 30d # Last 30 days
claude-usage usage --from 2026-01-01 --to 2026-01-31 # Custom date range
claude-usage usage --model claude-sonnet-4 # Filter by model
claude-usage usage --api-keys apikey_01Rj,apikey_02Xz # Filter by API key IDs
claude-usage usage --group-by model,api_key_id # Group by multiple dimensions
claude-usage usage --bucket 1h # Hourly granularity (1d, 1h, 1m)
JSON output (for scripting):
claude-usage usage --json
claude-usage usage --period 30d --json
Output columns: Date, Model, Input Tokens, Cached Tokens, Output Tokens, Web Searches.
Cost Reports
claude-usage cost # Last 7 days, grouped by description
claude-usage cost --period 30d # Last 30 days
claude-usage cost --from 2026-01-01 --to 2026-01-31 # Custom date range
claude-usage cost --group-by workspace_id,description # Group by workspace and description
claude-usage cost --sum # Total cost only
JSON output (for scripting):
claude-usage cost --json
claude-usage cost --sum --json
Output columns: Date, Description, Model, Amount (USD), Token Type, Tier.
Flag Reference
usage
| Flag | Description | Default |
|---|---|---|
--from <date> |
Start date (YYYY-MM-DD or ISO) | 7 days ago |
--to <date> |
End date (YYYY-MM-DD or ISO) | now |
--period <days> |
Shorthand period (7d, 30d, 90d) | 7d |
--model <models> |
Filter by model(s), comma-separated | all |
--api-keys <ids> |
Filter by API key ID(s), comma-separated | all |
--group-by <fields> |
Group by model, api_key_id, workspace_id, service_tier | model |
--bucket <width> |
Bucket width: 1d, 1h, 1m | 1d |
--json |
Output as JSON | false |
cost
| Flag | Description | Default |
|---|---|---|
--from <date> |
Start date (YYYY-MM-DD or ISO) | 7 days ago |
--to <date> |
End date (YYYY-MM-DD or ISO) | now |
--period <days> |
Shorthand period (7d, 30d, 90d) | 7d |
--group-by <fields> |
Group by workspace_id, description | description |
--sum |
Output total cost only | false |
--json |
Output as JSON | false |
Security and Data Storage
- Admin API key: stored exclusively in macOS Keychain (service:
claude-usage-cli). Never written to disk in plaintext. - No config files: all settings are passed via CLI flags. Nothing is stored on disk besides the Keychain entry.
- Network: the API key is only sent to
api.anthropic.comover HTTPS. No other outbound connections are made. - 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.
- No caching: query results are not cached or persisted to disk.
API Reference
This CLI wraps the Anthropic Admin API:
- Usage:
GET /v1/organizations/usage_report/messages - Cost:
GET /v1/organizations/cost_report
Documentation: https://platform.claude.com/docs/en/build-with-claude/usage-cost-api
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.