# Claude Code usage tracker for Mac

> See what your coding agents cost and how close you are to their limits.

- Canonical URL: https://getedith.pro/extensions/claude-code-usage
- Category: [Agents & Terminal](https://getedith.pro/extensions/category/coding-agents-and-terminal)
- Extension ID: `usage`
- Updated: 2026-11-15
- Part of: [Edith](https://getedith.pro/), a Mac app for macOS 14 or later on Apple silicon, [$35 once for one Mac, plus $7 for each additional Mac](https://getedith.pro/pricing)

Usage is an Edith extension that reads the session history Claude Code and Codex keep on your Mac, adds your Cursor usage, and shows tokens, estimated cost and rate limits by day, model and project.

## Overview

Claude Code and Codex write a log entry for every request they make, and those logs pile up in your home folder whether you look at them or not. Usage parses them, counts input, output and cache tokens per request, and prices each one with a bundled list of public model rates. On a flat subscription you never pay those amounts, but the figure still tells you which models and repositories do the heavy lifting. Only token counts, model names, timestamps and folders are used. Your prompts and code are never read.

Rate limits are the other half. Claude and Codex meter plans in a five-hour session window and a weekly window, and Cursor meters included usage in billing-cycle pools. Usage polls each provider with the sign-in you already have on this Mac and draws every window as a ring with a countdown to its reset. The same numbers sit in the menu bar as compact percentages that turn amber at 60 percent and red at 85 percent by default, or follow a time-aware risk tint that compares your use with an even pace to the reset.

It is built for people who run agents for hours and keep hitting a wall halfway through a task, and for anyone who wants to know which project ate a week of quota. A GitHub-style heatmap shows daily spend across your whole history, and the project view matches each session's folder, worktrees included, to its repository.

- Claude Code, Codex and pi activity attributed to the right machine, repository, worktree and chat.
- Claude, Codex and Cursor rate limits as live rings with countdowns and history.
- A menu bar readout with compact or roomy layouts and a time-aware risk tint.
- Threshold, ahead-of-pace, burning-hot, back-to-green and pre-reset alerts, all optional.
- A GitHub-style heatmap of daily spend across your whole history.
- Share cards for activity, tokens and milestones, from the dashboard or the CLI.
- Fleet usage: the same collector runs on your SSH machines and folds their agents in.

## How to check your Claude Code usage and limits on Mac

1. **Collect your history**: Open Usage and press the refresh button at the top. The first run can take a few minutes.
2. **Explore the numbers**: Filter by range, model, project or agent to see where tokens and money go.
3. **Watch your limits**: Rate limits show how much of each plan you have used and when it resets.
4. **Get warned early**: Turn on limit alerts in settings to hear about it before you run out.

## What you can do

- **See what your agents cost**: Tokens and spend by day, model and project.
- **Check your rate limits**: How much of each plan you have used and when it resets.
- **Get warned before a limit**: Turn on alerts so you hear about it before you run out.

## Can a Mac show Claude Code usage on its own?

No. macOS has no view of coding agent usage, and Activity Monitor only shows the processes. Each tool reports its own numbers in its own place: Claude Code and Codex can print plan usage from inside a session, and Cursor shows usage on its website. Usage puts Claude, Codex and Cursor side by side, keeps the history after the windows reset, adds cost by project, and warns you before a limit instead of after.

## Use cases

### Plan a long agent run around the weekly reset

Before you start a multi-hour refactor in Claude Code, glance at the weekly ring and its countdown. At 80 percent with two days to go, turn on the ahead-of-pace alert so Edith warns you if the recent burn rate would hit the cap before the reset, or move the job to Codex, whose limits sit in the next ring.

### Find the repository that burns your quota

Open the project drilldown and sort by cost. Sessions from every worktree of a repository roll up into one row, so a monorepo with five checkouts shows as one line instead of five. Folders that are not on GitHub are matched too, and ed usage attribution shows how each one was assigned.

### Count agents running on your build servers

If Claude Code or Codex also runs on computers you added in Machines, ed usage machines collect runs a collector there over SSH and brings the totals back. The first run on a machine installs what it needs. Those machines then join every refresh, and you can filter the dashboard to one machine or to this Mac alone.

### Share a month of agent work

ed usage export renders highlights, activity, daily and busiest cards as high-resolution PNG images, and --clipboard copies the first one, ready to drop into a team update or a post about what you built.

## Tips

- **Stay up to date**: Press **refresh** any time to collect your newest usage. The first run can take a few minutes.
- **Filter the numbers**: Pick a **range**, **model** or **project** to see where tokens and money go.

## Command line and MCP

Run `ed usage` from Terminal, and add `--json` for JSON output. Coding agents connected to the [Edith MCP server](https://getedith.pro/mcp) call the same commands as tools whose names start with `edith_usage`.

```sh
ed usage summary
ed usage limits
ed usage daily
ed usage refresh
```

## Permissions

- No Accessibility, Screen Recording or Full Disk Access
- Keychain access to read your existing Claude Code sign-in, which macOS may ask you to allow
- Notifications, only if you turn on limit alerts

## Requirements

- macOS 14 or later on Apple silicon
- Claude Code, Codex or Cursor signed in on this Mac
- The Machines extension and SSH access, to collect usage from other computers

## FAQ

### Does Usage read my prompts or code?

No. It reads the token counts, model name, timestamp and working folder of each entry in the agents' session logs and skips the message text. Rate limits come from the provider's own usage endpoint, using the login that Claude Code, Codex or Cursor already saved on this Mac.

### How accurate is the cost figure?

It is an estimate. Usage multiplies each request's tokens, including cache reads and writes, by a bundled table of public per-token prices. If you pay a flat monthly plan, read it as a relative measure of which models and projects use the most, not as a bill.

### Which coding agents does it track?

Claude Code and Codex history comes from their local session logs. Cursor rate limits and usage history come from your Cursor account. The rings and menu bar readout cover Claude, Codex and Cursor windows, and settings choose what the menu bar shows for each provider.

### Can Claude Code check its own limits over MCP?

Yes. Every ed usage command is also a tool in Edith's MCP server, such as edith_usage_limits, edith_usage_summary and edith_usage_daily. An agent can read the weekly window before it starts a long task, and ed usage limits --refresh asks Edith to poll the providers again first.

### Will it warn me before I run out?

If you turn alerts on. Options include crossing an almost-capped line (90 percent by default), a pace that would hit the cap before the reset, hitting 100 percent with the reset time, a capped window coming back, and a morning outlook when a weekly window looks tight. ed usage alerts explains what each window would alert about right now.

### Is Usage included in Edith's one-time price?

Yes. Usage is one of the extensions included with an Edith license. There is no separate subscription for usage tracking and no per-agent fee.

## Works well with

- [Run Multiple Claude Code and Codex Agents on Mac](https://getedith.pro/extensions/coding-agents): See every coding agent on your Macs in one board, and step in when one needs you.
- [Screen Time Tracker for Mac With Focus Sessions](https://getedith.pro/extensions/screen-time-tracker): See which apps and sites really get your time, and protect your focus.
- [Keep MacBook Awake With the Lid Closed](https://getedith.pro/extensions/lid-awake): Keep your Mac running with the lid closed.

## Guides

- [How to Check Claude Code Usage Limits on Mac](https://getedith.pro/guides/check-claude-code-usage-limits): Check Claude Code usage limits on your Mac with /usage, claude.ai settings and the status line, or keep the 5-hour and weekly limits in the menu bar.
- [How to Check Codex Usage Limits on Mac](https://getedith.pro/guides/check-codex-usage-limits): Check Codex usage limits on your Mac with /status and the ChatGPT usage dashboard, or keep the 5-hour and weekly Codex limits in the menu bar.
- [How to Run Multiple Claude Code Agents on Mac](https://getedith.pro/guides/run-multiple-claude-code-agents-mac): Run several Claude Code agents in parallel on a Mac with git worktrees and agent view, then watch every agent on one board and answer the blocked ones.
- [How to Add an MCP Server to Claude Code on Mac](https://getedith.pro/guides/add-mcp-server-claude-code): Add an MCP server to Claude Code on a Mac with claude mcp add, pick the right scope, check it with /mcp, and connect Edith's tools in one command.

## Use cases

- [Run Coding Agents Overnight on a Mac With Edith](https://getedith.pro/use-cases/run-coding-agents-overnight): Run Claude Code and Codex agents overnight on a Mac: keep it awake with the lid closed, queue the next task, and wake up to limits, costs and results.
- [Manage Servers From Your Mac With Edith](https://getedith.pro/use-cases/manage-servers-from-your-mac): Manage SSH servers from your Mac: health, terminals, Docker, port forwards, a database client and agent usage across machines, from one app and the ed CLI.

## Compare

- [Edith vs Raycast: One-Time Mac Toolkit Compared](https://getedith.pro/compare/edith-vs-raycast): Edith vs Raycast on Mac: a free launcher with paid AI plans, or one payment for a launcher plus agent usage, MCP control and Mac utilities.
- [Edith vs Alfred: Mac Launcher and Toolkit Compared](https://getedith.pro/compare/edith-vs-alfred): Edith vs Alfred for Mac: a free launcher with a paid Powerpack and a deep workflow ecosystem, or a launcher plus agent tools, MCP and Mac utilities.
- [ccusage Alternative for Mac: Menu Bar Usage Tracker](https://getedith.pro/alternatives/ccusage): A ccusage alternative for Mac: Claude Code and Codex cost and live rate limits in the menu bar, with alerts and SSH fleet totals. Paid once, with a CLI.
- [Amphetamine Alternative: Keep Mac Awake for Agents](https://getedith.pro/alternatives/amphetamine): An Amphetamine alternative for Mac: keep a MacBook running with the lid closed while agents and builds finish, with timers, battery floors, CLI and MCP.

## Coding agents

- [Claude Code on Mac: Usage, Limits and MCP](https://getedith.pro/agents/claude-code): Track Claude Code usage and rate limits in your Mac menu bar, feed the status line, answer permission prompts and connect Claude Code to Edith over MCP.
- [Codex on Mac: Usage Limits, Workspaces and MCP](https://getedith.pro/agents/codex): See Codex usage limits and history on your Mac, run Codex agents side by side on one board, answer approvals and connect Codex to Edith over MCP.
