Real-time Claude token usage estimator — know your context window before you send.
ClodCount is a lightweight Chrome Extension that injects a floating token-counter widget into claude.ai. It estimates token usage in real-time as you type — showing input tokens, total context consumption, and remaining budget — all client-side, zero servers.
- Real-time token estimation — updates as you type, paste, or undo/redo (debounced 320ms)
- Granular Token Breakdown — separates "Prompt" (input) from "Memory" (chat history)
- Live API Usage Tracking — automatically mirrors Claude's native 5-Hour and 7-Day limits natively via SSE interception and polling
- Prompt Optimization Hints — warns of 50k+ inputs or heavily repeating string blocks
- Two-section display — INPUT TOKENS and CONTEXT USED, each with a progress bar and sub-text
- Color-coded status — green (safe) → amber (≥75%) → red (≥90%)
- Smart tokenizer — separate multipliers for Latin, CJK, code blocks, and emoji
- History-aware — estimates include the last 20 messages from your conversation history
- Model selector — Opus, Sonnet, Haiku (all 200k context) via the popup
- Draggable & collapsible — position persisted across sessions via
chrome.storage.sync - SPA resilient —
MutationObserverre-attaches on every navigation
ClodCount matches claude.ai's exact design language — the same warm earthy palette, Inter font, 16px border-radius, and card shadow used natively. Both light and dark modes are supported automatically.
| Token | Light Mode | Dark Mode |
|---|---|---|
| Card background | #ffffff |
#2a2826 |
| Accent (progress bar) | #d97757 |
#d97757 |
| Text primary | #1a1a18 |
#f0ece6 |
Latin / English → characters ÷ 4
CJK → characters ÷ 2
Code blocks → characters ÷ 3.5 (extracted first via regex)
Emoji → 1 token per emoji (Unicode property escapes)
System buffer → +1,000 tokens (always added to total)
History → last 20 human-turn messages, summed
Accuracy: approximately ±15–25%. Displayed disclaimer keeps expectations honest.
Chrome / Edge / Chromium
- Download
ClodCount - Go to
chrome://extensionsand enable Developer mode - Drag and drop the zip onto the page OR
- Extract the zip file.
- Click Load unpacked → select the
ClodCountfolder - Navigate to
https://claude.ai— the widget appears bottom-right
ClodCount/
├── manifest.json # MV3 — permissions, scripts, popup
├── src/
│ ├── bridge.js # Injected WebSocket/SSE interceptor for live usage limits
│ ├── tokenizer.js # Token estimation engine (pure, zero DOM)
│ ├── content.js # Widget injection, events, MutationObserver, DOM polling
│ ├── background.js # Service worker — chrome.storage.sync
│ ├── widget.css # Floating widget styles
│ ├── popup.html # Settings popup markup
│ ├── popup.css # Popup styles
│ └── popup.js # Popup logic
├── icons/
│ ├── icon16.png
│ ├── icon48.png
│ └── icon128.png
└── scripts/
├── generate_icons.js # Node.js zero-dep PNG generator
└── generate_icons.html # Browser canvas icon downloader
- All processing is local — tokenization algorithm runs 100% locally
- No external servers — zero network requests outside of
claude.ai - Usage API Tracking — usage stats are pulled securely hitting only Claude's native
claude.ai/api/organizations...endpoints - No tracking, no analytics
- Only permissions used:
storage(save preferences),tabs(notify tab on settings change),activeTab
- Prompt optimization hints (repetition detection, length warnings)
- Token breakdown: input vs. conversation history
- SPA Navigation Fix
- Real usage limit tracking via live API/SSE interception (5-Hour / 7-Day)
- Interactive UI help tooltips
- Cross-platform support (ChatGPT, Gemini)
- AI-assisted prompt rewriting
See CONTRIBUTING.md for guidelines, branch conventions, and how to submit a pull request.
MIT © 2026 ClodCount Contributors