›_ Claude Code Issues
Claude Code Issues / Error strings / ECONNRESET: socket hang up

ECONNRESET: socket hang up

The peer tore the TCP connection down mid-request.

229 issues · 70 open · 159 resolved (69%) · first seen May 14, 2025

First response · network

What to do now

Most likely: A DNS, proxy, TLS or socket layer interrupted the connection.

  1. Check whether the same request works without the current VPN or corporate proxy.
  2. Verify DNS and certificate trust without disabling TLS verification.
  3. Capture the hostname and exact socket code before escalating.

These are conservative triage steps, not an official Anthropic fix. Use the issue and workaround evidence below before making a destructive configuration change.

Is this getting better or worse?

This class of problem is still growing. 102 new reports in the last 90 days vs 78 in the 90 before — +31%. The open backlog peaked at 70 in 2026-08 and sits at 70 today.

0 18 35 53 70 2025-052025-102026-032026-08
2025-05 — First reports2026-08 — Peak backlog (70 open)

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

157 of these reports name the Claude Code build they were running, spanning 94 releases. Heaviest reporters:

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 29 days across 159 closures. Of the 159 closures with a recorded reason, 21% were closed as completed and 126 as not-planned or duplicate. The most recent completed fix landed in 2026-08.

Workarounds reported by the community

50 of these issues post a workaround someone says worked. The highest-engagement ones:

Persistent ECONNRESET Errors on macOS Network Connections
…n Bun. That's the same reason it "just works" through Warp. Workaround (Linux/macOS) Add to or : For a more reliable OS-level fix, build an LD PRELOAD shim that forces on every TCP socket: Also lower the TCP keepalive pr…
Found in the thread of #5674 · still open
[BUG] Bedrock Bearer Token (ABSK) authentication broken in v2.1.94
…inary with identical environment variables works correctly. Workaround Pin to v2.1.92: shell AWS BEARER TOKEN BEDROCK CLAUDE CODE USE BEDROCK=1 AWS REGION claude /home/.../.local/share/claude/versions/2.1.92 -p "hello"`…
Found in the description of #44929 · resolved
[Bug] Anthropic API Error: ECONNRESET with exhausted retries in Claude desktop app
…ries in the same file quote their paths and are unaffected. Workaround: quote the path in the hook command, or use forward slashes. Windows hook paths arguably should be quoted by the client.</p <h2 dir="ltr" class="mt-3…
Found in the description of #83994 · still open
[BUG] Intermittent ECONNRESET on both desktop app and standalone CLI, no VPN/proxy
…ards kept working, so Private Relay was the sole cause. Two workarounds — either one is enough 1. Global: System Settings → Apple ID → iCloud → iCloud+ Features → Private Relay → off. 2. Per network (preferred): leave Pr…
Found in the thread of #87424 · still open
[BUG] ECONNRESET issues
…fall-back to HTTP/1.1 viable? 3. A (or equivalent) env-var workaround so users on networks where Bun-h2 misbehaves can keep working while a fix lands. 4. A flag that turns on Bun fetch's (the error message itself recomm…
Found in the thread of #28557 · resolved

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).

Related aggregations

  1. ECONNREFUSED: connection refused

    207 issues

  2. Self-signed certificate in certificate chain

    41 issues

  3. ETIMEDOUT: request timed out

    28 issues

  4. getaddrinfo ENOTFOUND (DNS lookup failed)

    49 issues

  5. EADDRINUSE: address already in use

    30 issues

  6. API Error 400 (invalid_request_error)

    2,591 issues