Follow Discord
Sweep 01 Oct 2026 · 17:27Z Build v2.1.287 508 read Stable v2.1.285 Latest v2.1.287 Next v2.1.287 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.286 ·

Usage accounting reads cache writes split by 5-minute and 1-hour lifetime

Claude Code now reads the API's cache_creation breakdown, tells 5m and 1h cache writes apart, and uses it for cache lifetime decisions

Group of 2 Under the hood Internal Changes
JSON All of v2.1.286
Under the hoodTier: how much it should matter to you
1Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
Prompt CacheArea: what it touches
Internal ChangesKind: in v2.1.286,
Internal ChangesSection of the release

What

When Claude Code sends a request, it can store part of the conversation in a prompt cache so later requests are faster and cheaper. Cached entries last either 5 minutes or 1 hour. The API's usage report can now say how many cached tokens were written at each lifetime, and Claude Code reads that.

  • The usage format now accepts a cache_creation object holding ephemeral_5m_input_tokens and ephemeral_1h_input_tokens.
  • The cache fields and server_tool_use may now be missing or empty without causing a problem.
  • When usage from several responses is combined, cache_creation is kept, and cache_creation_input_tokens is worked out from it.
  • A new check reports whether the cache lifetime was 1h or 5m from these counts.
  • The fallback that picks the cache lifetime for the main conversation now calls a function. Before, it chose 1h for the main thread and 5m otherwise.
  • Each usage record now carries cache_creation_5m_input_tokens and cache_creation_1h_input_tokens, each 0 when not reported.

Why

The cache lifetime is now taken from what the API reported rather than assumed. That feeds Claude Code's decisions about cache misses and keeping the cache alive, and it lets the cost of cache writes be split by lifetime.

How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtWhat the new fallback rule for the main conversation returns is not clear.

See this entry in the whole of v2.1.286 →

Feedback