[DOCS] Claude Code on the web docs omit mid-turn Remote session auto-resume after server restart
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/claude-code-on-the-web
Section/Topic
Remote/cloud session recovery behavior, especially resume, teleport, and expired-environment troubleshooting.
Current Documentation
The page documents setup hooks on resumed sessions:
"Setup script runs before Claude Code starts. It runs only when the environment is first built or after the cache expires; resumed sessions use the cached environment and skip setup."
It also explains cloud-session expiration:
"Cloud sessions stop after a period of inactivity and the underlying environment is reclaimed. From a local terminal, this surfaces as Could not resume session ... its environment has expired. Creating a fresh session instead. On the web, the session is marked expired in the session list."
The page does not describe what happens when a Remote/cloud session is interrupted mid-turn by a server restart before the environment expires.
What's Wrong or Missing?
Claude Code v2.1.196 fixed mid-turn crash recovery for Remote sessions: sessions interrupted by a server restart now auto-resume on the next worker. That is distinct from the documented expired-environment path. A user whose cloud session disappears during a turn currently has docs for expired sessions and teleport behavior, but not for the new automatic worker-level recovery path.
Suggested Improvement
Add a troubleshooting or recovery note near the resume/teleport sections:
If a Remote/cloud session is interrupted mid-turn by a server restart, Claude Code resumes the turn on the next available worker. This recovery path is separate from environment expiration: expired sessions may need a fresh environment, while an interrupted in-progress session should continue from the saved transcript and turn state.
Also cross-reference any status message users should expect while the session is recovering.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/claude-code-on-the-web | Primary docs for cloud/Remote sessions, teleport, and resume behavior |
Total scope: 1 page affected.
Claude Code v2.1.196 added automatic recovery for Remote sessions interrupted mid-turn by a server restart. The current page only describes normal resume/teleport flows and expired environments.