ECONNREFUSED: connection refused
Nothing was listening at the address Claude Code dialled.
207 issues · 9 open · 198 resolved (96%) · first seen Mar 25, 2025
First response · network
What to do now
Most likely: A DNS, proxy, TLS or socket layer interrupted the connection.
- Check whether the same request works without the current VPN or corporate proxy.
- Verify DNS and certificate trust without disabling TLS verification.
- 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 converging. 15 new reports in the last 90 days vs 141 in the 90 before — -89%. The open backlog peaked at 43 in 2026-04 and sits at 9 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
181 of these reports name the Claude Code build they were running, spanning 78 releases. Heaviest reporters:
- Claude Code v2.1.114
- Claude Code v2.1.123
- Claude Code v2.1.119
- Claude Code v2.1.92
- Claude Code v2.1.104
- Claude Code v2.1.81
- Claude Code v2.1.29
- Claude Code v2.1.126
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 7 days across 198 closures. Of the 198 closures with a recorded reason, 10% were closed as completed and 179 as not-planned or duplicate. The most recent completed fix landed in 2026-05.
Workarounds reported by the community
15 of these issues post a workaround someone says worked. The highest-engagement ones:
- [Bug] 1M context incorrectly requires extra usage on Max plan
- …or charges. Actual Behavior Error is thrown blocking usage. Workaround of running is required, which also incorrectly labels the feature as "Billed as extra usage." Environment - Plan: Max - Model: claude-opus-4-6[1m] -…
Found in the description of #45390 · still open - OAuth token expired immediately after fresh login - cannot use Claude Code (blocking)
- …to succeed, first prompt still returns 401 "token expired" Workaround attempted (unsuccessful): Exit Claude Code rm -rf ~/.claude (clear all credentials) Run claude Run /login Same failure occurs Claude Model Opus Is th…
Found in the description of #19078 · resolved - [Bug] Weekly usage reset time displayed incorrectly for Pro plan users
- …gent: While our Support team is unable to manually reset or work around usage limits, you can learn about best practices here ( If you’ve hit a message limit, you’ll need to wait until the reset time, or you can consider…
Found in the thread of #51222 · resolved - [BUG] http hooks with json don't work.
- …?" — with HTTP hooks failing to reach their endpoint. Their workaround was the same as yours: fall back to command hooks. HookLab works — but it runs on localhost. The HookLab project (a Phoenix LiveView dashboard) recei…
Found in the description of #30613 · resolved - [Bug] Image Recognition Misidentification: Receipt OCR Confuses Product Types (Coke vs Milk)
- Bug Description What I think I'm doing: Processing receipt images, extracting SKUs, matching to Notion shopping list, storing prices in SQLite for historical tracking, updating Not
Found in the description of #19388 · 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).
- [Bug] 1M context incorrectly requires extra usage on Max plan
- OAuth token expired immediately after fresh login - cannot use Claude Code (blocking)
- i use mac,and in support country; but input "claude" reprot Unable to connect to Anthropic services;
- [Bug] Weekly usage reset time displayed incorrectly for Pro plan users
- [BUG] Connection-level errors (ECONNRESET, EPIPE, ETIMEDOUT) are never retried — immediate failure with zero recovery
- [Bug] Anthropic API Error: Usage Policy violation on non-policy-violating prompts
- [Bug] Anthropic API Error: Internal Server Error (500)
- [BUG] Claude code can no longer be installed or updated using native installer on IPV6-only networks
- [Bug] Intermittent API 500 error with version fetch/network failures and file read errors in Claude Code 2.1.104 on macOS
- [Bug] Claude Opus 4.6 reasoning regression: speculation loops instead of systematic debugging
- ⎿ API Error: Unable to connect to API...
- [BUG] http hooks with json don't work.
- [Bug] Excessive token consumption on single document read
- Bug Report
- [Bug] ultrareview timeout shouldn't consume quota credits
- [Bug] Rate limit error at 72% token usage
- HTTP hook intermittently fails with ECONNREFUSED despite healthy server
- [Bug] High CPU usage during idle state
- [BUG] API Error 404 / ECONNREFUSED
- [BUG]
- [Bug] `--print` flag returns empty output in version 2.1.83
- [BUG] Issue in API Error Output & Proxy Handling
- [Bug] Elevated error rate in API responses
- [Bug] Token limits depleting rapidly across sessions
- [Feature Request] Preserve conversation history logs across auto-compact operations
- [Feature Request] Increase default context window size for subscription tier
- You've hit your limit · resets 8pm (Europe/Bucharest)
- Request: Add telemetry debugging capabilities for Docker container environments
- [Feature Request] Improve background task management and visibility in CLI
- You've hit your limit · resets 2:30am (Asia/Calcutta)
- [Bug] Custom statusLine command not invoked during task execution; activity indicator overwrites statusline
- You've hit your limit · resets 11:30pm (Asia/Calcutta)
- [Bug] Anthropic API Error: 500 Internal Server Error
- [Bug] Claude Code corrupts source files with sed command, causing token waste on recovery
- [Bug] Tokens consumed without generating output or response
- [Feature Request] OAuth account switching doesn't work; add account switcher UI
- [Bug] Image Recognition Misidentification: Receipt OCR Confuses Product Types (Coke vs Milk)
- [Bug] Anthropic API Error: 500 Internal Server Error during multiple planning iterations followed by error in compaction
- [Bug] Anthropic API Error: Internal server error (500)
- [Feature Request] Add Option to Save Incremental Plan Progress
- [Bug] Anthropic API Error: Content Filtering Blocks adding LICENSE
- OAuth re-auth for `claude agents` fails with ECONNREFUSED on `org:create_api_key` scope
- [Bug] Team leader approval gate missing permission_response in SendMessage union types
- [Bug] Auto-Compact causes response thrashing after multiple iterations
- Não entendo porque pago o plano maior, pra ficar dando erro...
- PermissionRequest HTTP hook fails closed when endpoint is unreachable, contradicting documented non-blocking behavior
- [Bug] Input box text truncation on display
- [Bug] Claude Code ignores explicit CLAUDE.md instructions with helpfulness judgment calls
- Unable to connect to API (ECONNREFUSED)
- [Bug] Resume menu crashes with JavaScript OOM when switching to all projects
- [BUG] /login does not auto-open browser in PowerShell/cmd on Windows 11 (works in VS Code integrated terminal)
- [Bug] Excessive token consumption from conversation history management
- [Bug] Excessive token consumption with Claude 3 Opus model
- [Bug] Excessive token consumption causing rate limiting on conversation resume
- [Bug] Model generates identical answer options across multiple test questions
- [Bug] "Remove this worktree" button silently fails after commits; exit prompt sometimes missing
- [Bug] Buffered message overwrites stashed message on send
- [BUG] Cant update claude code when running within devcontainer
- [Feature Request] Persistent todo list management across projects with project-specific configuration
- [Bug] Poor instruction following in Claude Code responses
- GitHub PR Comments Not Retrieved
- Model fabricates non-existent "prompt injection attacks" and hallucinated tool outputs across multiple sessions (Claude Code, Opus)
- [BUG] VS Code Extension Not Connecting to Claude
- [BUG] sandbox.network.allowedDomains cannot allow localhost — NO_PROXY bypass prevents proxy routing to local services
- [Feature Request] Add configurable worktree base path with template support
- [Bug] Anthropic API Error: 400 Could not process image
- [Bug] Terminal display corruption after Shopify CLI usage with non-ASCII character rendering
- [BUG] OAuth /login fails with ECONNREFUSED on Windows 11, fresh install, network confirmed OK
- [Bug] Anthropic API Error: Internal server error (500)
- [Bug Report] Unable to process request - no details provided
- [Bug] Anthropic API Error: Request failed after $25 token consumption in /ultrareview
- [Bug] Response output renders multiple times
- [Bug] Anthropic API Error: Prompt too long in /goal stop hook
- [Bug] Korean particle "의" token degeneration loop in long-context output
- [Feature Request] Support Shift+Enter for line breaks in prompt input
- [Bug] /goal command loops indefinitely despite user approval override
- [Bug] Output display breaks on monitor changes, window resize, and scrolling with repeated messages
- [Bug] Unexpected API usage spike without active requests
- [BUG]
- [Bug] /mcp dialog not scrollable with many configured MCP servers
- [Bug] Anthropic API Error: 429 Rate Limit Exceeded Below Organization Input Token Quota
- [Bug] Claude Code connection drops unexpectedly during long sessions
- [Bug] Daily rolling limit not resetting at expected time window
- [Bug] Anthropic API Error: Dedup stage crash on /ultrareview with no findings and misleading billing
- [Bug] Analytics dashboard stuck on "Data processing" for 5+ days despite active GitHub app usage
- [Bug] Usage percentage suddenly jumped to 18%
- [Bug] Anthropic API Error: Socket connection closed unexpectedly
- [Bug] IDE panels not rendering intermittently after startup
- ⎿ API Error: Unable to connect to API...
- [Bug] Tool execution injected control characters (SOH \x01) into HTML, agent failed to diagnose
- [Feature Request] Enforce claude.md specification compliance or provide clearer guidance on deviations
- Difficulty accessing extra usage
- [Bug] Extra usage credits not accessible despite available balance
- [Bug] Model fails to adapt strategy after receiving full diagnostic context
- [Feature Request] Provide claude-3-5-opus model option or revert to previous version
- [Bug] Compact/resume replays stale slash-command ARGUMENTS as current turn
- [Bug] Agent executes API mutations without consulting documentation, causing production data corruption
- [Bug] Auto mode disabled after EnterWorktree and cannot be re-enabled
- [Bug] Anthropic API Error: Extra usage required for Sonnet 4.6 1M context on Max x20 plan
- [Bug] Custom skills not resolved to worktree directory after EnterWorktree