claude-code - 💡(How to fix) Fix Cowork 'Failed to create bridge sockets' on macOS 26.2 Tahoe — regression after #19503 fix [2 comments, 3 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#49447Fetched 2026-04-17 08:40:56
View on GitHub
Comments
2
Participants
3
Timeline
9
Reactions
0
Timeline (top)
labeled ×4commented ×2closed ×1mentioned ×1

Error Message

Error: Failed to create bridge sockets after 5 attempts

Root Cause

Suspected Root Cause

Code Example

Error: Failed to create bridge sockets after 5 attempts

---

[Spawn:create] id=073f0d50 name=bold-epic-goodall cmd=/usr/local/bin/claude args=--output-format stream-json ...
[Process:073f0d50] Created, name=bold-epic-goodall, total active=1
[Spawn:vm] id=073f0d50 OAuth token approved with MITM proxy
[Process:073f0d50] Spawn confirmed, flushing 2 buffered stdin chunks
[Spawn:vm] id=073f0d50 Spawn succeeded in 40ms
[vm-stderr 073f0d50] Error: Failed to create bridge sockets after 5 attempts
[Process:073f0d50] Exited, code=1, signal=null, duration=760ms, oom=false
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

Claude Desktop Cowork fails on every task (new and resumed) with:

Error: Failed to create bridge sockets after 5 attempts

Exit code 1, process dies within ~750-900ms of spawning every time.

This was previously reported and fixed in #19503, but the fix does not work on macOS 26.2 (Tahoe). The issue reproduces on both claude-opus-4-7 and claude-haiku-4-5-20251001 model selections. Every cowork agent spawned fails identically.

Environment

  • macOS: 26.2 (Build 25C56)
  • Kernel: Darwin 25.2.0 (xnu-12377.61.12~1/RELEASE_ARM64_T8142)
  • Architecture: arm64 (Apple Silicon)
  • Claude Desktop SDK: 2.1.111
  • Claude Code CLI: 2.1.92 (works perfectly — only cowork VM is affected)
  • Node.js: v22.22.2 (also tested with v24.13.1 — same result)

Debugging Performed (extensive — ~1 hour, significant token usage)

We performed thorough debugging via Claude Code CLI to diagnose this issue:

  1. Verified CLI works fine: claude --print "hello" succeeds, auth is valid (Max subscription, OAuth via claude.ai)
  2. Checked all cowork logs:
    • ~/Library/Logs/Claude/cowork_vm_node.log — every spawn fails with Failed to create bridge sockets after 5 attempts
    • ~/Library/Logs/Claude/cowork_vm_swift.log — VM boots and connects successfully
    • ~/Library/Logs/Claude/coworkd.log — VM infrastructure (systemd, networking, user recovery) all healthy
  3. VM boots fine: Network connects (CONNECTED), API is REACHABLE, SDK installs successfully, OAuth tokens approved — the failure happens after the Claude Code process spawns inside the VM
  4. Deleted session disk (sessiondata.img) — recreated on boot, same error
  5. Deleted all VM state files (efivars.fd, machineIdentifier, vmIP, gvisorMacAddress, sessiondata.img) — same error
  6. Full cache/state purge — deleted all of:
    • ~/Library/Application Support/Claude/vm_bundles/
    • ~/Library/Application Support/Claude/ (all caches, blobs, IndexedDB, sessions, etc.)
    • ~/Library/Caches/Claude/
    • ~/Library/Logs/Claude/
    • ~/Library/Saved Application State/com.anthropic.claudedesktop.savedState/
    • ~/Library/WebKit/com.anthropic.claudedesktop/
  7. Complete uninstall and fresh reinstall of Claude Desktop — same error
  8. Switched Node.js versions (v24 → v22 LTS) — same error
  9. Also saw secondary error on retry: RPC error: ensure user: user gallant-sleepy-lovelace already exists unexpectedly: uid=1023 gid=1023 — stale VM users persisting across session disk resets

Log Evidence

From cowork_vm_node.log — consistent pattern across every attempt:

[Spawn:create] id=073f0d50 name=bold-epic-goodall cmd=/usr/local/bin/claude args=--output-format stream-json ...
[Process:073f0d50] Created, name=bold-epic-goodall, total active=1
[Spawn:vm] id=073f0d50 OAuth token approved with MITM proxy
[Process:073f0d50] Spawn confirmed, flushing 2 buffered stdin chunks
[Spawn:vm] id=073f0d50 Spawn succeeded in 40ms
[vm-stderr 073f0d50] Error: Failed to create bridge sockets after 5 attempts
[Process:073f0d50] Exited, code=1, signal=null, duration=760ms, oom=false

This pattern repeats for every single cowork process spawned — both Opus and Haiku models, new tasks only (no resumes).

Suspected Root Cause

macOS 26 (Tahoe) includes changes to Apple's Virtualization.framework. The VM boots and connects fine, but the bridge socket creation (socat bridges from Unix sockets to TCP proxy ports) fails inside the guest VM. This suggests either:

  1. A Virtualization.framework behavioral change in macOS 26 affecting Unix socket creation within guest VMs
  2. A TMPDIR or filesystem permission change in the guest under the new hypervisor
  3. The gvisor user-mode networking layer not being compatible with macOS 26's network stack

Token & Time Cost

Significant debugging effort was spent on this issue — approximately 1 hour of Claude Code CLI time using Opus model with extensive log analysis, multiple file operations, and systematic troubleshooting. We'd appreciate token credits for the time spent diagnosing what turned out to be a platform bug.

What Should Happen?

Starting a new Cowork task should launch successfully, as it does on macOS 15.x (Sequoia).

Steps to Reproduce

  1. Use macOS 26.2 (Tahoe) on Apple Silicon
  2. Install Claude Desktop (latest)
  3. Open Cowork
  4. Start any new task
  5. Error appears immediately — process exits within ~750ms

Claude Model

claude-opus-4-7 and claude-haiku-4-5-20251001 (both fail)

Is this a regression?

Yes — #19503 was reported fixed in late February 2026, but the fix does not cover macOS 26 (Tahoe)

Last Working Version

Unknown — Cowork has never worked on this macOS 26.2 machine

Claude Code Version

Claude Desktop SDK: 2.1.111 / Claude Code CLI: 2.1.92

Platform

Anthropic API (Max subscription, OAuth)

Operating System

macOS 26.2 Tahoe (Darwin 25.2.0)

Terminal/Shell

zsh

Additional Information

Related issues: #19503, #23746, #11079

cc @MarshallOfSound (closed #19503 as fixed — this is a resurgence on macOS 26)

extent analysis

TL;DR

The issue is likely due to a compatibility problem between macOS 26.2 (Tahoe) and the Virtualization.framework used by Claude Desktop, causing the failure to create bridge sockets in the guest VM.

Guidance

  1. Verify the Virtualization.framework version: Check if there are any updates or patches available for the Virtualization.framework on macOS 26.2 (Tahoe) that might resolve the compatibility issue.
  2. Investigate gvisor user-mode networking layer: Look into potential updates or configuration changes for the gvisor user-mode networking layer to ensure it is compatible with macOS 26's network stack.
  3. Check Unix socket creation permissions: Examine the permissions and settings for Unix socket creation within the guest VM to identify any potential issues related to TMPDIR or filesystem permissions.
  4. Test with different Node.js versions: Although testing with different Node.js versions (v22 and v24) did not yield different results, it might be worth exploring other versions or configurations to rule out any Node.js-specific issues.

Example

No specific code snippet can be provided without more information on the implementation details of the Virtualization.framework and gvisor user-mode networking layer. However, any solution would likely involve updating or configuring these components to ensure compatibility with macOS 26.2 (Tahoe).

Notes

The issue seems to be specific to macOS 26.2 (Tahoe) and does not occur on earlier versions of macOS, suggesting a regression or compatibility problem introduced in the newer version of the operating system.

Recommendation

Apply a workaround by potentially downgrading to an earlier version of macOS where the issue is not present, or wait for an update to the Virtualization.framework or gvisor user-mode networking layer that addresses the compatibility issue. However, without a clear path to resolve the compatibility problem, the best immediate action might be to apply a workaround, such as using a different operating system version for Claude Desktop until a fix is available.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING