Claude Code Usage

What this is, in one sentence: a VS Code status-bar monitor that
reads your local Claude Code conversation logs and shows
token-derived usage and cost estimates — plus an optional AI advisor
that suggests how to use Claude Code more economically.

What this is not: a billing tool. All amounts are estimates;
refer to your official Anthropic account for actual charges.

一句话简介:一个 VS Code 状态栏小工具,读取本地 Claude Code
对话日志,按 token × 公开单价估算用量与成本;并提供可选的 AI
建议功能,帮你改进使用习惯。

它不是什么:账单工具。显示金额均为估算值,实际费用请以官方账单为准。

🌐 Multi-language documentation (v1 content; v2 translations in 2.0.1):
English ·
繁體中文 ·
简体中文 ·
日本語 ·
한국어

Screenshots

Status bar

Today's cost · current-session cost · 5-hour and weekly quota utilisation.

Hover the quota indicator for a breakdown:

Real /usage data — utilisation percent, reset countdown, and the
weekly reset weekday and time.

Dashboard

Click the status bar to open the full dashboard. Stacked token-composition
chart, hourly breakdown, cache hit rate, cost composition by token type,
plus per-model and per-day tables below.

Content tab — where your tokens actually go

Estimated breakdown of which content consumes tokens — your prompts vs.
tool results (by tool) vs. assistant output / thinking. This is the lever
for optimising your usage. Scoped to the last 30 days.

AI advice (opt-in)

Optional AI advisor sends your aggregates + a sample of your prompts
to an OpenAI-compatible API (DeepSeek V4 Pro by default) and suggests
concrete rewrites. Bring your own key — or click Preview demo
on the warning prompt to see a static example first.

What's new in 2.0

• Real 5-hour and weekly quota in the status bar — reads Claude Code's
  existing OAuth session at ~/.claude/.credentials.json, zero config.
  Adapted from upstream PR #9
  by @Dobidop.
• Four new tabs: Sessions, Projects, Content, Branches — all sortable.
• Token-composition stacked chart with Y-axis and reference lines.
• AI advice command (DeepSeek V4 Pro default, reasoning_effort=max)
  with a demo-mode fallback when no API key is configured.
• Multi-vendor pricing: Opus 4.x, Sonnet 4.x, Haiku 4.5 (verified
  against Anthropic's public pricing); reference rates for proxied setups
  (OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen) with family-aware fallback.
  Refresh Token Pricing pulls live LiteLLM data as runtime overrides.
• Custom timezone for date display (claudeCodeUsage.timezone).
• Light-theme tab readability fixed.
• Locale-aware numbers and dates throughout (German ., English ,).
• Real-time status bar via fs.watch (1.5 s debounce) + idle-aware
  refresh + non-blocking loader (yields every 25 files).

Full changelog: changelog.md.
Closes upstream issues
#7,
#10,
#11,
#13.

Install

VS Code Marketplace

Search for Claude Code Usage in the Extensions view (Ctrl+Shift+X),
or:

ext install GrowthJack.claude-code-usage

Cursor / Windsurf / Antigravity (Open VSX)

Same extension is published at the Open VSX Registry:
GrowthJack.claude-code-usage.

From a .vsix file

Ctrl+Shift+P → Extensions: Install from VSIX... → pick the
downloaded .vsix.

Configuration

Open Settings (Ctrl+,) and search for Claude Code Usage. All
settings are optional; defaults preserve upstream behaviour where
reasonable.

How costs are calculated

The status-bar cost is Σ (tokens × per-million rate) across input,
output, cache-write and cache-read, summed by model.

• Per-million rates come from the bundled pricing table, which is
  verified against the public Anthropic pricing page and supplemented
  with reference rates for non-Anthropic models that may appear in
  proxied setups.
• Refresh Model Pricing (command + button in the dashboard) pulls
  live prices from LiteLLM's public dataset
  as runtime overrides.
• Unknown model snapshots are priced against the current tier of
  their detected family (Opus / Sonnet / Haiku / GPT / Gemini /
  DeepSeek / Kimi / GLM / Qwen) instead of falling back blindly.

What the status bar does not know:

• Your actual Anthropic invoice (discounts, free credits, plan caps).
• Whether your proxy provider charges different rates.
• Anything not recorded in your local .jsonl log files.

The 5h / weekly quota indicator is different — it queries Claude
Code's real /usage endpoint via the OAuth session and shows the actual
percentage Anthropic is tracking for your account. That number is
authoritative.

Privacy

• All token / cost / session analysis runs locally by reading your
  ~/.claude/projects/**/*.jsonl files.
• The quota indicator calls api.anthropic.com/api/oauth/usage using
  Claude Code's existing OAuth token. No additional credentials are sent.
• The AI advice command is the only feature that calls an external
  service — and only when you trigger it. It sends an aggregate summary
  of your usage plus a sample of your recent user prompts to whatever
  endpoint you configured in advice.apiUrl. Bring your own key;
  nothing is shipped with the extension. If no key is configured, the
  command opens a hand-written demo instead of calling any API.

Troubleshooting

"No Claude Code Data"

• Make sure Claude Code is installed and you have used it at least once.
• Check the dataDirectory setting; auto-detection looks at
  ~/.claude/projects and ~/.config/claude/projects.

Quota row shows 5h:--% wk:--%

• The OAuth token at ~/.claude/.credentials.json is missing or expired.
  Log in to Claude Code once; the extension reads its credential file
  read-only and refreshes the bearer if needed.

Get AI Usage Advice returns 404

• DeepSeek's current endpoint does not use a /v1 prefix. Use
  https://api.deepseek.com/chat/completions. The extension auto-strips
  /v1 if present.

Get AI Usage Advice shows demo instead of real advice

• That means no API key is configured under claudeCodeUsage.advice.apiKey.
  The demo file is filename-marked …-DEMO-… with a prominent banner.
  Add a key in Settings and re-run the command.

Sluggish refresh on large histories

• 2.0 yields to the event loop every 25 files; idle ticks skip recompute.
  If you still hit issues, raise refreshInterval or set
  enableContentAnalysis to false.

Credits

Forked from jack21/ClaudeCodeUsage. MIT-licensed.

• @Dobidop —
  PR #9, the OAuth
  approach for reading real /usage data. The quota indicator in this
  release is adapted from that work.
• @nickearnshaw —
  PR #8, locale-aware
  number/date formatting. The 2.0 implementation follows the same
  direction.
• @brenoneill —
  PR #14, custom
  data directory (merged into upstream 1.0.8).
• @mxzinke — Opus 4.5 / Haiku 4.5 prices
  • German translation (upstream 1.0.8).

Many code changes in this fork were drafted with assistance from
Claude Code (commits include
Co-Authored-By: Claude <[email protected]>).

Changelog

The current changelog lives in changelog.md. The
most recent 2.0 entry summarises every feature, fix and personalisation
option in this release.

v1.0.8 (2025-11-28)

• Converted code comments from Traditional Chinese to English.
• Improved internationalisation standards.
• Pricing: added Opus 4.5 / Haiku 4.5 (thanks @mxzinke).
• Added German (de-DE) translation (thanks @mxzinke).

v1.0.7 (2025-11-28)

• Multilingual translation for hourly usage labels.
• Removed hardcoded Chinese text; switched to i18n.

v1.0.6 (2025-08-10)

• Added support for Claude Opus 4.1 pricing.

v1.0.5 (2025-01)

• Hourly usage statistics + visualisation.

v1.0.4 (2025-01)

• All-time data calculation; "All Time" translations.

v1.0.3 (2025-01)

• Repository URL migration + README image link fixes.

v1.0.0 (2025-01)

• Initial complete release.

Contributing

Issues and pull requests are welcome on the
GitHub repository.

License

MIT