Follow Discord
Sweep 27 Oct 2026 · 19:04Z Build v2.1.312 531 read Stable v2.1.308 Latest v2.1.312 Next v2.1.312 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.312 ·

Write refuses to overwrite a file when only its start was read

Claude Code now remembers files that were read only partly, and Write refuses to overwrite them; Read of a large file adds a note to continue with offset

Group of 3 You'll notice Improvements
JSON All of v2.1.312
You'll noticeTier: how much it should matter to you
3Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
File ToolsArea: what it touches
ImprovementsKind: in v2.1.312,
ImprovementsSection of the release

What

When Claude reads a large file, it may see only the beginning. Claude Code now remembers this, and the Write tool, which writes whole files, refuses to overwrite a file it has seen only part of.

  • Write now fails if the earlier read held only the start of the file. Before, Write only checked whether the file had changed since it was last read.
  • Read of a large file adds the note "Only the start of this file is shown." and suggests continuing with offset, the setting that picks where reading starts.
  • The record of which files were read gains markStartOnly, startOnlyPaths and holdsOnlyStartOf, which track the partly read files.
  • A content-entry schema gains an optional startOnly field.

The same finding also notes that the start_rows_max_wait_ms field was removed from a remote-config schema.

Why

Overwriting a file after seeing only its first part could wipe out everything Claude never saw. Claude now has to read the rest of the file first, so expect an extra read or a refused Write on large files.

See this entry in the whole of v2.1.312 →

Feedback