Metadata-Version: 2.4
Name: claude-usage
Version: 0.0.15
Summary: macOS menu bar app for Anthropic API usage and cost tracking
Project-URL: Repository, https://github.com/anderslatif/claude-usage
Author: Anders Latif
License: MIT
Keywords: anthropic,api,claude,macos,menu-bar,usage
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: MacOS X
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: keyring>=25.6.0
Requires-Dist: pyobjc-framework-coretext>=12.1
Requires-Dist: pyobjc-framework-quartz>=12.1
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: requests>=2.32.3
Requires-Dist: rumps>=0.4.0
Description-Content-Type: text/markdown

# Claude Usage Mac Menu

[![](https://img.shields.io/pypi/v/claude_usage.svg)](https://pypi.org/pypi/claude_usage/)


<img src="https://raw.githubusercontent.com/anderslatif/claude-usage/main/assets/menu_item_example.png" alt="doctordoc logo" width="350" >


A macOS menu bar app that shows your Anthropic API spend and token usage in real time - like a battery indicator for your API budget.

---

## Get started

```bash
$ pip install claude-usage
$ claude-usage
```

**Pre-requsite**: Having authenticated with Claude Code:

```bash
$ claude
```

---

## How it works

The data is retrieved by sending a request to Anthropic's Messages API and reading the rate-limit headers from the response. The input token is `hi` and the output token is capped to 1. This is achieved with the OAuth token that Claude Code stores in the macOS Keychain. By default the app polls every `60 seconds` but it can be configured in the menu bar. 

Recommended usage is to run the app when needing to closely monitor usage in real-time and not as a permanent fixture.



