EADDRINUSE: address already in use

A port Claude Code wanted to bind is already held by another process.

30 issues · 5 open · 25 resolved (83%) · first seen Aug 22, 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 holding steady. 7 new reports in the last 90 days vs 6 in the 90 before — +17%. The open backlog peaked at 6 in 2026-02 and sits at 5 today.

0 2 3 5 6 2025-082025-122026-042026-08
2025-08 — First reports2026-02 — Peak backlog (6 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

20 of these reports name the Claude Code build they were running, spanning 16 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 12 days across 25 closures. Of the 25 closures with a recorded reason, 20% were closed as completed and 20 as not-planned or duplicate. The most recent completed fix landed in 2026-08.

Workarounds reported by the community

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

Chrome Extension: EADDRINUSE - Native Host and MCP Server both try to create pipe listener
…s Involved Native Messaging Host Config: Native Host Batch: Workaround None found yet. --- Reported via Claude Code
Found in the description of #21791 · resolved
[BUG] Windows: Chrome extension native host crashes with EADDRINUSE pipe conflict
…r), run: 7. Native host crashes immediately with EADDRINUSE Workaround: Use Claude Code version 2.1.19, which works correctly. Claude Model None Is this a regression? Yes, this worked in a previous version Last Working V…
Found in the description of #21512 · resolved
Bug: Claude Preview MCP panel opens in wrong session (multi-session Desktop)
…Primary working directory: - with 7-13 named server entries Workaround I'm Currently Using My Claude sessions now avoid entirely and instead start dev servers via Bash, then use with to point at . This is clunky but avoi…
Found in the description of #62290 · resolved
[BUG] Chrome MCP fails with EADDRINUSE: native host tries to create new pipe server instead of connecting to existing one
…g., ) 5. Observe "Browser extension is not connected" error Workarounds Attempted (None Worked) - Restarting Chrome - Restarting Claude Code - Killing old node processes - Reloading the Chrome extension - Clicking the ex…
Found in the description of #22651 · resolved
[BUG] Daemon supervisor (transient) hard-exits on EADDRINUSE during control-socket bind race — regression in 2.1.195
…, so it's not mode-specific. Note: the roster.json-clearing workaround discussed over in 68146 does not fix this, and in our case triggered a separate, more destructive bug — see my comment there for details.
Found in the thread of #72334 · 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–30

Ranked by community engagement (reactions weighted over comments).

Related aggregations

  1. ECONNRESET: socket hang up

    229 issues
  2. ECONNREFUSED: connection refused

    207 issues
  3. Self-signed certificate in certificate chain

    41 issues
  4. ETIMEDOUT: request timed out

    28 issues
  5. getaddrinfo ENOTFOUND (DNS lookup failed)

    49 issues
  6. API Error 400 (invalid_request_error)

    2,591 issues