Skip to content
Tools · Oct 26, 2026

Claude Code v2.1.311 fixes long-standing freezes, remote session issues, and agent workflow bugs

Anthropic’s CLI coding assistant release adds session stability fixes, improved agent tooling, and remote session reliability improvements.

Trust80
HypeLow hype

1 source · cross-referenced

ShareXLinkedInEmail
TL;DR
  • Adds flags to keep idle sessions alive during host process cleanup: --hold-idle-file and --max-hold-min for self-hosted runners
  • Fixes multi-second freezes at startup and after file edits when large CLAUDE.md lists are present
  • Improves remote and cloud session reliability, including faster failure detection for stalled requests
  • Corrects agent tool visibility and lifecycle issues, including subagent MCP tool access and background session restarts
  • Addresses transcript ordering, file picker negation rules, and plugin installation reporting

Anthropic released Claude Code v2.1.311, a maintenance update that adds two new flags for self-hosted runners: --hold-idle-file and --max-hold-min. These flags allow idle sessions to remain active while the host process reports leftover running processes, improving continuity during cleanup phases.

The update fixes long freezes at startup and after reading or editing files when a CLAUDE.md file contains very long list items, a frequent cause of editor lag in large projects. It also resolves interrupt handling delays that could occur when a Model Context Protocol (MCP) server had not yet answered a resource read or a skill was still downloading.

Remote and cloud session reliability is improved. The release addresses issues where sessions would remain in a "Connecting" state for about two minutes when a network proxy blocked startup requests, and ensures stalled responses in Cowork cloud sessions now fail after 300 seconds instead of hanging indefinitely.

Agent workflows receive multiple fixes. Subagents can now use MCP tools from servers that finish connecting after the subagent starts, and background sessions that crash between turns are restarted while attached, pinned, or scheduled. Agent teams no longer show empty task lists when resumed, and background agents in auto mode no longer trigger new main conversation turns on every wake.

Additional fixes include corrected transcript message ordering in claude -p and SDK sessions, proper handling of .ignore and .rgignore negation rules in the @ file picker, and accurate reporting of plugin installation status in the /ide command. The release also improves handling of large diffs and prevents premature truncation of long thinking traces on cloud endpoints.

Sources
  1. 01GitHub · anthropics/claude-code releases — v2.1.311
Also on Tools

Stories may contain errors. Dispatch is assembled with AI assistance and curated by human editors; despite the trust-score filter, mistakes happen. We correct publicly — every article links to its revision history. Nothing here is financial, legal, or medical advice. Verify before relying on any claim.

© 2026 Dispatch. No ads. No sponsorships. No paid placement. Reader-supported via Ko-fi.

Built by a person who cares about honest AI news.