🟢 🤝 Agents Published: · 3 min read ·

Claude Code v2.1.203 — Session Expiry Warning, Smaller Binary, Faster Startup

Editorial illustration: Claude Code v2.1.203 with login expiry fix and session recovery

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/list with 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.