Claude Code v2.1.203 — Session Expiry Warning, Smaller Binary, Faster Startup
Anthropic released Claude Code v2.1.203 on July 7 with a login token expiry warning, automatic recovery of frozen background sessions, and a roughly 7 MB reduction in binary size. Several bugs slowing macOS and disrupting sub-agent behavior have also been fixed.
This article was generated using artificial intelligence from primary sources.
Anthropic released version v2.1.203 of Claude Code on July 7, 2026 at 21:06 UTC. This update delivers a series of improvements focused on background session stability, startup performance, and sub-agent behavior fixes, along with a practical new feature that warns users before their login token expires.
Why Was Token Expiry a Problem?
Until now, when a daemon session token expired, background sessions became permanently unresponsive — they could not be attached to, did not accept responses, and the stop command had no effect. The user would only discover the problem when attempting to resume work in a session that appeared active but was in fact frozen.
Version v2.1.203 addresses this problem in two ways. First, a login credential expiry warning has been added, displayed early enough for the user to re-authenticate before the session is interrupted. Second, sessions that have already become unresponsive due to an expired token now recover automatically.
Fixed Bugs: macOS, Sub-Agents, Context Indicator
The release includes several fixes resolving specific and reproducible issues:
macOS freeze when opening sessions. Opening or switching to a background agent session on macOS caused a freeze of 15 to 20 seconds due to a false detection of low memory. The bug is fully fixed.
Sub-agents in worktree isolation. Sub-agents operating within a worktree-isolated environment were silently executing commands in the parent checkout rather than the isolated worktree. This behavior could lead to unintended changes in the main repository.
Task re-delegation. Sub-agents exhibited a tendency to re-delegate entire tasks rather than continuing their work. In this version, work completed by a stopped sub-agent is correctly carried forward, reducing redundancy and unnecessary repetition.
Context-usage indicator. The context usage indicator was re-analyzing the entire transcript after every turn, causing a performance regression that was especially visible in long sessions. This regression has been fixed.
Bash “argument list too long”. In repositories with a large number of git worktrees, Bash commands were failing with an “argument list too long” error. The bug has been resolved.
Performance Improvements
Binary size has been reduced by approximately ~7 MB, and startup memory by roughly ~7 MB. Both improvements were achieved through lazy loading — a large dependency that was previously loaded at startup is now loaded only when actually needed. The result is faster startup and a smaller memory footprint immediately after launch.
Live-preview updates during streaming responses are more responsive, and the context-usage indicator no longer consumes CPU resources unnecessarily between turns.
Other Changes in v2.1.203
The release also includes several smaller but useful changes:
- A gray pause badge in the footer has been added during manual permission mode — the user always has a visual indication that the tool is in a waiting state.
- The session working directory is now included in MCP
roots/listwith change notifications, improving integration with MCP servers that depend on working context. - On Windows, background agents now correctly inherit PATH from the dispatching shell, resolving issues with tools that were not available in agent sessions.
- The left arrow key no longer closes the background task view; Esc is now required to close it.
Background: Agent Stability as a Priority
The changes in v2.1.203 reflect a pattern visible across several consecutive Claude Code releases — Anthropic is systematically addressing stability issues that arise when working with multiple agents, background sessions, and long-running tasks. The background and sub-agent architecture is becoming increasingly central to how developers use Claude Code, making bugs in that infrastructure a high-priority fix target.
The update is available through the standard Claude Code update mechanism.
Frequently Asked Questions
- What happened to background sessions when the daemon token expired in older versions?
- Background sessions became permanently unresponsive — they did not react to attach, responses, or the stop command. Version v2.1.203 automatically recovers such sessions.
- How much smaller is the Claude Code binary in this version?
- The binary is approximately 7 MB smaller, and startup memory is reduced by roughly 7 MB thanks to lazy loading of large dependencies.
- What caused the 15–20 second freeze when opening background sessions on macOS?
- A false detection of low memory caused the freeze. The bug is fixed in this version.