What
A session's transcript is the file where Claude Code saves a conversation so it can be resumed later. On Windows, reading it sometimes failed with an EBADF error even though the file opened normally, and resuming gave no reason why.
- Claude Code now recognises Windows errors with code EBADF from a read, including when the error is wrapped inside another error.
- When
--resumefails this way, by session ID or by.jsonlfile path, the old one-line error ("Unable to load transcript from file" or "Failed to resume session") now gets an explanation. It says "Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally." It adds that security, encryption or endpoint-management software may be intercepting file reads, and suggests excluding the transcript or.claudefolder, or allowing Claude Code, in that software. - These failures are now logged as load errors rather than reported as crashes.
/resume <id>now shows a message starting "Failed to resume: " and logs the failure when a session fails to load with a recognised error. Before, it failed with no message.
Why
Windows users whose sessions would not resume now get a likely cause and a concrete fix, usually an exclusion in their security software.
Names in the bundle--resume
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 --resume, on Manage sessions.
A `claude -p --resume` or `claude -p --continue` run resumes in plan mode only when all of these conditions hold:sessions see the edit
Added since
A small documentation edit on Hooks reference touched a line naming --resume after this was published.
To resume a deferred session in plan mode, pass [`--permission-prompt-tool`](/docs/en/cli-reference#cli-flags) along with `--resume` so that Claude Code can present the plan for approval. If you pass certain other launch flags, the resumed…hooks see the edit
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agrees
A small documentation edit on Hooks reference touched a line naming --resume after this was published.
Anthropic's release notes agree
Fixed more cases of continued or resumed sessions (--continue, --resume) re-sending earlier messages in a changed form, which could make the…