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.267 ·

Prompt-cache-break diagnostics reworked, with a new bypass path for one source

Internal prompt-cache-break diagnostics were restructured, with a new bypass for one message source and for disk-seeded cache state

TierUnder the hoodhow much it should matter to you
Useful1my rating, 1 to 5
Signal2worth watching, 1 to 5
AreaCompactionwhat it touches
KindInternal Changesin v2.1.267,
Under the hood

Internal prompt-cache-break diagnostics were restructured, with a new bypass for one message source and for disk-seeded cache state

What

Claude Code's internal logic for detecting "prompt cache breaks" (when a cached prompt prefix stops being reusable) was reorganized: the threshold logic for deciding when a break occurred now lives in a shared helper. A new branch handles the case where a specific message source reports no session state, logging a diagnostic event with request ID and cache token counts instead of just returning early. There's also a new early exit that skips break diagnosis entirely when the cache state was seeded from disk.

Why

This is internal diagnostic plumbing rather than a user-facing feature; it should make prompt-cache-break issues easier to trace by giving certain edge cases (missing session state, disk-seeded cache) their own explicit handling instead of falling through to generic logic.

See this entry in the whole of v2.1.267 →