Skip to content
TakoAPI
Back to skills

claude-usage-cli

by cyberash-dev

Browser & Automation
855Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Query Claude API usage and cost reports from the command line.

Description

What This Skill Does

CLI tool for querying Anthropic Admin API usage and cost reports from the terminal. Stores the Admin API key in macOS Keychain. Outputs data as formatted tables or JSON. Note: this package is deprecated; claude-cost-cli is the maintained replacement.

Storing credentials in macOS Keychain avoids plaintext API key files that other CLI tools often require.

When to Use It

  • Check daily token spend across Claude models
  • Pull last 30 days of cost data into a script
  • Filter usage by specific API key IDs
  • Get hourly granularity on a busy billing period
  • Verify total monthly spend before invoice arrives

Example Workflow

INPUT

User asks: how much did I spend on Claude last month?

AGENT
  1. 1

    Run claude-usage config set-key to store Admin API key in Keychain

  2. 2

    Run claude-usage cost --period 30d to fetch last 30 days of cost data

  3. 3

    Review table output showing Date, Description, Model, Amount (USD), Token Type, and Tier

  4. 4

    Run claude-usage cost --period 30d --sum to get a single total figure

OUTPUT

Table of daily cost breakdown by model plus a total USD figure for the past 30 days

Requirements

  • Anthropic Admin API key (sk-ant-admin...) from Claude Console → Settings → Admin Keys
  • macOS (Keychain storage is macOS-only)

Installation

clawhub install cyberash-dev/claude-usage-cli

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links