Claude Code v2.1.271 · 14 Sep 2026
$.session.usage() plugin call now accepts and validates options
The plugin $.session.usage() call now takes breakdown and columns options, validated before running
Use it now Tier: how much it should matter to you
2 Useful: my rating, 1 to 5
1 Signal: worth watching, 1 to 5
Plugin API Area: what it touches
Internal Changes Kind: in v2.1.271, 14 Sep 26
What probably matters to you Section of the release
What
The $.session.usage() call available to plugins previously took no arguments. It now accepts an optional options object with:
A new validation step checks these values (and rejects unknown keys) before the call runs, instead of running unchecked.
Why
Plugin authors get immediate, clear errors if they pass invalid options to session.usage (), instead of the call silently misbehaving or failing later.
See this entry in the whole of v2.1.271 →
14 Sep 2026 · 420 entries, this one is #51.
Use it now37 You'll notice128 Nothing to try yet21 Under the hood234
Open the release →
Names in this entry
setting breakdown Session usage requests can now include a detailed cost/context breakdown
setting summary Messages with a blank summary now show their full text instead of collapsing into an empty line.
setting full Plan mode now remembers your workshop doc and can offer a prototype path alongside it.
setting session.usage Plugins and hooks gain new permission scopes: session.usage, settings.read, env.get, env.set
Is this right?
0
0
Feedback
What's wrong with this entry?
Hard to understand Too vague Looks wrong Not relevant to me Too long Missing the detail I wanted Duplicate of another card
Clear Learned something new I can act on this Good catch
Related
Other releases about the same thing. Found by shared names or similar wording; neither means one caused the other.
← Previous · 50 of 420
modelPricing.multiplier validation range widened
Use it now Cost Reporting
In v2.1.271 What probably matters to you release-page order
Next → · 52 of 420
'quickstart' action added to MCP server actions
Use it now MCP