Networking issues on macOS
Issues the maintainers labelled both platform:macos and area:networking.
262 issues · 72 open · 190 resolved (73%) · first seen Jan 29, 2026
Is this getting better or worse?
This class of problem is holding steady. 95 new reports in the last 90 days vs 114 in the 90 before — -17%. The open backlog peaked at 72 in 2026-10 and sits at 72 today.
Derived by counting each matching issue from its creation date until it closed. First-party
computation over the anthropics/claude-code tracker — the trend is not published
anywhere upstream.
Which builds report this
205 of these reports name the Claude Code build they were running, spanning 121 releases. Heaviest reporters:
- Claude Code v2.1.251
- Claude Code v2.1.150
- Claude Code v2.1.233
- Claude Code v2.1.177
- Claude Code v2.1.204
- Claude Code v2.1.156
- Claude Code v2.1.201
- Claude Code v2.1.199
Report volume, not a defect count: an issue can mention a build without that build having caused the failure. Versions come from the version string in the bug-report template, matched against real published tags.
Do these get fixed?
Median time to close is 38 days across 190 closures. Of the 190 closures with a recorded reason, 18% were closed as completed and 156 as not-planned or duplicate. The most recent completed fix landed in 2026-10.
Workarounds reported by the community
71 of these issues post a workaround someone says worked. The highest-engagement ones:
- [BUG] Remote Control sessions die after ~20 min idle — server TTL ignores keepalives
- …ctivity), idle sessions would survive indefinitely. Current Workaround The only effective mitigation is triggering periodic real model activity (e.g., sending a trivial message via terminal input every ~15 minutes). This…
Found in the description of #32982 · still open - Remote control session fails to resync after connection drop
- If you need a workaround right now, this stale-session / silent-message-loss failure mode is exactly why I built pikiclaw. It runs Claude Code on your own machine but talks to it through Telegram, Feishu, or Weixin inste…
Found in the thread of #28571 · still open - [BUG] Cowork — "Additional allowed domains" allowlist non-functional
- …the sandbox proxy. Would appreciate any update on a fix or workaround short of enabling "All domains". --- Note: English is not my first language. This comment was written with the assistance of an AI(Claude.ai).
Found in the thread of #38984 · still open - Remote Control (/remote-control) disconnects frequently
- …— it can never recover because every API call returns 400. Workaround: Running Claude Code in tmux and using after drops.
Found in the thread of #33041 · still open - [BUG] Allow network egress - All domains' setting not reflected in session proxy JWT
- …o this is not a tool-layer issue and there is no in-sandbox workaround. For completeness, the form: The denial comes from an upstream gateway : Direct CONNECT against the local proxy: So the local proxy relays and the ga…
Found in the thread of #34690 · still open
Excerpts are quoted from the linked issue so you can judge relevance before opening it. Threads that only ask for a workaround, or report that there is none, are excluded. These are community suggestions, not official guidance from Anthropic — read the full thread before applying one.
Matching issues 1–100
Ranked by community engagement (reactions weighted over comments).
- [BUG] Remote Control sessions die after ~20 min idle — server TTL ignores keepalives
- Remote control session fails to resync after connection drop
- [BUG] Cowork — "Additional allowed domains" allowlist non-functional
- Remote Control (/remote-control) disconnects frequently
- [BUG] Allow network egress - All domains' setting not reflected in session proxy JWT
- [Bug] Anthropic API Error: Connection closed mid-response
- [BUG] you stupid agent used my real email as user agent string without asking anything
- Fix: Claude Code 403 "Request not allowed" on macOS with Proxy/VPN (China & Region-restricted Areas)
- [FEATURE] Remote Control: allow localhost proxies (loopback exception or opt-in for ANTHROPIC_BASE_URL=http://127.0.0.1:*)
- Claude Desktop 3p + custom gateway (`ANTHROPIC_BASE_URL`): sandbox network pinned to gateway + api.anthropic.com, `sandbox.network.allowedDomains` ignored even after full app restart
- [BUG] Intermittent ECONNRESET on both desktop app and standalone CLI, no VPN/proxy
- Claude Desktop update breaks LAN SSH/network access (OPERON_SANDBOXED_NETWORK=1)
- [BUG] remote-control WebSocket relay keeps reconnecting / commands hang indefinitely on macOS
- [Bug] Persistent API Response Timeout: Retry Loop Since June 22
- [BUG] ECONNRESET issues
- [BUG] Desktop Code tab ignores ANTHROPIC_BASE_URL from ~/.claude/settings.json (terminal CLI honors it)
- [BUG] Support HTTPS proxy (https:// scheme) for HTTPS_PROXY environment variable
- [BUG] Cowork (macOS): all outbound egress lost mid-session from BOTH the desktop workspace and the cloud container; file access unaffected
- [BUG] macOS: Local Network permission is lost on every auto-update (versioned claude.app bundle path); 20+ stale permission rows accumulate
- [BUG] ECONNRESET on corporate network - TLS fingerprinting blocks Bun while curl/Node.js work
- [BUG] SSL certificate has expired not working since 2.1.190+ on mac
- [BUG] Persistent mid-stream ECONNRESET on large-context sessions (v1/messages?beta=true)
- [BUG] Frequent UND_ERR_SOCKET connection failures during active sessions
- Remote Control permanently disconnects after rate limit with multiple concurrent sessions
- [BUG] Unable to connect to API (ConnectionRefused) on macOS — persists after full reinstall, safe-mode, and reboot (v2.1.204)
- [BUG] Claude Code hangs with Unable to connect to API (ECONNRESET) on every prompt — both CLI and in-app, persists across networks and clean reinstall
- ⎿ API Error: Unable to connect to API...
- Frequent ECONNRESET failures with Opus 4.6 (1M context)
- [BUG] Claude Code makes high-frequency version polling requests (~2-4/min) to GCS
- [Bug] Remote Control: stale environments cannot be deleted and ghost sessions cause permanent 404 errors
- [BUG] Frequent "API Error: Unable to connect to API (ECONNRESET)" in Claude Code
- [BUG] OAuth error: The socket connection was closed unexpectedly. For more information, pass `verbose: true` in the second argument to fetch()
- Dispatch/Cowork: ECONNRESET when connecting to API
- SSE heartbeat (≤30s) during model reasoning to prevent 'Connection closed mid-response' / stream-watchdog stalls on long (esp. Agent-tool) turns
- [Bug] Frequent tool execution errors with Claude 4.8 Opus model
- Sustained 502 Bad Gateway from mcp-proxy.anthropic.com (Gmail MCP)
- Remote Control: frequent "unknown network error" and session drops when using iOS app
- [BUG] Cowork macOS: local sandbox VM starts with NO network route (only loopback) and cloud egress proxy returns 403 for every domain, despite "Allow network egress: All domains" — regression since 2026-09-10 ~23:15 UTC
- [BUG] ECONNRESET on every API call — macOS 26 Tahoe, Darwin 25.4.0, ARM64
- [BUG] Persistent "API Error: Connection dropped (ECONNRESET)" messages
- [BUG] ECONNRESET on direct ISP path: Anthropic ingress resets TLS 1.3 handshakes carrying X25519MLKEM768; classical key share or VPN is 12/12 (re-open of #74767, still on 2.1.270)
- [Bug] Socket connection closed unexpectedly during API communication
- [BUG] ECONNRESET errors in session
- [BUG] ECONNRESET Errors with pro subscription on Ma
- [Bug] Anthropic API Error: Unable to connect to API (ConnectionRefused)
- [Bug] Claude in Chrome WebSocket bridge fails behind Zscaler/corporate TLS proxy (unable to get local issuer certificate)
- Remote machine SSH connection fails with "No route to host" due to TCC-disclaimed subprocess lacking Local Network permission
- [BUG] Non-streaming retry receives event-stream response (HTTP/2 stream mixup, Intel Mac)
- Frequent ECONNRESET on large-context Opus 5 (1M) sessions — RSTs originate from server edge, with SACK gaps on upload
- Recurring ECONNRESET during active sessions, exhausting all 10 retry attempts
- [Bug] Anthropic API Error: Unable to connect to API (ECONNRESET)
- [BUG] Cowork: all tasks fail with retry loop then ECONNRESET — fails across networks incl. phone hotspot, survived clean reinstall, worked hours earlier same day (macOS 15.7.3, M3)
- [Bug] Frequent ECONNRESET errors with failed retry logic in autonomous sessions
- [BUG]
- [BUG] Repeated lost Claude connection Connection dropped (ECONNRESET) requires reboot
- [BUG] Remote Control bridge registration sent as plaintext HTTP through proxy instead of CONNECT-tunneling
- [Bug] GitHub API requests blocked by proxy egress policy with HTTP 502 in scheduled routines
- MCP sandbox egress: allow <us2.make.com>
- [BUG] macOS: long sessions die with ECONNRESET — macOS TCP send-buffer default (autosndbufmax=4MB) bursts the growing context upload; one sysctl fixes it
- [BUG] Unable to connect to API (ECONNRESET)
- [BUG] Claude Code CLI/Bash tool cannot access LAN devices on macOS — missing Info.plist/NSLocalNetworkUsageDescription, recurring across 5+ closed/locked issues, never fixed
- [BUG] Persistent intermittent ECONNRESET ("socket closed unexpectedly") on Claude Code — macOS, multi-day, recurring across sessions
- iOS Remote Control: mobile UI stuck on pulsing thinking-icon after `/compact`; stale tool indicators remain; no recovery via app reload
- [Bug] Socket Connection Closed Unexpectedly During API Request
- [BUG] Turns hang ~6 minutes then "Connection dropped (ECONNRESET)", sudden onset 2026-09-28, across all sessions on one Mac
- [BUG] Opus 4.8 (1M) stream hangs after first chunk since 2.1.154; 2.1.153 is last known good
- [BUG] Claude Code doesn't work with `NODE_OPTIONS=--use-system-ca`
- [BUG] Hosted MCP OAuth initiation ignores NODE_EXTRA_CA_CERTS on corporate MITM networks (v2.1.113+)
- [BUG] Remote control disconnects after c.2 hours despite continous interactions
- [BUG] Claude code stopped working
- Voice mode: WebSocket blocked by Cloudflare bot challenge (403 cf-mitigated)
- Background daemon sessions fail permanently on transient socket errors — no retry/reconnect
- Babysit agents stop with 'socket connection closed unexpectedly' API error
- [BUG] Desktop: Remote SSH session hangs after `Passing plugin(s) to SDK`, no server.spawn RPC ever issued
- [Bug] Tokens consumed without generating output or response
- Cowork Desktop: local "Additional allowed domains" / "All domains" egress stopped being enforced after 2026-09-11 update (VM 2.1.260 worked, 2.1.266 blocks)
- [Urgent] Widespread ECONNRESET mid-stream — long streamed responses die, short ones survive
- Remote Control: app messages sync into the session input but never submit (fleet-wide silent message loss); RC never recovers after compaction
- [BUG] Claude Code loads fixed subset (10) of system CA certificates regardless of CLAUDE_CODE_CERT_STORE value — primary /v1/messages requests fail with UNABLE_TO_GET_ISSUER_CERT
- [Bug] Anthropic API Error: ECONNRESET connection reset during message requests with excessive retry loops
- [BUG] Server is Busy & "API Error: Unable to connect to API (ECONNRESET)" errors for 48+ hours in cowork
- Bug: `tengu_disable_keepalive_on_econnreset` heuristic never triggers on Bun's native fetch errors
- Claude Code API not connecting
- [Bug] API Connection Error: ECONNRESET across all models and sessions
- Não entendo porque pago o plano maior, pra ficar dando erro...
- [BUG] Cowork/Code tab: exit code 126 on VM spawn — missing com.apple.vm.networking entitlement (M5 Max, macOS)
- [BUG] coworkd_upstream_failed connection_refused - persistent across 2 days on Mac
- [BUG] Asking for random login during session
- Native build: ECONNRESET on OAuth refresh/login and API calls on macOS 27 — curl and npm build work fine
- [BUG] ECONNRESET on all local sessions (CLI + desktop) while curl and undici reach the same hosts successfully — macOS arm64, v2.1.251
- [Bug] API Error: Empty or Malformed Response with HTTP 200 Status
- [BUG] Response latency of up to 15 minutes, reproducible in both Desktop app and CLI, fixed only by fully quitting/restarting
- [BUG] ECONNRESET recurs on Claude Code CLI while curl succeeds simultaneously (v2.1.209, arm64 macOS)
- [Bug] Stream stalls immediately on first API request with "Waiting for API response" retry loop
- [BUG] ECONNRESET on home Wi-Fi — curl succeeds at exact same moment Claude Code fails
- [BUG] --resume fails with ECONNRESET when transcript contains large base64 screenshots; fresh sessions fine; stripping images fixes it (v2.1.201, macOS)
- 1M-context session becomes unrecoverable: ECONNRESET on large uncached requests, and /compact fails with the same error
- Intermittent ECONNRESET / Connection error on /v1/messages — auth OK, transport-level reset, 3 macOS machines
- Proxy not effective during startup: policy limits fetch runs before configureGlobalAgents
- [BUG] Intermittent "Subprocess initialization did not complete within 60000ms" on macOS — interactive sessions (VS Code extension / desktop app / interactive CLI) hang, `claude -p` works; correlates with TLS-inspection (Norton)