Sweep 19 Sep 2026 · 02:36Z Build v2.1.278 500 read Stable v2.1.267 Latest v2.1.278 Next v2.1.278 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.273 ·

New structured /usage response schema, explicitly marked experimental

The /usage command gains a formally defined, still-experimental structured data schema

TierNothing to try yethow much it should matter to you
Useful4my rating, 1 to 5
Signal3worth watching, 1 to 5
AreaUsagewhat it touches
KindIn Developmentin v2.1.273,
Nothing to try yet

The /usage command gains a formally defined, still-experimental structured data schema

What

The data behind the /usage command (which shows session cost, plan usage limits, and activity stats) now has a formally defined structure covering:

  • session cost, duration, and lines-of-code totals
  • rate-limit rows, each with kind, group, percent used, reset time, scope, severity, and whether it's currently active, exactly as sent by the server
  • extra-usage (overage) spend details: whether it's enabled, the monthly limit, credits used, utilization, and currency

This is explicitly marked as experimental, meaning the shape may still change.

Why

A well-defined structure for usage data makes it easier for tools built on top of Claude Code, such as the SDK, to reliably read cost and rate-limit information, though it isn't finalized yet.

Read from
Names in the bundle/usage
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Confirmed since Anthropic's documentation has since written up /usage, on Claude Code changelog. * Fixed error hints in Claude Desktop sessions to suggest slash commands like `/usage-credits` instead of CLI flags that cannot be used there changelog see the edit
How sure we are
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agreesAnthropic's documentation has since written up /usage, on Claude Code changelog.

See this entry in the whole of v2.1.273 →