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 · 繁體中文 · 简体中文 · 日本語 · 한국어

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.

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.

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.

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.

• 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.

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

ext install GrowthJack.claude-code-usage

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

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

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

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.

• 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.

"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.

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 <noreply@anthropic.com>).

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

Issues and pull requests are welcome on the GitHub repository.

MIT