Free tool · no signup, nothing to install

Claude Usage Checker

See what is left of your Claude limits and when each one resets. Pick one file from your computer, and it is read right here in your browser.

ContextBolt · Claude usage checker reads in your browser
Your file stays on your computer

Pick .claude.json from your home folder

Claude Code saves your limits there each time it checks them with Anthropic. This page reads them in your tab.

or drop it on this window

On a phone? The file is on the computer you run Claude Code on, so open this page there.

Can’t see it?
  1. In the file picker, press Cmd+Shift+G, type ~ and press Return to open your home folder.
  2. Press Cmd+Shift+. to show hidden files, then pick .claude.json.
  1. In the file picker, type %USERPROFILE% in the File name box and press Enter.
  2. Pick .claude.json. Not there? Turn on Hidden items in File Explorer's View menu.
  1. In the file picker, press Ctrl+L, type ~/.claude.json and press Enter.
  2. Or open your home folder and press Ctrl+H to show hidden files.
~/.claude.json
The checker uses one entry, your usage. Everything else in the file, your account details included, is ignored and nothing is uploaded.

Use Claude only for chat? Your limits are at claude.ai/settings/usage.

Where Claude Code keeps .claude.json

In your home folder, next to the .claude folder rather than inside it. The dot at the front hides it, so the file picker needs one shortcut.

  • macOS

    ~/.claude.json
    1. In the file picker, press Cmd+Shift+G, type ~ and press Return to open your home folder.
    2. Press Cmd+Shift+. to show hidden files, then pick .claude.json.

  • Windows

    C:\Users\you\.claude.json
    1. In the file picker, type %USERPROFILE% in the File name box and press Enter.
    2. Pick .claude.json. Not there? Turn on Hidden items in File Explorer's View menu.

  • Linux

    ~/.claude.json
    1. In the file picker, press Ctrl+L, type ~/.claude.json and press Enter.
    2. Or open your home folder and press Ctrl+H to show hidden files.

Claude Code in WSL? The file is in your Linux home, at \\wsl.localhost\Ubuntu\home\you\.claude.json with your distribution’s name. Set CLAUDE_CONFIG_DIR? Then .claude.json is in that folder.

How Claude’s usage limits work

Every paid plan has two, and the checker draws one ring for each. Anthropic does not publish them as message counts, so what is left is a share of each.

5 hours Current session

The session limit resets every five hours. It is the loud one. It stops you in the middle of a task, then comes back within five hours.

7 days This week

The weekly limit resets at a fixed time each week that Anthropic assigns to your account. It is the quiet one. Run it out on a Thursday and nothing comes back until your reset day.

  • Shared with Claude chat: claude.ai, Claude Desktop and Claude Code all count against the same limits, so the rings include your chats.
  • A model’s own week: Max plans also have a separate weekly limit for Fable. When your file has one, it shows as a small ring under the other two.

Keep these rings live on Context Board

This page reads one file, once. Context Board keeps the same rings on screen for Claude Code and Codex, beside the sessions that are waiting for you.

AI usageClaude Code · Codexnow
Claude Code
38%leftCurrent sessionresets in 1h 42m
71%leftThis weekresets Mon 9:00 AM
Codex
84%leftCurrent sessionresets in 3h 5m
92%leftThis weekresets Thu 2:00 PM
As they last checked, 2m ago
Claude Codelanding · main1m
Working
Writing the pricing page tests
Fixed the trial banner
Needs you1 sessionnow
  • Codex · apiasks to run migrations4m
Today's commitsGitnow
  • Trial banner reads the real pricelanding11:42
  • Webhook retries on 429api10:18
  • Add the usage widgetboard09:03

Claude under 20% of the week? The next big refactor goes to Codex.

An example Context Board named Agents. Every number on it is example data.

  • Add it once

    Start from the Agents template, which has AI usage on it, or add AI usage from the gallery.

  • Every computer

    A small program, set up once with one line, links each computer. Usage comes from all of them.

  • Your sessions stay yours

    Only names, states and percentages leave your computer, never what was said in a session.

Start free trial Try the live demo

Free for 3 days, then $12 a monthHow the AI usage widget worksSee Context Board

Frequently asked questions

Something else on your mind? Get in touch.

How do I check my Claude usage?

In Claude Code, type /usage. On a Pro or Max plan it shows bars for your plan's limits. On the web or in Claude Desktop, open Settings, then Usage, at claude.ai/settings/usage. This checker shows the same limits from the copy Claude Code keeps in .claude.json, with nothing to install.

Is my .claude.json uploaded anywhere?

No. The file is opened by JavaScript in your own tab, and the checker keeps one entry from it, your usage. Nothing is uploaded or stored, and the rest of the file, your account details included, is ignored. Like every page on this site, this one loads fonts and analytics, and none of those requests carries anything from your file. Once the page has loaded, the checker works with your internet off. What the site collects is on our privacy page.

Where is .claude.json?

In your home folder, next to the .claude folder rather than inside it. That is ~/.claude.json on macOS and Linux, and C:\Users\you\.claude.json on Windows. The leading dot hides it. In a Mac file picker, Cmd+Shift+. shows hidden files. On Linux, Ctrl+H does. If you set CLAUDE_CONFIG_DIR, the file is in that folder instead.

Why does it say Claude Code has not saved a reading?

Claude Code writes your limits into .claude.json when it checks them with Anthropic. Type /usage in Claude Code, then pick the file again. If /usage shows no plan bars, for example because Claude Code is using an API key, there are no plan limits for it to save.

Are Claude Code limits shared with Claude chat?

Yes. Anthropic says usage across claude.ai, Claude Code and Claude Desktop counts toward the same limits, and Claude Code in VS Code or JetBrains counts too. An afternoon of long chats leaves less for Claude Code that evening. How to check Claude Code usage covers how the limits work.

Does it count tokens or cost, like ccusage?

No. It shows how much of your plan's limits is left and when each resets, which is what Anthropic counts on Pro and Max. ccusage reads Claude Code's logs and reports tokens and an estimated cost, which matters more on the API. Context Board vs ccusage sets the two side by side.

Go deeper

Keep reading

Every free tool

Keep your limits in sight

Context Board is free for 3 days, then $12 a month. One plan with every connection, widget and theme.

Start free trial Try the live demo first